maestro-frontier

Drive the Maestro Frontier engine: a local multi-CLI fusion engine where a parallel panel feeds a judge and grounded synthesis. When a user asks to compose or choose a model panel, route the request to frontier compose after consulting frontier catalog; never guess a model or preset ID.

When the trusted Maestro Codex plugin hook is installed, arming a non-off mode makes normal later Codex prompts auto-run through Frontier. run remains an advanced, manual one-off. Do not edit Frontier state files by hand.

Command launcher

Use maestro when it is on PATH. If it is not, and this skill is loaded from the Maestro Codex plugin, locate the plugin root by walking up from this SKILL.md until .codex-plugin/plugin.json is present, then run:

node "<maestro-plugin-root>/bin/maestro.cjs" frontier ...

In the examples below, maestro frontier ... means either the bare command or that plugin-root launcher.

Catalog and compose a panel

Use project scope from the repository root for state-changing commands:

maestro frontier catalog
maestro frontier catalog --json
maestro frontier compose --models <model>,<model> --dry-run --scope codex-project
maestro frontier compose --models <model>,<model> --judge <model> --synth <model> --effort <level> --scope codex-project
maestro frontier compose --models <model>,<model> --save <name> --scope codex-project
maestro frontier effort <auto|low|medium|high|xhigh|max|ultra> --scope codex-project

frontier catalog is the source of truth for models, presets, aliases, readiness, and required configuration. compose accepts one to eight comma-separated models. Judge and synth default to the first panel model. --dry-run changes nothing; a non-dry run saves and arms the resolved custom fusion panel. --effort persists one validated level across panel, judge, and synth stages for selected effort-aware Claude and Codex models. effort auto returns the armed panel to provider defaults.

Modes, inspection, and saved presets

maestro frontier mode off --scope codex-project
maestro frontier mode single --model <model> --scope codex-project
maestro frontier mode fusion --preset <preset> --scope codex-project
maestro frontier mode fusion --preset custom --models <model>,<model> --scope codex-project
maestro frontier status --scope codex-project
maestro frontier roster
maestro frontier preset save <name> --models <model>,<model> --judge <model> --synth <model> --scope codex-project
maestro frontier preset list --scope codex-project
maestro frontier preset delete <name> --scope codex-project

Use catalog before selecting any model or preset. roster reports only readiness and configuration names, never secret or configured model values.

Current models, overrides, and release gate

opus pins Claude Opus 5.5 (claude-opus-5-5), fable pins Fable 5.1 (claude-fable-5-1), sonnet-5 keeps Sonnet 5 (claude-sonnet-5), and haiku adds Haiku 4.5 (claude-haiku-4-5-20251001). Claude Code v2.1.280+ is required for Opus 5.5; v2.1.257+ is required for Fable 5.1. Opus, Fable, and Sonnet support low, medium, high, xhigh, and max; Haiku has no effort flag. Codex selectors include astra (gpt-6-astra), sol (gpt-6-sol), terra (gpt-5.6-terra), and luna (gpt-6-luna), plus auto-review and the retained GPT-5.5, GPT-5.4, GPT-5.4 Mini, and GPT-5.3 Codex Spark selectors. GPT-6 models support low, medium, high, xhigh, and max in Maestro’s UI, without none or ultra. Earlier explicit selectors and third-party adapters remain available. Use frontier catalog for exact aliases and supported effort levels. MAESTRO_FRONTIER_MODEL_TERRA, MAESTRO_FRONTIER_MODEL_LUNA, and MAESTRO_FRONTIER_MODEL_SOL remain optional model-ID overrides. Codex Desktop / IDE sessions read those overrides from ~/.codex/.env; restart the app and open a new thread after changing it.

Before releasing Codex catalog changes, probe every first-party Codex selector:

node frontier/smoke.cjs

This explicit release gate invokes those selectors through the normal read-only dispatch path.

Normal and debug use

After mode is non-off, use ordinary Codex prompts; the trusted hook supplies the Frontier result. Turn it off or run one manual prompt with:

maestro frontier mode off --scope codex-project
maestro frontier run "<prompt>" --scope codex-project

All panel, judge, and synthesizer subprocesses are one-shot and read-only: they return text only and never edit the workspace, commit, or run autonomous loops. On ERROR [<reason>]: <detail>, relay the reason.

Indicator instruction

Before composing your first reply each turn, run:

maestro frontier status --scope codex-project

Parse the returned JSON mode field:

• If mode is not off, make the first line of your reply exactly: Maestro Frontier ON (<label>) where <label> is single - <model> or fusion - <preset>; for a custom preset use fusion - custom (<model1>, <model2>, ...).
• If mode is off, output no indicator line.