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

Argos developer documentation

Troubleshooting

Resolve likely failures in the current controlled alpha.

Agent or hooks not connected

Codex missing
Install and authenticate Codex CLI 0.157.1, then run argos init from the intended Git worktree.
Codex boundary missing
Run argos init again from the intended Git worktree. Conflicting configuration fails closed.
Stale project
Run argos init from the intended Git worktree and confirm the selected project.
Claude Code / Cursor
No setup or disconnect command is supported for these adapters in this release.

Contract and REVIEW

Invalid contract
Use normalized repository-relative paths; remove absolute paths and traversal.
Unexpected REVIEW
Compare the path to frozen expected scope. Allow once only if intended.
Protected blocked
A stronger policy won; do not weaken or bypass the hook.
Approval timeout
The mutation remains withheld. Inspect state and begin a new controlled Task.

UNCERTAIN is not failure

Check criteria paths, executables, concurrent writers, post-tool observations and repository stability. Never relabel uncertainty as success.