Tmux Worktree Plugins
- 2 repo stars
- Updated January 29, 2026
- zc277584121/cc-tmux-worktree-orchestration
tmux-worktree-plugins is a Claude Code plugin marketplace that orchestrates parallel AI development by combining tmux, git worktrees, and multiple Claude Code instances for developers shipping several features simultaneo
About
tmux-worktree-plugins is a Claude Code plugin marketplace exposing `/tmux-worktree-split` and `/tmux-worktree-merge` commands that combine tmux, git worktrees, and auto-started Claude Code sessions for parallel feature development. Split creates one worktree and feature branch per task—login, signup, api—organized as tmux sessions, windows (default), or panes, recording state in `.worktree-split-state.md`. Each environment gets an isolated checkout under `../project-feature/` with Claude Code launched automatically. Merge reads the state file, merges feature branches to the base branch, removes worktrees, kills tmux sessions, and deletes the state file. Natural-language feature lists and `--base-branch develop` are supported; merge offers `--skip-merge` and `--force` cleanup. Reach for tmux-worktree-plugins when you want visible parallel Claude Code panes with persistent tmux sessions—not background Agent-tool isolation alone.
- /tmux-worktree-split creates git worktrees plus auto-started Claude Code per feature
- Supports tmux session, window (default), or pane organization levels
- Tracks split state in .worktree-split-state.md for deterministic /tmux-worktree-merge cleanup
- Parses natural-language feature lists like "login, signup, and dashboard"
- Merge command combines branches, removes worktrees, and kills tmux sessions
Tmux Worktree Plugins by the numbers
- Data as of Jul 7, 2026 (Skillselion catalog sync)
/plugin marketplace add zc277584121/cc-tmux-worktree-orchestrationAdd your badge
Show developers this marketplace is listed on Skillselion. Paste this into your README.
| repo stars | ★ 2 |
|---|---|
| Last updated | January 29, 2026 |
| Repository | zc277584121/cc-tmux-worktree-orchestration ↗ |
How do you run parallel Claude Code sessions in tmux worktrees?
Run `/tmux-worktree-split login signup api` to spawn three tmux windows with git worktrees and auto-started Claude Code instances on separate feature branches.
Who is it for?
Developers on macOS or Linux with tmux who want visible parallel Claude Code sessions on isolated git worktree branches for multiple simultaneous features.
Skip if: Windows-only environments without tmux or teams preferring invisible background Agent-tool worktree isolation without terminal session management.
What you get
Per-feature git worktrees, tmux session layout, `.worktree-split-state.md` tracking, merged branches, and cleaned-up sessions after `/tmux-worktree-merge`.
- feature branch worktrees
- tmux session layout
- merged base branch after cleanup
By the numbers
- Supports 3 tmux organization levels: session, window, and pane
- Tracks parallel splits in .worktree-split-state.md until merge completes
Plugins in this marketplace
1 plugin - install individually after you add the marketplace.
Recommended Marketplaces
How it compares
Use tmux-worktree-plugins when you want visible, persistent tmux-managed Claude Code panes per worktree—not background Agent-tool dispatch without terminal session control.
FAQ
What prerequisites does Tmux Worktree Plugins require?
Tmux Worktree Plugins requires tmux, git with worktree support, and the Claude Code CLI in PATH. Install tmux via brew on macOS or apt/dnf on Linux; run commands from inside a git repository root.
What tmux organization levels are supported?
Tmux Worktree Plugins supports three tmux levels: session (one tmux session per feature), window (default—windows in one session), and pane (split panes in one window). Choose with `--tmux-level session`, `window`, or `pane` on split.