worktree-spawn

Spawn a Claude instance in a separate git worktree for parallel task execution.

449|615|Updated Feb 20, 2023
One-click install
npx skills add https://github.com/AztecProtocol/aztec-packages --skill worktree-spawn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: worktree-spawn
Source: https://github.com/AztecProtocol/aztec-packages/tree/main/yarn-project/.claude/skills/worktree-spawn
Command: npx skills add https://github.com/AztecProtocol/aztec-packages --skill worktree-spawn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables you to run a Claude instance in a separate git worktree so you can tackle a task in parallel without interrupting the current conversation.

Core Features & Use Cases

  • Isolated Claude session in a separate worktree
  • Parallel task handling: delegate a task and monitor progress while continuing other work
  • Automatic worktree setup with a new branch name derived from author initials and task description

Quick Start

  1. Determine branch name using git config user.initials or git config user.name.
  2. Choose a worktree directory name, for example ../aztec-feature-name.
  3. Create the worktree with a new branch: git worktree add -b <author>/<branch-name> ../<worktree-dir-name>.
  4. Spawn Claude in the worktree with a detailed task prompt: claude "<Task prompt here>"

Frequently Asked Questions about worktree-spawn

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

FAQPage Schema
How do I run a parallel task in a git worktree with an independent Claude session?

To run a parallel task in a git worktree, you can spawn an independent Claude instance in a separate worktree. This delegates the task to run isolated without interrupting your current conversation, allowing you to continue other work.

How does git worktree branch naming work when delegating parallel tasks?

Git worktree branch naming derives the branch name automatically from your git config user.initials or git config user.name. It combines the author identifier with your task description to create a consistent branch structure.

Can I monitor progress of a delegated task while continuing my current Claude session?

Yes, you can monitor progress of a delegated task while continuing your current Claude session. The spawned Claude runs independently in a separate git worktree, ensuring your ongoing conversation remains uninterrupted.

What are the steps to set up a git worktree for parallel task handling?

Setting up a git worktree involves deriving a branch name from git config, choosing a worktree directory, running git worktree add with the new branch, navigating to the yarn-project directory, and launching Claude with a detailed task prompt.

Does worktree-spawn require navigating to a specific project directory before launching Claude?

Yes, worktree-spawn requires navigating to the yarn-project directory within the newly created worktree before launching Claude. This ensures the independent Claude instance operates within the correct project context.