# 1. install
brew install tqer39/tap/ccw

# 2. run inside any git repo
ccw

That's it. ccw scans .claude/worktrees/ and shows the picker, or spins up a fresh worktree if none exist.

• 🤝 Hand-off and step aside — pick (or create) a worktree, launch claude in it, then ccw exits. No daemon, no wrapper process, no coupling to tmux/zellij — just the bridge.
• 🎯 Worktree state at a glance — pushed / ahead / behind / dirty, plus PR info, all in one picker
• 🧹 Bulk cleanup — [clean pushed] or ccw --clean-all sweeps the worktrees you're done with
• 📋 Machine-readable list — ccw -L --json aggregates worktree × git × PR × session info in one shot, ideal for scripts and Claude Code agent use

Note: the 💬 RESUME badge only signals that a session log exists for the worktree. The session title or first prompt is not previewed in the picker — ccw simply runs claude --continue and lets the Claude Code CLI pick the most recent session.

ccw                                       # pick an existing worktree, or start fresh
ccw -n                                    # new worktree, skip picker
ccw -s                                    # new worktree + inject the localized superpowers preamble as first prompt
ccw -- --model <model-id>                 # pass-through: any flags after `--` go to claude verbatim
ccw -L                                    # list ccw worktrees (text table)
ccw -L --json                             # same, JSON for scripts / agents
ccw -L -d ~/repo --no-pr --no-session     # target a specific repo, skip gh and session lookup
ccw --clean-all --status=pushed --dry-run # preview bulk delete targets
ccw --clean-all --force -y                # nuke everything without prompt

Run ccw --help for the full flag reference.

Worktree status badge:

PR state badge (shown only when gh is installed and authenticated):

Session badge:

Selecting a worktree opens [r] run / [d] delete / [b] back. run calls claude --continue to restore the past conversation when a session log exists, or claude -n <worktree> to start fresh otherwise. Bulk shortcuts ([delete all], [clean pushed], [custom select]) remove many at once; dirty items require either --force or a three-choice confirm (y force · s skip dirty · N cancel).

Without gh, the picker stays functional and shows a hint; rate-limit / network failures hide the PR column silently.

When ccw creates a new worktree, the worktree directory and the Claude Code session name are kept 1:1:

• Directory: <repo>/.claude/worktrees/<name>/
• Session name: <name> (set via claude -n <name>)

<name> is generated as ccw-<owner>-<repo>-<yymmdd>-<hhmmss> (e.g. ccw-tqer39-ccw-cli-260426-143055). <owner> / <repo> come from the origin remote URL; the timestamp is the worktree creation time in your local timezone. When origin is unset, <owner> becomes local and <repo> is the directory basename. Duplicate names (e.g. two worktrees created within the same second) are disambiguated with -2, -3, … Renaming the session manually with /rename is fine — ccw does not track it, and --continue keys off the working directory so conversation restore is unaffected.

brew install tqer39/tap/ccw

git clone https://github.com/tqer39/ccw-cli ~/ccw-cli
go build -o ~/.local/bin/ccw ~/ccw-cli/cmd/ccw

Make sure ~/.local/bin is on your PATH.

• git
• Claude Code >= 2.1.76 — ccw uses --worktree <name> (added in 2.1.49) together with -n <name> (added in 2.1.76). ccw offers to install claude via npm / brew if missing.
• (optional) gh — enables PR info in the picker
• (optional) superpowers plugin — only relevant when launching with -s (which injects the localized superpowers preamble). Declared in .claude/settings.json so Claude Code prompts to install it on first launch in this repo

Exit codes: 0 success · 1 user error / cancel · anything else is forwarded from claude.

go test ./...
go vet ./...
go build ./cmd/ccw

Set up the full dev environment (Homebrew required) with:

make bootstrap

This installs the Homebrew packages listed in Brewfile, provisions Go / Node via mise, and enables lefthook pre-commit hooks.

See docs/assets/picker-demo-setup.sh + picker-demo.tape to regenerate the demo GIF with vhs.

This project was built with Claude Code using Claude Opus 4.7.

MIT