HarnessesCodex Harness
Codex Harness
Codex harness deep dive: setup, provider auth, launch arguments, project-root behavior, and troubleshooting.
1 min read
Codex is OpenAI's coding-agent CLI. Coven launches it as a project-rooted PTY and records the run as a Coven session.
| Field | Value |
|---|---|
| Harness id | codex |
| Executable | codex |
| Install | npm install -g @openai/codex |
| Provider auth | codex login |
| First run | coven run codex "fix the failing tests" |
Setup
npm install -g @openai/codex
codex login
coven doctorcoven doctor checks that codex is available on PATH. It does not read Codex's OpenAI credentials.
Launch
coven run codex "audit this repo" --cwd packages/cli --title "CLI audit"In interactive terminals, Coven launches Codex with the prompt as the final argument. In non-interactive mode, Coven uses Codex's exec --skip-git-repo-check --color never shape so output is easier to capture.
Supervision flow
Rendering diagram…
Common failures
| Symptom | Likely cause | Fix |
|---|---|---|
coven doctor reports Codex missing | codex is not on daemon PATH | Install Codex, restart daemon, rerun doctor. |
| Codex asks for login | OAuth state expired or missing | Run codex login. |
| Launch rejects cwd | --cwd escapes the project root | Use a cwd inside the project. |
For shared setup rules, see Install harness CLIs and Provider auth boundary.
Was this page helpful?No
Last updated on