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) |
- 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 |
- OpenCode uses the
run subcommand which auto-approves all permissions (similar to Codex’s YOLO mode). Maestro enables this via the OPENCODE_CONFIG_CONTENT environment variable.
