By name: cli-duo description: Coordinate two AI CLIs on the same repo without conflicts (subordinate worktrees + engineer/judge roles). metadata: version: 0.1.0 author: mcarls category: collaboration compatibility: - codex-cli - claude-code - cursor - gemini-cli
CLI Duo
Orchestrates two AI CLIs working on the same repository. Supports safe subordinate worktrees and engineer/judge review loops.
When to Use
- Two CLIs need to edit the same repo without clobbering each other's state
- You want a create → judge loop with explicit role swaps
- You need a temporary subordinate worktree for experiments
Core Concepts
- CLI Registry: Store known CLIs with names, commands, and default repos.
- Sessions: Pair two registered CLIs in either mode:
subordinate: Primary stays on the main repo; secondary gets a git worktree sandbox.engineer-judge: Assigns engineer/judge roles and lets you swap them per round.
Commands
# Register CLIs
duo cli register -n claude -c "claude" -d "Claude Code CLI"
duo cli register -n cursor -c "cursor" -d "Cursor CLI"
duo cli list
# Subordinate mode (creates secondary worktree)
duo pair create -s landing-refactor -p claude -b cursor -m subordinate -r ~/projects/app --confirm
duo pair info -s landing-refactor
duo pair end -s landing-refactor --confirm # removes worktree + session
# Engineer/Judge mode
duo pair create -s review-loop -p claude -b cursor -m engineer-judge -R 2
duo pair swap -s review-loop # swap roles after a round
duo pair info -s review-loop
Outputs
- Session summaries include the working directories each CLI should use.
- For subordinate sessions, the secondary path is a git worktree under
~/.local/share/cli-duo/worktrees/<session>/secondary.
Cleanup
duo pair end -s <session> --confirmtears down the worktree (if created) and deletes the session.