Skip to content
maestro
Esc
  • IntroductionWhat OMP Maestro is, what it installs, and which parts are Maestro's own code.
  • InstallationInstall Maestro with npx or bunx, pick skill libraries, log in to providers and give the router a key.
  • EnsemblesThe three model ensembles — mix, anthropic and openai — and every role they assign.
  • Jev RouterHow Maestro's router uses TypeSafe Jev for main-turn downgrades and subagent worker classes, and how it fails open.
  • SkillsThe skill libraries Maestro can install, who made them, and how to add your own.
  • CommandsEvery command Maestro adds, plus the omp and ponytail commands it leans on.
  • ConfigurationCustomise roles, fallback chains, ensembles and skill libraries — and what Maestro does and doesn't touch.
  • Troubleshooting & FAQFixes for common setup problems and answers to frequent questions.

Commands

Every command Maestro adds, plus the omp and ponytail commands it leans on.

Maestro adds two commands and one agent. Everything else on this page comes from omp or ponytail and is listed so you know where it lives.

/maestro

CommandWhat it does
/maestroShows the active ensemble — or custom if your roles don't match one exactly — and the choices.
/maestro mixClaude Opus orchestrates and plans, GPT Sol/Luna do the coding, Claude Sonnet does design and vision. The live session moves to the new lead.
/maestro anthropicClaude only: Opus thinks and plans, Sonnet codes, Haiku handles the small stuff. The live session moves to the new lead.
/maestro openaiChatGPT/Codex only: GPT-6.1 Sol thinks and codes, GPT-6 Luna handles the small stuff. The live session moves to the new lead.

Tab completion offers the ensemble names with their descriptions. A successful switch confirms with:

omp
Maestro: switched to "mix" — Claude Opus orchestrates and plans, GPT Sol/Luna do the coding, Claude Sonnet does design and vision

/jev-route

CommandWhat it does
/jev-routeSame as status.
/jev-route statusEnabled, verbose, key present, route counters, subagent counters and the last decision.
/jev-route onTurn routing on for this session.
/jev-route offTurn routing off for this session; a router-owned @smol turn returns to @default.
/jev-route verboseShow a notification for each main-turn routing decision.
/jev-route quietHide them again (the default).
/jev-route test <prompt>Dry-run the main-turn router on a prompt: Layer 0, Jev's scores, the route and why.
/jev-route test-task <task>Dry-run the subagent classifier: class, confidence, delegate probability and role.

On and off last for the current session; the router starts enabled. A dry run looks like this (scores are an example):

omp
/jev-route test Fix the typo in docs/getting-started.mdTEST: route=smol tier=economy/0.96 complexity=0.30/0.91 downgrade=0.95 impact=0.03 web=0.04 512ms — all conservative @smol downgrade gates passed/jev-route test Rotate the staging credentialsTEST: route=default 0ms — Layer 0: high-impact keyword guard

smart-commit agent

Maestro ships one agent definition, smart-commit. It runs the whole commit workflow on your @commit model with low thinking and only the read, bash and yield tools:

  1. Inspects the branch, upstream, status and diffs.
  2. Stops without committing on anything unsafe — merge conflicts, suspicious generated files, ambiguous unrelated changes, unusual submodules, unclear large binaries.
  3. Stages only the coherent logical change, reviews the staged diff, and writes a concise imperative subject (conventional commits if the repo uses them).
  4. Commits once and pushes — never amends, rewrites history, bypasses hooks or force-pushes.
  5. Reports the hash, subject, branch and push result.

Ask the lead to use it, or spawn it with omp's task tool.

From omp

/loginLog in to Anthropic and/or OpenAI Codex (ChatGPT plan).
/modelPick models; the Roles view changes any single role.
/vibeDirector mode — the lead only reads and directs; fast workers use @smol, good workers @task.

From ponytail

/ponytail switches on “lazy senior dev” mode from ponytail by Dietrich Gebert: the smallest complete change. See its repository for levels and options.