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
| Template | Initial layout |
|---|---|
default | Two Claude panes; Changes, Dev Server, and Shell below |
nextjs | Three Claude panes; Next.js, Changes, and Shell below |
convex | Three Claude panes; Next.js, Convex, and Shell below |
vite | Two Claude panes; Vite, Changes, and Shell below |
go | Two Claude panes; Go, Changes, and Shell below |
python | Two Claude panes; Server, Changes, and Shell below |
agent-team | Lead and two teammate panes; Changes, Dev Server, and Shell below |
agent-team-nextjs | Lead, Frontend, and Backend agents; Next.js, Changes, and Shell below |
agent-team-monorepo | Lead plus agents rooted in apps/web and apps/api; matching dev panes and Shell below |
missions | Lead, 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 startWhat 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: trueStable 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.mdAGENTS.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 initUse tmux-ide detect --write when you want detection to write directly. Both
commands refuse to overwrite an existing workspace config.
See also
- Configuration — every workspace.yml field
- Multi-agent teams — coordinate the agents in a layout
- Worktrees — one branch per agent
Plugins
Add commands to the tmux-ide palette and CLI with Lua plugins: the worktree tasks example, what consent covers, and what each capability allows.
tmux agent sidebar and status bar
A tmux status bar and sidebar for coding agents: tmux-ide adopt adds live agent status glyphs, prefix keys, menus and alerts to plain tmux sessions.