Each AI provider has unique capabilities and limitations. Maestro adapts its UI based on what each provider supports.Documentation Index
Fetch the complete documentation index at: https://docs.runmaestro.ai/llms.txt
Use this file to discover all available pages before exploring further.
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-20250514to specify a particular model - Codex:
-m o3to use a specific OpenAI model - OpenCode:
--model anthropic/claude-sonnet-4-20250514to 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_DIRfor multiple Claude accounts) - 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 |
| Mid-turn input | ❌ Batch mode only (details) |
- Claude Code’s TUI supports injecting user messages mid-turn (between tool calls in its agentic loop), but this is not available in batch mode (
--print). Maestro uses batch mode, so new messages are queued and sent after the current turn completes via--resume. This is a limitation of the CLI’s batch interface, not Maestro.
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) |
- Codex’s
resumesubcommand doesn’t accept the-i/--imageflag. 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 inexecmode 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 |
- OpenCode uses the
runsubcommand which auto-approves all permissions (similar to Codex’s YOLO mode). Maestro enables this via theOPENCODE_CONFIG_CONTENTenvironment variable.