Prepare Claude agent-team layouts
in one terminal.
Build a lead pane, teammate-ready Claude panes, and your dev tools in one tmux layout. tmux-ide enables the right environment; Claude forms the team after you prompt it.
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.
Team-ready panes, then Claude takes over
tmux-ide prepares the panes and enables agent-team mode. From there, prompt the lead to organize the team and assign work in natural language.
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
Once the layout is running, the lead can recruit teammates, reassign work, and reshape the workflow through normal Claude prompting.
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, and the experimental env flag. You launch the layout, then tell Claude how to organize the team.
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 lead and teammate-ready panes...
$ tmux-ide restart
→ Restarted with updated layout.