Templates

tmux-ide ships with templates for common setups. Copy these into your project as ide.yml and adjust to your needs.

Default

A minimal setup with two Claude panels and a shell.

name: my-project

rows:
  - size: 70%
    panes:
      - title: Claude 1
        command: claude
      - title: Claude 2
        command: claude

  - panes:
      - title: Dev Server
      - title: Shell

Next.js

Three Claude panels with a Next.js dev server.

name: my-app

rows:
  - size: 70%
    panes:
      - title: Claude 1 — feature
        command: claude
      - title: Claude 2 — review
        command: claude
      - title: Claude 3 — explore
        command: claude

  - panes:
      - title: Next.js
        command: pnpm dev
      - title: Shell

Next.js + Convex

Full-stack setup with Next.js frontend and Convex backend.

name: my-app

rows:
  - size: 70%
    panes:
      - title: Claude 1 — feature
        command: claude
      - title: Claude 2 — review
        command: claude
      - title: Claude 3 — explore
        command: claude

  - panes:
      - title: Next.js
        command: pnpm dev
      - title: Convex
        command: npx convex dev
      - title: Shell

Vite

Two Claude panels with a Vite dev server.

name: my-app

rows:
  - size: 70%
    panes:
      - title: Claude 1
        command: claude
      - title: Claude 2
        command: claude

  - panes:
      - title: Vite
        command: pnpm dev
      - title: Shell
        focus: true

Go

Two Claude panels with a Go server.

name: my-app

rows:
  - size: 70%
    panes:
      - title: Claude 1
        command: claude
      - title: Claude 2
        command: claude

  - panes:
      - title: Go
        command: go run .
      - title: Shell
        focus: true

Agent Team

A lead-focused layout with two teammate-ready Claude panes. See Agent Teams for details.

name: my-project

team:
  name: my-project

rows:
  - size: 70%
    panes:
      - title: Lead
        command: claude
        role: lead
        focus: true
      - title: Teammate 1
        command: claude
        role: teammate
      - title: Teammate 2
        command: claude
        role: teammate

  - panes:
      - title: Dev Server
      - title: Shell

Missions Template

Mission-mode agent team with a lead, specialty-based workers, validation, research, and shell access.

tmux-ide init --template missions

Creates:

ide.yml with 6 panes: Lead, Frontend, Backend, Validator, Researcher, Shell
orchestrator.dispatch_mode: missions
.tmux-ide/skills/ with 5 skill files
.tmux-ide/library/ for shared architecture and learnings
AGENTS.md with project boundaries and agent instructions

Full template:

name: project-name

team:
  name: missions

rows:
  - size: 70%
    panes:
      - title: Lead
        command: claude
        role: lead
        focus: true
      - title: Frontend
        command: claude
        role: teammate
        specialty: frontend
      - title: Backend
        command: claude
        role: teammate
        specialty: backend

  - size: 30%
    panes:
      - title: Validator
        command: claude
        role: validator
        skill: reviewer
      - title: Researcher
        command: claude
        role: researcher
        specialty: researcher
        skill: researcher
      - title: Shell

orchestrator:
  enabled: true
  auto_dispatch: true
  dispatch_mode: missions
  poll_interval: 5000
  stall_timeout: 300000
  master_pane: Lead

Agent Team — Monorepo

Specialized teammate-ready panes with per-app working directories.

name: my-monorepo

team:
  name: my-monorepo

rows:
  - size: 70%
    panes:
      - title: Lead — Architect
        command: claude
        role: lead
        focus: true
      - title: Frontend Agent
        command: claude
        role: teammate
        task: "Work on the frontend application"
        dir: apps/web
      - title: Backend Agent
        command: claude
        role: teammate
        task: "Work on the backend services"
        dir: apps/api

  - panes:
      - title: Frontend
        command: pnpm dev
        dir: apps/web
      - title: Backend
        command: pnpm dev
        dir: apps/api
      - title: Shell

Custom Examples

Python / FastAPI

name: my-api

rows:
  - size: 70%
    panes:
      - title: Claude 1
        command: claude
      - title: Claude 2
        command: claude

  - panes:
      - title: FastAPI
        command: uvicorn main:app --reload
      - title: Shell

Monorepo

name: my-monorepo

rows:
  - size: 60%
    panes:
      - title: Claude — frontend
        command: claude
      - title: Claude — backend
        command: claude

  - size: 40%
    panes:
      - title: Frontend
        command: cd apps/web && pnpm dev
      - title: Backend
        command: cd apps/api && pnpm dev
      - title: Shell

On this page