by hitianqi
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.
# Add to your Claude Code skills
git clone https://github.com/hitianqi/troupeGuides for using ai agents skills like troupe.
See how troupe compares with popular alternatives.
troupe is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by hitianqi. 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 has 50 GitHub stars.
troupe's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.
Clone the repository with "git clone https://github.com/hitianqi/troupe" and add it to your Claude Code skills directory (see the Installation section above).
troupe is primarily written in TypeScript. It is open-source under hitianqi on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh troupe against similar tools.
No comments yet. Be the first to share your thoughts!
Available after the catalog security scan passes.
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
The deep catalog scan for this skill is still queued. Run an instant dependency check now instead.
A task from plan to review and cleanup, in 68 seconds.
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.
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.

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