Codex CLI

Codex gives the model full tool access by default. Statewright constrains it per workflow phase: read-only during planning, edit tools during implementation, designated test commands during testing. Enforcement happens at the hook layer, not via prompts.

0.3.0 candidate

The current 0.3.0 candidate adds per-state model and reasoning routing for managed Codex sessions. A route is applied at an authoritative Statewright boundary by restarting the managed child and resuming the same thread; it is not an in-turn model hot swap. Native Codex token totals are reported through the telemetry path, while per-tool attribution is an estimate.

Install (Marketplace)

codex plugin marketplace add statewright/statewright
codex plugin add statewright --marketplace statewright

The plugin is dormant until you activate a workflow. It won't interfere with normal Codex usage.

Usage

statewright_load_workflow(name='bugfix')

Once active, the hooks inject phase context into every turn and block tools that don't belong in the current state. Try to call edit during planning and you'll see:

PreToolUse hook (blocked)
  feedback: Tool 'edit' is not available in the 'planning' phase.
  Allowed: read_file, grep. To advance, use statewright_transition with: READY.

Manual install (without marketplace)

Get an API key at statewright.ai/keys

Save it:

mkdir -p ~/.statewright
echo 'sw_live_...' > ~/.statewright/api_key

Clone the repo and add the MCP server:

git clone https://github.com/statewright/statewright.git
codex mcp add statewright -- bash ~/statewright/plugins/codex/mcp-proxy.sh

Codex won't pass your env vars through to MCP servers it spawns. Add env_vars so the proxy can authenticate:

# In ~/.codex/config.toml
[mcp_servers.statewright]
command = "bash"
args = ["~/statewright/plugins/codex/mcp-proxy.sh"]
env_vars = ["STATEWRIGHT_API_KEY", "STATEWRIGHT_GATEWAY_URL"]

Without env_vars, the proxy falls back to reading ~/.statewright/api_key from disk (which works fine for single-gateway setups).

Create or edit ~/.codex/config.toml to enable hooks:
```
[features]
hooks = true
```
Copy hooks.json to ~/.codex/hooks.json (or merge into existing if you have other hooks)

Also works with Oh My Codex

Oh My Codex uses the same .codex/hooks.json format, so this plugin works unmodified. A dedicated OMX plugin with TypeScript hooks is available for deeper integration.

Source

plugins/codex/

Codex CLI

Codex CLI

0.3.0 candidate

Install (Marketplace)

Usage

Also works with Oh My Codex

Source

On this page