oss

tmux-ide is an open-source project by Prototyper.View source(opens in a new tab)

tmux-ide home

Workspace templates

The workspace templates shipped with tmux-ide 2.9.5, what each layout contains, and how to start a project from one with tmux-ide init --template.


A template is a ready-made .tmux-ide/workspace.yml: a tmux layout with agent panes on top and dev server, git changes and shell panes below. tmux-ide init --template <name> writes one into the current project, names the session after the directory, and validates the file before writing it.

Version 2.9.27 retains the 2.9.7 template surface. See the 2.9.27 release notes.

Templates in tmux-ide 2.9.5

TemplateInitial layout
defaultTwo Claude panes; Changes, Dev Server, and Shell below
nextjsThree Claude panes; Next.js, Changes, and Shell below
convexThree Claude panes; Next.js, Convex, and Shell below
viteTwo Claude panes; Vite, Changes, and Shell below
goTwo Claude panes; Go, Changes, and Shell below
pythonTwo Claude panes; Server, Changes, and Shell below
agent-teamLead and two teammate panes; Changes, Dev Server, and Shell below
agent-team-nextjsLead, Frontend, and Backend agents; Next.js, Changes, and Shell below
agent-team-monorepoLead plus agents rooted in apps/web and apps/api; matching dev panes and Shell below
missionsLead, Frontend, and Backend above Validator, Researcher, and Shell (pane layout only)

Run, for example:

tmux-ide init --template nextjs
tmux-ide validate --json
tmux-ide start

What the default template generates

The shipped default template currently produces this structure (the name is rewritten for your directory):

name: my-project
version: 1

terminal:
  rows:
    - size: 70%
      panes:
        - id: agent-1
          title: Claude 1
          command: claude
        - id: agent-2
          title: Claude 2
          command: claude
    - panes:
        - id: changes
          title: Changes
          type: changes
        - id: dev
          title: Dev Server
        - id: shell
          title: Shell
          focus: true

Stable pane id values let tmux-ide keep recognizing a pane after you rename it.

Files the agent-team templates add

The agent-team, agent-team-nextjs, and agent-team-monorepo templates also copy the bundled skill files and create, when missing:

  • .tmux-ide/library/architecture.md
  • .tmux-ide/library/learnings.md
  • .tasks/validation-contract.md
  • AGENTS.md

The missions template creates the same files plus .tmux-ide/skills/. Existing files are not overwritten.

These templates create agent-ready pane layouts and project context. They do not add a legacy orchestrator block or automatically dispatch work. To change a generated layout, see the workspace.yml reference. To send work between agent panes, see Multi-agent teams; to give each agent its own branch, see Worktrees.

Detect a layout from your stack

Without --template, tmux-ide init detects the stack. Recognized frameworks produce a suggested layout; otherwise it falls back to default:

tmux-ide detect --json
tmux-ide init

Use tmux-ide detect --write when you want detection to write directly. Both commands refuse to overwrite an existing workspace config.

See also