Run Claude agent teams
in one terminal.
Orchestrate a team lead and multiple Claude teammates — each in its own tmux pane, coordinating through shared tasks. One YAML config, one command, a fully managed agent team.
npm i -g tmux-ideor try instantly with npx tmux-ideThe install script also registers the Claude Code skill — so Claude can configure your workspace automatically.
The lead spawns teammates on the fly
Your team lead analyzes the project, decides it needs help, and spawns a new agent — right into its own pane. Tasks are assigned, work happens in parallel.
Config in, layout out
Edit the YAML and watch the layout update live. Try a preset to get started.
Lead + teammates
One Claude coordinates the team. Teammates work independently in their own panes, each with a focused task.
Shared task list
Agents communicate through shared tasks and messages. The lead assigns, teammates claim and report back.
Self-organizing
The lead can spawn new teammates, reassign work, and restart the layout — all from within its own session.
Declarative YAML
Define your team layout in ide.yml — roles, tasks, pane sizes. Reproducible across machines and projects.
Any stack
Auto-detects Next.js, Vite, Python, Go, and more. Dev servers run alongside your agent team.
One command
tmux-ide handles tmux sessions, pane splitting, env vars, and agent flags. You just run tmux-ide.
Claude Code skill built in
The install script registers a Claude Code skill automatically. Ask Claude to set up your workspace and it handles detection, layout, and config.
$ cd ~/Developer/my-project
$ tmux-ide init --template agent-team
→ Created ide.yml with agent team layout.
$ tmux-ide
→ Launching IDE session with 3 agents...
$ tmux-ide restart
→ Restarted with updated layout.