git-worktrees

Create isolated git worktrees with safety checks and cleanup workflows.

6|Updated Dec 29, 2025
One-click install
npx skills add https://github.com/HomericIntelligence/ProjectHephaestus --skill git-worktrees-homericintelligence
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-worktrees
Source: https://github.com/HomericIntelligence/ProjectHephaestus/tree/main/skills/git-worktrees
Command: npx skills add https://github.com/HomericIntelligence/ProjectHephaestus --skill git-worktrees-homericintelligence

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Git worktrees enable safe, isolated development by creating parallel workspaces that share the same repository, allowing you to work on new branches without disrupting your main directory.

Core Features & Use Cases

  • Isolated development environments: Create project-local .worktrees or shareable /tmp workspaces for feature work.
  • Safety-first workflow: Verify ignored status and keep worktrees out of version control to prevent accidental commits.
  • Flexible creation strategies: Prefer project-local worktrees when ignored, otherwise fall back to /tmp locations with automatic project naming.
  • Integration readiness: Pairs with cleanup and verification steps to ensure reproducible, auditable work.

Quick Start

Create a new worktree for your feature branch in the recommended location, install dependencies with Pixi, and verify a clean baseline by running tests.

Frequently Asked Questions about git-worktrees

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

FAQPage Schema
How do I create isolated git worktrees for parallel branch development?

To create isolated git worktrees, you can generate project-local .worktrees or shareable /tmp workspaces, allowing you to safely develop features on parallel branches without disrupting your main directory.

What is the safest way to manage git worktrees without accidental commits?

The safest way to manage git worktrees is by verifying their ignored status and keeping them out of version control, which enforces directory selection rules and prevents accidental commits to the main repository.

Can I use git worktrees in /tmp if my project lacks a local ignore configuration?

Yes, you can use git worktrees in /tmp if local ignoring is unavailable, the system falls back to /tmp locations with automatic project naming to ensure safe and isolated feature development.

How do I clean up and verify temporary git workspaces after feature work?

You can clean up and verify temporary git workspaces using a dedicated workflow that pairs creation with cleanup and verification steps, ensuring reproducible and auditable work results.

Why should I use git worktrees instead of cloning multiple repository copies for feature work?

Git worktrees provide isolated workspaces that share the same repository, allowing fearless feature work without the overhead and storage waste of cloning multiple repository copies for each branch.