Create a git worktree for parallel work and optionally launch implementation session
Creates git worktrees for parallel development with organized repository structure.
/plugin marketplace add coalesce-labs/catalyst/plugin install catalyst-dev@catalystinheritThis command uses ticket references like PROJ-123. Replace PROJ with your Linear team's ticket
prefix:
.claude/config.json if availableTICKET-XXXENG-123, FEAT-456, BUG-789You are tasked with creating a git worktree for parallel development work.
When this command is invoked:
Gather required information:
Confirm with user: Present the worktree details and get confirmation before creating.
Create the worktree: Use the create-worktree.sh script:
"${CLAUDE_PLUGIN_ROOT}/scripts/create-worktree.sh" <worktree_name> [base_branch]
The script automatically:
GITHUB_SOURCE_ROOT environment variable if setInitialize thoughts (REQUIRED - handled automatically by script):
The create-worktree.sh script automatically initializes thoughts and syncs with the shared repository, giving the worktree access to:
Optional: Launch implementation session: If a plan file path was provided, ask if the user wants to launch Claude in the worktree:
humanlayer launch --model opus -w <worktree_path> \
"/implement_plan <plan_path> and when done: create commit, create PR, update Linear ticket"
Recommended Setup: Set GITHUB_SOURCE_ROOT environment variable for clean organization:
# In ~/.zshrc or ~/.bashrc
export GITHUB_SOURCE_ROOT="$HOME/code-repos/github"
Convention:
${GITHUB_SOURCE_ROOT}/<org>/<repo>
~/code-repos/github/coalesce-labs/catalyst${GITHUB_SOURCE_ROOT}/<org>/<repo>-worktrees/<feature>
~/code-repos/github/coalesce-labs/catalyst-worktrees/PROJ-123Fallback behavior (if GITHUB_SOURCE_ROOT not set):
~/wt/<repo_name>/<worktree_name>Why this convention?
<repo> vs <repo>-worktreesExample with GITHUB_SOURCE_ROOT:
~/code-repos/github/
├── coalesce-labs/
│ ├── catalyst/ # Main branch
│ └── catalyst-worktrees/ # All worktrees
│ ├── PROJ-123-feature/
│ └── PROJ-456-bugfix/
└── acme/
├── api/ # Main branch
└── api-worktrees/ # All worktrees
└── ENG-789-oauth/
User: /catalyst-dev:create_worktree PROJ-123