Slash Commands

Common workflows in the composer — start a run, pause, switch model, view a diff, approve, export.

For the full list of slash commands, see Commands. This guide walks the workflows that actually use them.

Start a run

/run review the staged diff for regressions

The Agents panel populates as core spawns workers. The Timeline streams events. Watch the Header for transport: nominal and a non-empty model.

Pause and resume

/pause
/resume

/pause lets agents stop at the next safe point. Use it before you switch models or change permissions.

Switch the model mid-run

/model

Opens the Model Picker drawer. Pick a model and confirm. If the active permission mode gates change_model as ask, the change surfaces in the Approval drawer first.

Inspect a diff

/diff

Opens the Diff drawer with the most recent patch. Step through hunks; approve or reject if the run is gated.

Approve or reject pending tool calls

The Approval drawer surfaces gated requests automatically. From the composer, you can also use the Command Palette:

/help

Then search "Approval" to focus the drawer.

See Concepts → Approvals.

Switch permission modes

/permissions auto
/permissions approval

auto runs everything without asking; approval (the default) gates anything that touches the workspace. The change applies on the next /run — no restart required.

See Concepts → Permissions.

Check cost and usage

/cost

Per-agent and per-run breakdown. Crossed thresholds also appear in the Priority alerts strip.

Export the run

/export

Opens the Run Export drawer. Pick a format (JSON, JSONL, Markdown) and scope.

See Reference → Export.

Kill the run

/kill

Cancels the active run immediately. Agents are stopped; in-flight tool calls are interrupted.

Quit the cockpit

/quit

Or /exit, or double-tap Ctrl+C (single press is a soft-interrupt — see Reference → Keybindings).

Common pitfalls

Typing /run with no arguments — sends an empty task; you'll get an inline composer error.
Forgetting that /permissions is per-spawn — you set the mode now; it applies to the next /run.
Using q with a drawer open — q only quits when no drawer is open. While a drawer is open it's reserved for the drawer.
Pressing Ctrl+C once and walking away — that's a soft-interrupt, not a quit. Press it twice within 1500ms to exit.

Add your own commands

Custom commands are markdown prompt templates from project or user scope. The authoring format exists in the CLI runtime, but the running cockpit's active registry is still whatever /help shows.

Use project commands for repo workflows:

.agents/commands/review-staged.md
.agents/commands/release/notes.md

Use user commands for personal workflow shortcuts:

$MOGPLEX_HOME/commands/debug-failing-test.md

See Custom Slash Commands for frontmatter, arguments, aliases, template variables, precedence rules, and the current registry limitation.