ai-worktree:spawn

Create an isolated git worktree for the active AI agent.

Updated May 31, 2025
One-click install
npx skills add https://github.com/dEitY719/dotfiles --skill ai-worktree-spawn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ai-worktree:spawn
Source: https://github.com/dEitY719/dotfiles/tree/main/claude/skills/ai-worktree-spawn
Command: npx skills add https://github.com/dEitY719/dotfiles --skill ai-worktree-spawn

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Create an isolated git worktree workspace for the current AI coding agent to prevent cross-agent interference in a multi-agent repository and enable parallel work.

Core Features & Use Cases

  • Detects the active AI agent via explicit flag, environment variables, or default to agent identification.
  • Computes a unique worktree path and branch name, including optional task slug handling and base reference resolution.
  • Supports git-crypt unlocks or safe bypass of encryption for new worktrees, with structured logging and a guided teardown.
  • Ideal for launching parallel tasks across multiple agents in the same repo, ensuring clean, isolated work environments.

Quick Start

Run the ai-worktree-spawn skill to create a new isolated worktree for the active AI agent in the current repository.

Frequently Asked Questions about ai-worktree:spawn

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

FAQPage Schema
How do I create isolated git worktrees for parallel AI tasks?

Isolated git worktrees allow multiple AI agents to work in parallel within the same repository without interfering with each other. This skill detects the active agent and spawns a dedicated worktree with a unique branch name to prevent cross-agent conflicts.

How do I set up a git worktree workspace without disrupting other agents?

Setting up a git worktree workspace without disruptions involves computing a unique path and branch name for the active agent. The process validates preconditions, resolves the base reference, and configures the environment for clean parallel execution.

Does git-crypt work with git worktree automation for AI agents?

Git-crypt works with git worktree automation by supporting unlocks or safe bypass for new worktrees. This enables encrypted repository access during parallel task execution while maintaining structured logging of the action.

What is the best way to manage multi-agent version control in a shared repository?

The best way to manage multi-agent version control is using isolated worktrees with unique branch names. This approach detects the active agent and computes a dedicated base reference, ensuring clean parallel work environments without interference.

How do I safely remove a git worktree after a parallel task finishes?

To safely remove a git worktree after a parallel task finishes, you follow a guided teardown plan provided by the automation. This ensures the isolated workspace and its associated branch are cleanly deleted without affecting the main repository.