claudeers.
// Developer Tools

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.
// or install directly (npm)
npm install troupe-cli
// or clone
git clone https://github.com/hitianqi/troupe

// compatibility

Platformscli
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguageTypeScript

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

troupe — One command. Your agents, in order.

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.

Open the English demo: the troupe panel shows the team and highlights an agent waiting for you
▶ 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.

The live troupe panel: agent roles, work stages, activity and a flow of the team

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

  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 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.
  4. 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.

Reviewing and approving a plan

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

Agent terminals working side by side

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

Pull request approval, merge confirmation and 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

Prover

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.

10 views
★ 12 stars
unclaimed
updated 11 days ago

// embed badge

troupe on Claudeers
[![Claudeers](https://claudeers.com/api/badge/troupe.svg)](https://claudeers.com/troupe)

// retro hit counter

troupe hit counter
[![Hits](https://claudeers.com/api/counter/troupe.svg)](https://claudeers.com/troupe)

// reviews

// guestbook

0/500

// related in Developer Tools

🔓

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Curs…

// devtoolsaffaan-m/⟨JavaScript⟩★ 297,269◷ MIT[ claude ]
🔓

Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.

// devtoolsDietrichGebert/⟨JavaScript⟩★ 187,728◷ MIT[ claude ]
🔓

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,…

// devtoolssafishamsi/⟨Python⟩★ 147,800◷ MIT[ claude ]
🔓

Use Garry Tan's exact Claude Code setup: 23 opinionated tools that serve as CEO, Designer, Eng Manager, Release Manager, Doc Engineer, and QA

// devtoolsgarrytan/⟨TypeScript⟩★ 140,465◷ MIT[ claude ]
→ see how troupe connects across the ecosystem