issue-worktree

Create Git worktrees and tmux windows from GitHub issues.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/chiyonn/dotfiles --skill issue-worktree
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: issue-worktree
Source: https://github.com/chiyonn/dotfiles/tree/main/dot_claude/skills/issue-worktree
Command: npx skills add https://github.com/chiyonn/dotfiles --skill issue-worktree

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates creating Git worktrees and tmux windows from GitHub issues, enabling rapid setup for issue-driven work.

Core Features & Use Cases

  • End-to-end Issue-to-Workspace: From an issue number, derives a descriptive branch name, creates a corresponding Git worktree, opens a dedicated tmux window, and initializes a Claude worker protocol for collaboration.
  • Consistent Naming: Enforces branch naming like feat_{number}-{description} and worktree paths like ../{repo_name}-{number} to keep workspaces organized.
  • Use Case: Start working on issue #42 by creating a feature branch, a new worktree directory, and a focused tmux session in one step.

Quick Start

gh issue view 42 --json number,title Then run the full workflow to create branch, worktree, and tmux window

Frequently Asked Questions about issue-worktree

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

FAQPage Schema
How do I create a git worktree from a GitHub issue automatically?

You can create a git worktree from a GitHub issue by using an automation workflow that derives a branch name from the issue, creates the worktree directory, and opens a dedicated tmux window. This process requires Git 2.17+, gh CLI, tmux, and mise to orchestrate the setup.

What is issue-driven workspace automation with git worktrees and tmux?

Issue-driven workspace automation is the process of spawning git worktrees and tmux windows directly from GitHub issues. It enables rapid development setup by mapping an issue number to a descriptive branch, an isolated worktree path, and a focused tmux session.

Do I need gh CLI and tmux to set up git worktrees from issues?

Yes, you need gh CLI and tmux to set up git worktrees from issues. The workflow also requires Git 2.17+ for worktree management and mise to orchestrate the environment and Claude-based worker protocols.

How do I manage multiple GitHub issues with separate git worktrees?

You manage multiple issues with separate git worktrees by applying consistent naming conventions derived from issue numbers. The automation creates branches like feat_{number}-{description} and worktree paths like ../{repo_name}-{number} to keep workspaces organized and isolated.

What's the best way to integrate tmux windows with git worktrees for development?

The best way to integrate tmux windows with git worktrees is through an automation workflow that pairs every new worktree with a dedicated tmux session. This approach initializes a Claude worker protocol within the session for streamlined issue-driven collaboration.