Codex
Run Mopheus agent tasks with the OpenAI Codex CLI.
Codex
Mopheus runs the OpenAI codex CLI as a native provider. Install it on the machine that runs the Mopheus daemon; the daemon discovers it and registers a Codex runtime automatically.
Runtime
| Field | Value |
|---|---|
| Binary | codex |
| Path override | MOPHEUS_CODEX_PATH |
| Verify | codex --version |
| Protocol | Native |
| Interaction delivery | Active-turn steer, with next-turn fallback |
| Mopheus-managed MCP | Supported |
| Task skill path | .codex/skills/ |
| Filesystem sandbox | Supported on Linux |
An agent whose provider value is codex is dispatched to this runtime. For a binary outside $PATH:
export MOPHEUS_CODEX_PATH=/opt/openai/bin/codex
mopheus daemon startSessions and sandbox
Mopheus keeps Codex resumable session history workspace-scoped, including when the filesystem sandbox is disabled. Credentials, global CLI preferences, plugins, and other host-global data remain owned by the daemon user and are not copied into a workspace. Existing host-global session history is not migrated automatically.
On Linux, the optional filesystem sandbox provides the outer filesystem boundary with bwrap. Mopheus disables Codex's inner sandbox for that task so the two sandbox implementations do not nest.