Codex

Hooks into Codex's event system and enables codex_hooks for you. No code changes.

1. Get an API key

Sign in to Staso and create a key under Settings -> API Keys. Export it:

export STASO_API_KEY=ak_...

2. Install and set up

pip install staso
staso setup --target codex

The wizard prompts for workspace, environment, agent name, and Guard. Pass --api-key, --scope, etc. to skip the prompts — see CLI reference.

3. Run Codex

Open the Staso dashboard — your next session shows up as a trace.

What it captures

SessionStart, UserPromptSubmit, PreToolUse, PostToolUse, Stop.

Guard

Guard is on by default. Tool calls are evaluated on PreToolUse and can be blocked, modified, or escalated. Disable with --no-guard.

Keep hooks current

staso sync --target codex

Or pass --auto-sync once and forget about it.

Uninstall

staso uninstall --target codex

Next

• Claude Code quickstart
• Guard
• Self-Heal