CLI

The binary is aqit. aquin is an alias with the same engine.

Install

Python 3.9+. GPU stack is optional except for LLM paths.

python3 -m venv .venv
source .venv/bin/activate
pip install -e .
aqit help

Shape

aqit <verb> [args]

aqit.cli.dispatch is a thin switch: AQIT verbs stay in this tree; everything else is forwarded to aquin.cli. Unknown verbs print Run aqit help.

Command map

Meta

Command	Job
aqit help	Rich help (model-aware)
aqit status	Loaded model + local engine
aqit version	Installed version
aqit license	Apache 2.0 text + acceptance

Develop

Command	Job
aqit train <recipe.yaml>	DataRevision → train → Checkpoint → EvalGate

Session

Command	Job
aqit load model <hf-id>	Load and keep resident in VRAM
aqit unload [--stop]	Free VRAM; --stop kills the daemon
aqit prompt <text>	Quick generation

Do not background load. The model stays resident across later commands.

Eval / check / inspect

Command	Job
aqit eval custom\|consistency\|suppress\|boundary	Probe suites
aqit check attention\|layer\|perturbation\|weight\|confidence\|trajectory	Health
aqit trace --prompt … --layer N	Causal / residual inspect
aqit diff weight\|sae\|residue --checkpoint <path>	Base vs checkpoint
aqit red-team	Adversarial probes
aqit benchmark --feature_idx N	Feature benchmarks

Most GPU tools accept --check (JSON + PNG in the current directory) and --json (machine-readable stdout).

SAE and features

Command	Job
aqit sae train\|align	Train or align sparse autoencoders
aqit info sae <id>	SAE metadata
aqit load sae <id>	Load catalog / user / path SAE
aqit feature locate\|logit\|neighbor	Feature tools
aqit activations capture\|replay	Activation store
aqit features compare	Compare captures

Patch

Command	Job
aqit steer --feature_idx N	Cheap intervention
aqit sweep	Strength grid
aqit multi-steer	Several features at once
aqit simulate	Forecast a train before GPU spend

Typical workflow

aqit train recipe.yaml
# if EvalGate FAIL:
aqit load model meta-llama/Llama-3.2-1B-Instruct
aqit eval custom --prompts probes.jsonl
aqit trace --prompt "Hello" --layer 8
aqit steer --feature_idx 42 --strength 2.0

Help and flags

• aqit help: full surface (aquin.help_display).
• aqit help commands: tracked subcommands and flags.
• --plain: ASCII, no color.
• --json: structured output where implemented.

Renamed verbs print the new spelling and exit 1, e.g. feature-logits → aqit feature logit.