Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.opencoven.ai/llms.txt

Use this file to discover all available pages before exploring further.

Codex is OpenAI’s coding-agent CLI. Coven wraps it in a project-rooted PTY so launches, attaches, and rituals work the same as for any other harness.
FieldValue
Harness idcodex
Installnpm install -g @openai/codex
Authcodex login (one-time, OpenAI side)
Doctor checkcoven doctor reports the resolved Codex path and version.

​
Setup

1

Install Codex

npm install -g @openai/codex
Other install methods (Homebrew cask, package managers) are listed at the Codex repo.
2

Log in to OpenAI

codex login
Provider credentials stay with Codex. Coven never reads them.
3

Confirm with Coven

coven doctor
The output should include a line like codex: ok (/usr/local/bin/codex).
4

Launch

coven run codex "fix the failing tests"

​
Per-session flags

coven run codex "audit this repo" --cwd packages/cli --title "CLI audit"
  • --cwd — canonicalized inside the project root.
  • --title — sets a readable title in the session browser.
  • --json — print structured launch metadata for clients.

​
Provider auth boundary

Codex owns its own OAuth flow and token cache. If you see Invalidated OAuth token, run codex login again. Coven will keep the existing session record so you can re-launch with the same title. For the local rescue path: 
coven patch openclaw "fix Codex auth profile order after invalidated OAuth token"

​
Troubleshooting

SymptomLikely causeFix
coven doctor reports codex missingCodex not on PATHnpm install -g @openai/codex, then re-run doctor.
Codex prompts for login each runStale tokencodex login.
Session hangs at startCodex waiting on TTY promptDetach with Ctrl-], re-launch with coven run directly.