OpenSkillIndex← back to search
claude-code

Awesome-omni-skill cli-duo

Coordinate two AI CLIs on the same repo without conflicts (subordinate worktrees + engineer/judge roles).

install
source · Clone the upstream repo
git clone https://github.com/diegosouzapw/awesome-omni-skill
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/diegosouzapw/awesome-omni-skill "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/cli-automation/cli-duo" ~/.claude/skills/diegosouzapw-awesome-omni-skill-cli-duo && rm -rf "$T"
manifest: skills/cli-automation/cli-duo/SKILL.md
source content

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> --confirm
    tears down the worktree (if created) and deletes the session.