CLI reference

Binary: aq. On a TTY, bare aq (or aq agent) opens the agent chat. Without a TTY, bare aq prints help. After TypeScript changes in a checkout: cd aq && npm run build.

Prerequisiteaq installed · cwd is usually a train folder

aq train

Fit the recipe. Writes checkpoints under artifacts/checkpoints/, appends artifacts/metrics.jsonl, and records a run. Live steps stream on stderr. Kernel IPC: artifacts/request.json → result.json.

Flag	Description
[dir]	Train directory (default cwd).

example

$aq train

aq eval [name]

Score probes in evals/. Humans own the gate. When recipe.eval.min_score is set, results are pass/fail; otherwise scores are reported without inventing a verdict. Writes artifacts/eval.json.

Flag	Description
[name]	Probe name. Omit to run all.
--ckpt <name>	Named checkpoint instead of last.

example

$aq eval

example

$aq eval holdout --ckpt last

aq checkpoint [--keep name]

List checkpoints, or name a copy of last under artifacts/checkpoints/.

Flag	Description
--keep <name>	Save a named copy of last.

example

$aq checkpoint --keep best

aq serve [prompt]

Generate from a checkpoint (methods that implement generate). Writes artifacts/serve.json.

Flag	Description
--ckpt <name>	Checkpoint to serve.
--max-tokens n	Max new tokens.
--temperature t	Sampling temperature.

example

$aq serve "hello" --max-tokens 32

example

cat artifacts/serve.json

aq diff [<a> <b>]

List run records under artifacts/runs/, or diff two run records.

example

$aq diff <run-a> <run-b>

aq tool [name]

List or run tools/<name>.{py,ts,js,sh}. Runs with cwd = train and AQ_TRAIN set.

Flag	Description
-- args	Pass-through args after --.

example

$aq tool

example

$aq tool summarize -- --limit 10

aq help

Short Unix-style help for the aq CLI.

example

$aq help