git-worktree

Automate Git worktree creation, listing, switching, and cleanup for isolated parallel development.

12|2|Updated Jan 27, 2026
One-click install
npx skills add https://github.com/jikig-ai/soleur --skill git-worktree-jikig-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-worktree
Source: https://github.com/jikig-ai/soleur/tree/main/plugins/soleur/skills/git-worktree
Command: npx skills add https://github.com/jikig-ai/soleur --skill git-worktree-jikig-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires bun, git, and includes scripts (resource) components.

What problem does it solve?

Coordinating and maintaining multiple Git worktrees for parallel development can be error-prone and tedious, risking cross-branch contamination and wasted time.

Core Features & Use Cases

  • Unified worktree lifecycle: create, list, switch, and clean up isolated worktrees from a single interface.
  • Safety and consistency: per-worktree config handling, environment copying, and registration verification to ensure each worktree is valid and isolated from the main checkout.
  • Use cases include performing isolated code reviews, feature development in parallel, and rapid cleanup of stale worktrees.

Quick Start

Create a new worktree for a feature using the manager to isolate development from the main branch.

Frequently Asked Questions about git-worktree

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

FAQPage Schema
How do I manage Git worktrees for parallel development without causing cross-branch contamination?

Manage Git worktrees through a unified interface that handles creation, listing, switching, and cleanup to ensure isolated parallel development. Per-worktree configuration and environment file copying guarantee each worktree remains valid and isolated from the main checkout.

How does environment file handling work when creating isolated Git worktrees?

Environment file handling for Git worktrees works by copying per-worktree configuration files into each new isolated checkout. This ensures every parallel development branch maintains its own valid environment setup, preventing cross-branch contamination during feature work.

Do I need Bun and Git installed to automate worktree lifecycle management?

Yes, you need both Bun and Git installed to automate worktree lifecycle management. Bun executes the automation scripts while Git provides the underlying worktree functionality required to create, list, switch, and clean up isolated parallel development branches.

Can I use Git worktree automation safely with bare repositories?

Git worktree automation supports bare-repo-safe operations, allowing you to manage isolated parallel development branches within bare repositories. Registration verification validates each worktree against the bare repository to ensure safe and consistent execution.

What is the best way to clean up stale Git worktrees after parallel feature development?

The best way to clean up stale Git worktrees is using a unified lifecycle manager that safely removes isolated checkouts after parallel feature development. It validates worktree registration before deletion, ensuring the main repository remains consistent and free of orphaned branches.

Why does Git worktree registration validation matter for parallel code reviews?

Git worktree registration validation matters because it verifies each isolated checkout is properly linked to the main repository before you begin parallel code reviews. This prevents cross-branch contamination and ensures each worktree remains a valid, isolated environment.