worktree

Manage Git worktrees and per-feature Claude sessions with tmux.

171|23|Updated Jan 21, 2026
One-click install
npx skills add https://github.com/team-attention/hoyeon --skill worktree-team-attention
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: worktree
Source: https://github.com/team-attention/hoyeon/tree/main/skills/worktree
Command: npx skills add https://github.com/team-attention/hoyeon --skill worktree-team-attention

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables teams to manage parallel development work by coordinating Git worktrees and Claude agent sessions, reducing context switching and merge conflicts when building features in isolation.

Core Features & Use Cases

  • Create and navigate multiple worktrees tied to feature branches, each with its own Claude session.
  • View unified progress across all worktrees, including PLAN plan completion, uncommitted changes, and session activity.
  • Clean up completed worktrees and optionally remove associated branches to keep the repository tidy.

Quick Start

Use the /worktree create <name> command to spin up a new worktree for a feature, then check status with /worktree status and cleanup with /worktree cleanup <name> when finished.

Frequently Asked Questions about worktree

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

FAQPage Schema
How do I manage parallel development with Git worktrees and isolated Claude sessions?

You can manage parallel development by using this skill to automate creating Git worktrees tied to feature branches, each running its own isolated Claude session via tmux. It tracks uncommitted changes and session activity to reduce context switching and merge conflicts.

What's the best way to track progress across multiple Git worktrees?

Tracking progress across multiple Git worktrees is done by reading local metadata files under the .dev directory. The skill aggregates plan completion, uncommitted changes, and session activity into a unified status report for all active feature branches.

How do I clean up completed Git worktrees and remove feature branches?

To clean up completed Git worktrees, run the cleanup command to remove the worktree directory and optionally delete the associated feature branch. This keeps your repository tidy by pruning stale development environments and their tracking metadata.

Do I need tmux and hy CLI to run worktree sessions?

Yes, you need tmux and the hy CLI wrapper to use this skill. It relies on tmux for managing per-feature terminal sessions and the hy CLI wrapper for executing standard Git commands and handling local state files.

Can I integrate a development plan into an isolated Git worktree session?

Yes, you can integrate a development plan into an isolated Git worktree session. The skill supports plan integration, allowing you to track plan completion alongside uncommitted changes and session activity within each individual feature branch environment.