Provider CLI
Supported provider CLIs, maturity levels, shared runtime behavior, and extension points.
A provider CLI is the program that executes an agent task, such as Claude Code or Codex. Mopheus discovers the CLI on the daemon host, dispatches tasks to it, and collects the result.
Supported Provider CLIs
Provider CLIs are ranked by maturity and integration depth in Mopheus:
| Provider CLI | Provider value | Protocol | Session resume | Agent steering | Mopheus-managed MCP | Skill path | Filesystem sandbox | Maturity |
|---|---|---|---|---|---|---|---|---|
| Claude Code | claude | Native | Yes | Active-turn | Yes | .claude/skills/ | Yes | Core (5★) |
| Codex | codex | Native | Yes | Active-turn | Yes | .codex/skills/ | Yes | Core (5★) |
| Antigravity | antigravity | Native | Yes | Next-turn | No | .agents/skills/ | Yes | Native (4★+) |
| Pi | pi | Native | Yes | None | No | .pi/skills/ | Yes | Native RPC (4★) |
| OpenCode | opencode | Native | Yes | None | Yes | .opencode/skills/ | Yes | Available (3★) |
| KimiCode | kimi-code | Native | Yes | None | No | .kimi/skills/ | Yes | Available (2.5★) |
| MimoCode | mimo-code | Native | Yes | None | Yes | .mimocode/skills/ | Yes | Derivative (2★) |
| ACP-Compatible CLIs | acp | ACP | Yes | Next-turn | Yes | .<cli>/skills/ | Yes | Protocol standard |
Interaction delivery references
- Claude Code: CLI reference; supports active-turn steering with next-turn fallback.
- Codex: active-turn
turn/steerreal-time interaction. - Antigravity: stream-json line protocol; supports thinking block expansion and next-turn interactions.
- Pi: native JSON-RPC subprocess communication; independent session management and event sanitization.
- ACP and compatible ACP CLIs: ACP v2 prompt lifecycle proposal; use next-turn delivery, including Hermes, Kiro, Qoder, etc.
- Native CLIs reporting
none: OpenCode, Kimi Code, and MiMo Code.
Provider Guides
- Claude Code
- Codex
- Antigravity
- Pi
- OpenCode
- KimiCode
- MimoCode
- ACP-Compatible CLIs
- Custom aliases and ACP CLIs
Workspace-Scoped Session History
For Claude Code, Codex, and Pi, resumable session history is separated by workspace whether or not the filesystem sandbox is enabled. Some other providers use host-global history without the sandbox. The sandbox mounts only the current workspace's managed session data at the path expected by the CLI.
Credentials, global CLI preferences, plugins, and caches not listed in a provider guide remain owned by the daemon user and are not copied into a workspace. Existing host-global session history is not migrated automatically.
See Filesystem Sandbox for the visibility boundary and read-only filesystem rules.
Auto-Discovery
At startup, the daemon probes built-in provider commands through their path-override environment variables and $PATH, then reads --version when possible. A new CLI installed while the daemon is running is detected during the next workspace sync cycle, normally within 30 seconds.
Extending Providers
Use Custom Provider CLI to clone a built-in provider or register an ACP-compatible CLI. Run mopheus provider list to inspect built-in and custom entries.