CLI

Install the public alpha package with Node.js 18.18 or newer. The package includes the argos CLI, Codex adapter, bootstrap, bounded reader, hooks, and verifier.

npm install --global @argosbyaurevon/codex-apply-patch-adapter@alpha
argos --help

Purpose: create the short-lived human session used for provisioning and REVIEW decisions.

argos login

Automatic behavior: browser OAuth with explicit consent, PKCE S256, state and signed identity validation, and an existing organization-access check. The callback uses 127.0.0.1:43123; an occupied port fails closed. Use argos logout to remove local human credentials without changing browser sessions or agent keys.

Purpose: bind the current Git repository to the existing Argos alpha control path.

cd /path/to/repository
argos init

Automatic behavior: repository detection; project, agent, workflow, and scoped-key provisioning; isolated Codex configuration; readiness plan; hook smoke test; and verifier availability check.

Initialization is idempotent and stores its configuration outside the repository. It guarantees no repository file changes during successful initialization.

Purpose: freeze a Task contract, launch controlled Codex, collect human decisions, and run independent verification when Codex exits.

argos run \
  --objective "Add password reset rate limiting." \
  --expected "src/auth/password-reset/**" \
  --review "src/shared/**" \
  --protected "src/auth/session/**"

The CLI detects existing typecheck, test, lint, and build package scripts and includes them in the frozen deterministic plan. Required checks that cannot run prevent VERIFIED.

Secrets and adapter state remain outside the Git repository. Do not commit or copy this directory into a project.