Files
Maestro/docs/provider-nuances.md
Pedram Amini 27677f596d docs: improve Mintlify documentation quality and consistency
- Fix logo/favicon paths (build/ → assets/) and copy icons to docs/assets/
- Add page-level metadata (description, icon) to all 19 documentation pages
- Fix broken numbered list formatting in about/overview.md
- Embed YouTube walkthrough videos in index.md
- Standardize terminology: Agent (Maestro workspace), Provider (Claude/Codex/OpenCode), Session/Tab (conversation)
- Update Key Concepts table with clear definitions
- Redistribute screenshots to relevant pages (git, keyboard shortcuts, general usage)
- Transform screenshots.md into Themes Gallery page
- Add git diff/logs screenshots to git-worktrees.md
- Add command palette screenshot to keyboard-shortcuts.md
- Add session management screenshot to general-usage.md

Claude ID: ad65a8b7-fc6f-4ebc-86be-ec86f66a0120
Maestro ID: b9bc0d08-5be2-4fdf-93cd-5618a8d53b35
2025-12-27 03:05:48 -06:00

1.8 KiB

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

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

Claude Code

Feature Support
Image attachments New and resumed sessions
Session resume --resume flag
Read-only mode --permission-mode plan
Slash commands /help, /compact, etc.
Cost tracking Full cost breakdown
Model selection --model flag (via custom CLI args)

OpenAI Codex

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

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, /undo, /diff, 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 investigated
Cost tracking Per-step costs
Model selection --model provider/model

Note: OpenCode uses the run subcommand which auto-approves all permissions (similar to Codex's YOLO mode).