https://tmux.thijsverreck.com

tmux-ide

Search
[?]K

  *  

tmux-ideNew 1.2.0

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.

Set Up Agent TeamsGet StartedDocs
$curl -fsSL https://tmux.thijsverreck.com/install.sh | sh
or npm i -g tmux-ideor try instantly with npx tmux-ide

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

MY-APP IDE
MY-APP IDEteam: my-app
Read the Agent Teams guide -

Config in, layout out

Edit the YAML and watch the layout update live. Try a preset to get
started.

DefaultNext.jsConvexVitePythonGoAgent Team
ide.yml
[name: my-project  ro]
tmux session
Claude 1
$ claude
Claude 2
$ claude
Dev Server
Shell
[0] my-project12:00

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.

Quick start

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

tmux-ide by Thijs Verreck
DocsGitHub