Skip to content
Browse documentation
Controlled alphaValidatedClaude Code / Cursor · In development

Argos developer documentation

OpenAI Codex

Use the live-validated Codex CLI 0.157.1 controlled apply_patch workflow.

Support status

OpenAI CodexValidated

This exact controlled path passed live acceptance for supported existing-file, single apply_patch operations.

Connect

bash
argos login
argos init

Initialization creates the isolated Codex configuration and validates Codex CLI 0.157.1.

Supported boundary

Before mutation
One existing-file Update File in apply_patch.
After mutation
Repository evidence records the result; permission alone is not execution evidence.
Unsupported
Creation, deletion, rename/move, multi-file patches, shell, network, MCP and subagents.

First Guarded Task

bash
argos start
# Keep this terminal open. In a second terminal:
argos run --tracking-session <session-id>

The run collects the goal, expected/review/protected paths and verification-criteria paths. Use repository-relative paths only.

Disconnect

Codex uses the isolated initialization path. Stop the active tracking session with argos stop --session-id <session-id>; stopping does not delete configuration or evidence.

Troubleshooting

  • Install and authenticate Codex CLI 0.157.1 before initialization.
  • Run argos init again from the intended Git worktree if the isolated Codex configuration is missing.
  • Malformed, unknown or escaping mutation targets are denied.
  • If REVIEW times out, inspect the Task and start a new bounded run rather than bypassing the hook.