worktree

Create isolated Git worktrees with descriptive branches and Docker service setup.

7.1k|700|Updated Feb 21, 2024
One-click install
npx skills add https://github.com/Zipstack/unstract --skill worktree-zipstack
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: worktree
Source: https://github.com/Zipstack/unstract/tree/main/.claude/skills/worktree
Command: npx skills add https://github.com/Zipstack/unstract --skill worktree-zipstack

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines parallel development by creating isolated Git worktrees, allowing you to work on multiple features or fixes simultaneously without interfering with your main codebase.

Core Features & Use Cases

  • Branch Creation: Automatically generates descriptive branch names based on your request (e.g., fix/login-validation, feat/workflow-export-api).
  • Isolated Environments: Sets up a new directory with a clean Git worktree linked to the main branch, perfect for focused development.
  • Service Configuration: For the Unstract repository, it intelligently identifies and prepares necessary Docker services (frontend, backend, etc.) for the new worktree.
  • Use Case: When you need to quickly address a bug without disrupting your current feature development, create a dedicated worktree for the fix.

Quick Start

Create a new git worktree for fixing the user authentication bug.

Frequently Asked Questions about worktree

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create an isolated git worktree for parallel feature development?

This Skill creates an isolated git worktree by fetching the latest main branch, generating a descriptive branch name based on your request, and setting up a new directory for parallel development without interfering with your main codebase.

What is the best way to work on a bug fix without disrupting my current feature branch?

Using a git worktree is the best way to work on a bug fix without disrupting current development, as it creates a separate working directory linked to the main branch for focused task execution.

Can I automatically configure Docker services when setting up a new git worktree?

Yes, when setting up a new git worktree for the Unstract repository, it intelligently detects user-defined keywords and prepares necessary Docker services like frontend and backend for the new environment.

Does setting up parallel development environments require manual branch naming?

No, setting up parallel development environments does not require manual branch naming, as it automatically generates descriptive branch names based on your specific request, such as fix/login-validation or feat/workflow-export-api.

What limitations exist when using git worktrees for parallel task execution?

A limitation is that Docker service detection and preparation specifically targets the Unstract project, meaning generic Docker service configuration for other repositories is not supported by this worktree setup.