Templates

tmux-ide ships with templates for common setups. tmux-ide init --template <name> writes them to .tmux-ide/workspace.yml; adjust the generated file to your needs.

Default

A minimal setup with two Claude panels and a shell.

version: 1
name: my-project

terminal:
  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.

version: 1
name: my-app
before: pnpm install

terminal:
  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.

version: 1
name: my-app
before: pnpm install

terminal:
  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.

version: 1
name: my-app
before: pnpm install

terminal:
  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.

version: 1
name: my-app
before: go mod download

terminal:
  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. Mission runtime wiring is future work for the workspace config model.

version: 1
name: my-project

terminal:
  rows:
    - size: 70%
      panes:
        - title: Lead
          command: claude
          focus: true
        - title: Teammate 1
          command: claude
        - title: Teammate 2
          command: claude
    - panes:
        - title: Dev Server
        - title: Shell

Missions Template

Mission-ready pane layout with a lead, worker panes, validation, research, and shell access. The workspace file declares layout only; mission runtime wiring is future work.

tmux-ide init --template missions

Creates:

.tmux-ide/workspace.yml with 6 panes: Lead, Frontend, Backend, Validator, Researcher, Shell
.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:

version: 1
name: project-name

terminal:
  rows:
    - size: 70%
      panes:
        - title: Lead
          command: claude
          focus: true
        - title: Frontend
          command: claude
        - title: Backend
          command: claude
    - size: 30%
      panes:
        - title: Validator
          command: claude
        - title: Researcher
          command: claude
        - title: Shell

Agent Team — Monorepo

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

version: 1
name: my-monorepo
before: pnpm install

terminal:
  rows:
    - size: 70%
      panes:
        - title: Lead — Architect
          command: claude
          focus: true
        - title: Frontend Agent
          command: claude
          dir: apps/web
        - title: Backend Agent
          command: claude
          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

version: 1
name: my-api

terminal:
  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

version: 1
name: my-monorepo

terminal:
  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