Developer Docs
Quickstart
Browse documentation
AlphaCodex 0.143Public npm alpha

Argos developer documentation

Quickstart

Install the public alpha CLI, authenticate once, initialize a Git repository, and start controlled Codex.

Prerequisites

  • Node.js 18.18 or newer and npm.
  • Git and a repository with at least one committed file.
  • Codex CLI 0.143.0.
  • An invited Argos account.

Install the CLI

Install the current public alpha package globally. The alpha tag identifies the CLI release tested with Codex 0.143.0.

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

Authenticate

The CLI opens Argos in your browser. Sign in if necessary, then explicitly authorize Argos CLI. OAuth PKCE and a state-checked loopback callback return the session to the terminal without copying credentials. Human session credentials are stored outside the repository under ~/.argos.

bash
argos login
bash
Opening Argos in your browser...
Waiting for authorization...
Authorized
Logged into Argos as you@example.com

Initialize the repository

  1. Change into the committed Git repository.
  2. Run argos init.
  3. Complete the isolated Codex login if prompted.
  4. Continue only after the control-boundary confirmation appears.
bash
cd /path/to/repository
argos init
bash
ARGOS CONTROL BOUNDARY ACTIVE
Repository initialized in 4.2s. No repository files changed.

Argos derives the repository root and creates or reuses its project, Codex agent, integration channel, scoped execution credential, isolated CODEX_HOME, state directory, and hook paths.

Run a controlled Task

Declare the objective and repository-relative path scopes. Omit the flags to answer the same questions interactively.

bash
argos run \
  --objective "Add password reset rate limiting." \
  --expected "src/auth/password-reset/**" \
  --review "src/shared/**" \
  --protected "src/auth/session/**"
bash
ARGOS CONTROL BOUNDARY ACTIVE
Starting controlled Codex.

Task VERIFIED
required_outcome: passed
typecheck: passed
focused_tests: passed
Controlled mutations: 1
Human interventions: 0
Protected blocks: 0
Task: https://your-argos-host.example/app/tasks/<run-id>
Evidence: https://your-argos-host.example/app/evidence/<evidence-id>