tmux-ide

tmux-ide is a command-line tool that transforms any project directory into a fully configured tmux-powered terminal IDE using a simple ide.yml config file. It orchestrates teams of Claude AI agents — each running in its own tmux pane — coordinating through shared tasks and messages. One YAML config and one command launches a complete multi-agent workspace with dev servers, labeled panes, and Claude instances ready to go.

• Agent Teams — Define a team lead and multiple Claude teammates; the lead analyzes the project, spawns agents on the fly, assigns tasks, and work happens in parallel across panes.
• Declarative YAML Config — Edit ide.yml to define roles, tasks, and pane sizes; the layout updates live and is fully reproducible across machines and projects.
• One-Command Launch — Run tmux-ide to handle tmux session creation, pane splitting, environment variables, and agent flags automatically.
• Self-Organizing Teams — The lead agent can spawn new teammates, reassign work, and restart the layout from within its own session.
• Shared Task List — Agents communicate through shared tasks and messages; the lead assigns, teammates claim and report back.
• Stack Auto-Detection — Automatically detects Next.js, Vite, Python, Go, and more, running dev servers alongside your agent team.
• Claude Code Skill Built In — The install script registers a Claude Code skill automatically, letting Claude configure your workspace, detect the stack, and set up the layout.
• Flexible Installation — Install globally via npm i -g tmux-ide, run instantly with npx tmux-ide, or use the provided install script.
• Preset Templates — Get started quickly with built-in templates for Next.js, Convex, Vite, Python, Go, and agent team layouts.
• Live Layout Reload — Use tmux-ide restart to apply updated config without manually tearing down and rebuilding your session.