tmux-ide — Claude Code Skill

Generate tmux IDE workspaces from ide.yml with stack detection.

535|29|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/wavyrai/tmux-ide --skill tmux-ide-claude-code-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tmux-ide — Claude Code Skill
Source: https://github.com/wavyrai/tmux-ide/tree/main/skill
Command: npx skills add https://github.com/wavyrai/tmux-ide --skill tmux-ide-claude-code-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

tmux-ide removes the friction of setting up a coordinated, multi-pane terminal development workspace by scaffolding and guiding a tmux-based IDE from a simple ide.yml file.

Core Features & Use Cases

  • Generate a working IDE layout from ide.yml: Define tmux session structure using rows and panes so editors, dev servers, tests, and shells run side-by-side.
  • Auto-detect your project stack: Use detection to propose and then write an appropriate configuration before you customize it.
  • Coordinate agent teams in Claude Code: Support a team workflow where a lead delegates to teammate panes (with role/task metadata) so parallel work starts in the right terminal layout.

Quick Start

Ask Claude Code to set up your workspace by running tmux-ide detect --write, then review the proposed ide.yml layout and adjust pane names/commands to match your stack.

Frequently Asked Questions about tmux-ide — Claude Code Skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a tmux terminal IDE workspace from a configuration file?

To set up a tmux terminal IDE, you define your session structure, rows, and panes in an ide.yml file, which the Skill uses to scaffold a coordinated multi-pane workspace with editors, dev servers, and shells running side-by-side.

How does project stack detection work for generating a tmux layout?

Project stack detection works by analyzing your codebase to propose an appropriate ide.yml configuration, which you can then review and customize before writing it to match your specific development stack and terminal requirements.

Can I coordinate multiple Claude Code agent teams in separate tmux panes?

Yes, you can coordinate agent teams in Claude Code by supporting a team workflow where a lead delegates to teammate panes with role and task metadata, enabling parallel work in the correct terminal layout.

What is the best way to start generating a tmux workspace configuration automatically?

The best way to start generating a tmux workspace configuration automatically is to run the detection command with the write flag, which proposes and writes an appropriate ide.yml layout based on your detected project stack.

Do I need to enable any specific settings to use agent team layouts in my terminal workspace?

Yes, when using team layouts in your terminal workspace, the configuration process requires enabling the experimental agent teams environment variable to allow a lead to delegate tasks to parallel teammate panes.

Why use an ide.yml file for terminal workspace configuration instead of manual tmux commands?

Using an ide.yml file removes the friction of manual tmux setup by declaratively scaffolding a coordinated, multi-pane terminal development workspace, ensuring consistent layouts for editors, dev servers, and tests.