Claude Code multi-agent

Troupe

Run a team of coding agents you can actually watch: one approved plan, each role in its own tmux window and git worktree, on Claude Code or Codex.

Install

Install
npm install -g troupe-cli

Found in the project README. Check it for setup steps after installing.

From source
git clone https://github.com/hitianqi/troupe.git

From the README

Put Claude Code and Codex on the same team.
  See every agent. Step in anytime.

Demo

A task from plan to review and cleanup, in 68 seconds.

  ▶ English demo · 1:08
  · 中文版
  · 1080p downloads

Why troupe

- See the team, and step in. Every agent is a real Claude Code or Codex session. One panel shows who is working and who needs you. Jump into any agent's terminal to read along or answer it.
- Agree on the work before it starts. Review the plan, change the split, and approve it. Each role gets its own git worktree and branch; planned file overlaps need an explicit order.
- Build and review with different agents. Mix Claude Code and Codex, models and effort per role. The default workflow reviews each branch, asks before opening the pull request, and waits for your merge confirmation before cleanup.

Quick start

You need macOS, Linux or WSL2, tmux, Node.js 20+, git, and Claude Code and/or Codex, installed and signed in.

Install:

To run your own build instead, see Contributing.

troupe setup installs the workflow skill for the agents it finds.

Then open Claude Code or Codex inside tmux, in the repository you want to change, and ask:

The agent writes the plan and opens the panel beside it. Read the plan, press a to approve or c to request changes, and the team starts after approval.

You can also run troupe up -m  in your target repository to start the orchestrator and panel together.

From one task to a finished change

1. Plan together. The orchestrator reads your code and proposes the work, roles and completion criteria. You can ask for changes before approving.
2. Watch the team work. Independent roles run in parallel; dependent roles wait their turn. Each has a terminal and worktree of its own. The panel shows when someone needs you.
3. Review each branch. A…
Read the full README on GitHub

Details

Language
TypeScript
License
MIT
Last updated
7 November 2026
Topics
ai-agentsclaude-codeclicodexcoding-agentsdeveloper-toolsgit-worktreemulti-agenttmuxtypescript

FAQ

What is Troupe?

Run a team of coding agents you can actually watch: one approved plan, each role in its own tmux window and git worktree, on Claude Code or Codex. It is a multi-agent for Claude Code, from hitianqi/troupe on GitHub.

How do I install Troupe?

Run npm install -g troupe-cli, then follow the setup in the README.

Is Troupe popular?

hitianqi/troupe has 28 GitHub stars and 8 forks. It was last updated on 7 November 2026.

More multi-agent & worktrees

Browse the most popular Claude Code mods, all multi-agent & worktrees, or the skills and MCP server directories.