Cc Launcher

cc-launch

[中文说明](https://github.com/panjiangyi/cc-launcher/blob/main/README.zh-CN.md)

A Git worktree launcher with a single `ccl` entrypoint for creating, entering, and cleaning up worktrees, then launching `codex` or `claude` in the target directory.

Install

For Zsh:

npm install -g cc-launch && echo 'eval "$(command ccl init zsh)"' >> ~/.zshrc && source ~/.zshrc

For Bash:

npm install -g cc-launch && echo 'eval "$(command ccl init bash)"' >> ~/.bashrc && source ~/.bashrc

Usage

Run from any subdirectory inside a Git repository:

ccl

Menu interaction:

• Use ↑ / ↓ to move
• Press Enter to confirm
• Press q, Esc, or Backspace to go back; from the top-level menu this exits, otherwise it returns to the previous menu
• Mouse wheel navigation and click-to-select are supported when the terminal reports mouse coordinates

Project config:

• setup.sh and config.json are stored in ~/.worktrees//
• On first run, the tool asks for the repository's main branch and writes it to config.json
• When creating worktrees later, the tool can either create a new task branch or check out an existing local or filtered remote branch that is not already used by another worktree
• For new task branches, the tool asks which branch to base the worktree on; the configured main branch is selected by default and can be accepted with Enter
• Deletion checks merge status against that configured main branch and accepts branches merged by merge commit, not just branches that git branch -d considers fully merged
• The delete menu includes clean linked worktrees plus local branches that are not checked out in any worktree, and labels each item as merged or unmerged
• Unmerged branches can still be deleted; ccl will warn and use git branch -D only after determining that the branch is not merged into the configured main branch

Interactive capabilities:

• New task: create `~/.worktrees//-<