
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 with your AI
Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.
Install and set up troupe (npm project) into my current project. Found on https://claudeers.com/troupe Repo: https://github.com/hitianqi/troupe Homepage/docs: — Detected install method: npm → npm install troupe-cli Category: devtools. Platforms: cli. Read the repo's README for exact setup and env vars, then install it and wire it into my project. Claudeers Health Verdict: unknown; community-verified: false. Confirm the source before running anything.
npm install troupe-cli
git clone https://github.com/hitianqi/troupe
// compatibility
| Platforms | cli |
|---|---|
| Operating systems | — |
| AI compatibility | claude |
| License | MIT |
| Pricing | open-source |
| Language | TypeScript |
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:
npm install -g troupe-cli
troupe setup
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:
Run a troupe mission: add a search box that filters the list as you type,
and a dark theme that follows the system setting.
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 <mission> in your target repository to start the orchestrator and panel together.
From one task to a finished change
- Plan together. The orchestrator reads your code and proposes the work, roles and completion criteria. You can ask for changes before approving.
- 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.
- Review each branch. A reviewer checks the work as it lands. Findings go back to the same agent for a fix round before the orchestrator merges into the mission branch.
- Approve the handoff. You approve opening the pull request, merge it yourself, and confirm. The workflow then closes its terminals and removes its temporary worktrees.
See the plan approval, agent terminals and final handoff
Change the plan, or approve it.

Claude Code, Codex and a reviewer, each in a real terminal.

You approve the pull request and confirm the merge before cleanup.

Make it yours
The workflow lives in a skill: when to review, when to merge and which questions to ask you. Change or replace it to fit how you work. The CLI checks plan approval, role dependencies, declared file overlaps and agent permissions.
Multiple missions can run in the same repository or across repositories. Each gets its own mission branch and worktree; your original checkout stays on its branch.
- User guide — plan format, commands, panel controls, adapters and known limits.
- Roadmap — product direction and what's next.
- Contributing — development setup, checks and adding an agent.
- Issues — bugs, questions and feature requests.
Acknowledgements
troupe started as an internal tool at Prover and is open-sourced with their support. See NOTICE.
MIT licensed. Built with TypeScript, tmux and git, with no runtime npm dependencies.
// 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 open-source on GitHub.
Is troupe free to use?
troupe is open-source under the MIT license, so it is free to use.
What category does troupe belong to?
troupe is listed under devtools in the Claudeers registry of Claude-compatible tools.
// embed badge
[](https://claudeers.com/troupe)
// retro hit counter
[](https://claudeers.com/troupe)
// reviews
// guestbook
// related in Developer Tools
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Curs…
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
AI coding assistant skill (Claude Code, Codex, OpenCode, Cursor, Gemini CLI, and more). Turn any folder of code, SQL schemas, R scripts, shell scripts, docs,…
Use Garry Tan's exact Claude Code setup: 23 opinionated tools that serve as CEO, Designer, Eng Manager, Release Manager, Doc Engineer, and QA