# tmux-ide CLI tool that turns any project directory into a [[TMux]]-powered terminal workspace from a declarative YAML config file (`ide.yml`). Define panes, rows, sizes, commands, and labels; run `tmux-ide` and get a fully configured tmux session. Built by Thijs Verreck. Installed via npm (`npm i -g tmux-ide`) or run directly with `npx tmux-ide`. ## Core workflow ```bash cd ~/Developer/my-project tmux-ide init # scaffold an ide.yml tmux-ide # launch the session tmux-ide restart # restart with updated config ``` ## Agent team layouts The main draw: tmux-ide can prepare multi-pane layouts specifically for [[Claude Code Agent Teams]]. It sets up a lead pane and multiple teammate panes, each running a [[Claude Code]] instance. The lead coordinates the team; teammates work independently in their own context windows. ```yaml name: my-project rows: - size: 70% panes: - title: Claude 1 command: claude - title: Claude 2 command: claude - panes: - title: Dev Server - title: Shell ``` The install script also registers a [[Claude Code Skills|Claude Code skill]] so Claude can configure the workspace automatically. ## Features - **Declarative YAML**: reproducible layouts, version-controllable - **Auto-detection**: detects Next.js, Vite, Python, Go, etc. and starts appropriate dev servers - **Agent team support**: lead + teammate pane topology for [[Claude Code Agent Teams]] - **Preset templates**: `tmux-ide init --template agent-team` for quick scaffolding ## References - https://tmux.thijsverreck.com - https://github.com/wavyrai/tmux-ide ## Related - [[TMux]] - [[Terminal Multiplexers]] - [[Claude Code Agent Teams]] - [[Claude Code]] - [[Claude Code Skills]] - [[Command Line Interface (CLI)]]