Maestro/docs/provider-notes.md at a0f104f58f29d491803a9f8c703bc80fc8ad84f7

mirror of https://github.com/jlengrand/Maestro.git synced 2026-03-10 08:31:19 +00:00

Files

Pedram Amini 798541cb4b Rename provider-nuances to provider-notes and add custom configuration docs

Add new Custom Configuration section documenting custom CLI arguments and
environment variables with screenshot. Rename navigation group to "Providers
& CLI" and reorder to list provider-notes first.

2026-02-04 13:14:17 -06:00

3.3 KiB

Raw Blame History

title, description, icon

title	description	icon
Provider Notes	Feature differences between Claude Code, Codex (OpenAI), and OpenCode providers.	puzzle

Each AI provider has unique capabilities and limitations. Maestro adapts its UI based on what each provider supports.

Custom Configuration

All providers support custom command-line arguments and environment variables. Configure these in Settings → Providers for each agent type.

Custom Arguments

Additional CLI arguments are appended to every call to the agent. Common use cases:

Claude Code: --model claude-sonnet-4-20250514 to specify a particular model
Codex: -m o3 to use a specific OpenAI model
OpenCode: --model anthropic/claude-sonnet-4-20250514 to configure the model

Environment Variables

Environment variables are passed to the agent process. Use these for:

API keys and authentication tokens
Configuration overrides (e.g., CLAUDE_CONFIG_DIR for isolated Claude configurations)
Provider-specific settings

The `MAESTRO_SESSION_RESUMED` variable is automatically set to `1` when resuming sessions—you don't need to configure this manually.

Claude Code

Feature	Support
Image attachments	✅ New and resumed sessions
Session resume	✅ `--resume` flag
Read-only mode	✅ `--permission-mode plan`
Slash commands	⚠️ Batch-mode commands only (details)
Cost tracking	✅ Full cost breakdown
Model selection	❌ Configured via Anthropic account
Context operations	✅ Merge, export, and transfer
Thinking display	✅ Streaming assistant messages

Codex (OpenAI)

Feature	Support
Image attachments	⚠️ New sessions only (not on resume)
Session resume	✅ `exec resume <id>`
Read-only mode	✅ `--sandbox read-only`
Slash commands	❌ Interactive TUI only (not in exec mode)
Cost tracking	❌ Token counts only (no pricing)
Model selection	✅ `-m, --model` flag
Context operations	✅ Merge, export, and transfer
Thinking display	✅ Reasoning tokens (o3/o4-mini)

Notes:

Codex's resume subcommand doesn't accept the -i/--image flag. Images can only be attached when starting a new session. Maestro hides the attach image button when resuming Codex sessions.
Codex has slash commands (/compact, /diff, /model, etc.) but they only work in interactive TUI mode, not in exec mode which Maestro uses.

OpenCode

Feature	Support
Image attachments	✅ New and resumed sessions
Session resume	✅ `--session` flag
Read-only mode	✅ `--agent plan`
Slash commands	❌ Not supported
Cost tracking	✅ Per-step costs
Model selection	✅ `--model provider/model`
Context operations	✅ Merge, export, and transfer
Thinking display	✅ Streaming text chunks