Worktree Workflow
https://github.com/forrestchang/worktree-workflow- Category
- Developer Tools
- Rank
- No. 1146Tools index
Previous survey · No. 1151 ·
- Pricing
- Open Source
- Type
- TOOL
- Builder
- forrestchang
- GitHub
- 109 stars
- Date
About
Toolkit for parallel development with git worktrees, designed for Claude Code.
What it does
Worktree Workflow turns each development task into a separate working directory and branch, then starts Claude Code inside it. It detects the repository’s default branch, fetches that branch, creates the new worktree, and optionally supplies an opening prompt. Companion Claude commands guide pull request creation, issue completion, branch naming, and cleanup.
Why it's ranked here
The tool has a focused, understandable workflow with few moving parts. Its directory convention prevents obvious cross-project naming collisions, while automatic default-branch detection removes routine setup. The main reservation is serious: the launcher skips Claude Code permission prompts by default, and installation behavior conflicts with the documentation’s backup claim.
What's good
It accepts named or temporary branches, converts branch slashes into directory-safe names, and supports a configurable worktree location. Safe mode remains available when permission prompts matter. Pull request guidance checks commits, diffs, uncommitted changes, remote state, and base branches. Issue completion requires confirmation before closing work.
Tradeoffs
Dangerous mode is the default, so an ordinary launch disables permission prompts unless the user opts into safety. The installer removes existing destinations instead of making the timestamped backups promised by the documentation. Worktree creation assumes an origin remote and fetchable default branch. Pull requests and issue updates also depend on optional external command-line tools.
How to use it well
This fits developers who regularly run concurrent Claude Code tasks across several branches and want a fixed, recognizable worktree layout. Prefer named branches and safe mode for controlled sessions. Use its guided commands for branch isolation and handoff preparation. It does not replace code review, testing, GitHub hosting, or an issue tracker.
Technical notes+
bin/claude-wt is a sourced Bash launcher that detects origin/HEAD, falls back to remote main or master, then the current branch, fetches the base, and runs git worktree add before starting claude; --dangerously-skip-permissions is enabled unless --safe is passed. skills/worktree/SKILL.md defines the Claude worktree procedure and temporary-branch renaming policy. commands/pr.md and commands/done.md contain guided PR and issue-completion workflows. install.sh symlinks the launcher and copies the skill and commands, but its safe_install removes existing targets with rm -rf; this contradicts the backup behavior stated in README.md. uninstall.sh removes those installed artifacts.
Observed
- License
- MIT License
- Primary language
- Bash shell scripts, with Markdown-defined Claude Code skills and commands
- Install surface
- Shell installer symlinks the launcher into ~/.local/bin and copies assets into ~/.claude
- Interfaces
- Sourced shell CLI, Claude Code skill, and Claude Code slash commands
- Required dependencies
- git and the Claude Code CLI
- Optional integrations
- GitHub CLI for pull requests and Linear CLI for issue updates
- Shell configuration
- Documentation covers zsh and bash configuration
- Repository structure
- The supplied repository tree shows no test directory
Read from README.md, LICENSE, install.sh, uninstall.sh, bin/claude-wt, commands/pr.md, commands/done.md, skills/worktree/SKILL.md.
What it can do
Create git worktree
Repository path and branch name → New worktree directory
Switch between worktrees
Worktree identifier or path → Active worktree context
Manage parallel development branches
Multiple feature branches → Isolated development environments
Delete worktree
Worktree path or identifier → Removed worktree and cleanup
List active worktrees
Repository reference → Worktree status and locations
Integrate with Claude Code workflow
Claude Code project and worktree configuration → Configured development environment
Tags
Tech Stack
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.