Provider CLI
Supported provider CLIs, shared runtime behavior, and extension points.
Provider CLI
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 CLI | Provider value | Protocol | Session resume | Agent steering | Mopheus-managed MCP | Skill path | Filesystem sandbox |
|---|---|---|---|---|---|---|---|
| Claude Code | claude | Native | Yes | Active-turn | Yes | .claude/skills/ | Yes |
| Codex | codex | Native | Yes | Active-turn | Yes | .codex/skills/ | Yes |
| KimiCode | kimi-code | Native | Yes | None | No | .kimi/skills/ | Yes |
| OpenCode | opencode | Native | Yes | None | Yes | .opencode/skills/ | Yes |
| MimoCode | mimo-code | Native | Yes | None | Yes | .mimocode/skills/ | Yes |
| Hermes | hermes | ACP | Yes | Next-turn | Yes | .hermes/skills/ | Yes |
| Pi | pi | Native | Yes | None | No | .pi/skills/ | Yes |
| Antigravity | antigravity | Native | Yes | Next-turn | No | .agents/skills/ | Yes |
Interaction delivery references
- Codex: active-turn
turn/steer. - Claude Code: CLI reference; supports active-turn steering with next-turn fallback.
- ACP and custom ACP CLIs: ACP v2 prompt lifecycle proposal; use next-turn delivery unless a provider explicitly advertises stronger support.
- Antigravity: stream-json line protocol; supports next-turn interactions.
- Native CLIs reporting
noneand without transcript interactions: OpenCode, Kimi Code, MiMo Code, and Pi.
Provider Guides
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.