cli reference
One CLI, from capture to proof
Every command runs locally. Capture and recovery need a license; verification never does.
Capture
Install an adapter, run your agent, and seal the session.
| Command | What it does |
|---|---|
| axyvera adapters install <agent> | Install the capture adapter for an agent (project or global scope). |
| axyvera adapters list | Show installed adapters and their declared capabilities. |
| axyvera codex exec "…" | Run a Codex task with capture on; events are redacted and chained. |
| axyvera adapters finalize <agent> | Seal the current session and (with --export) write a .axy bundle. |
| axyvera sessions list | List captured sessions in the local vault. |
Evidence
Build, inspect, and verify signed bundles. Verification is free and license-independent.
| Command | What it does |
|---|---|
| axyvera bundle create | Build a signed .axy bundle from a captured session. |
| axyvera bundle inspect <file> | Print a bundle's manifest, coverage, and signer without verifying trust. |
| axyvera verify <file> | Verify a bundle: structure, content, signature, and coverage. |
| axyvera verify --json | Emit the verification result as JSON for CI. |
| axyvera verify --trust-key <key> | Check the signer against a specific trusted key. |
Recovery & license
Checkpoint work, inspect state, and roll back safely.
| Command | What it does |
|---|---|
| axyvera run -- <cmd> | Run a command inside a captured, recoverable checkpoint. |
| axyvera latest | Show the most recent captured state. |
| axyvera rollback latest --dry-run | Preview a rollback to a previous state before applying it. |
| axyvera license status | Report the current license state (and features it unlocks). |
A typical CI check
zsh — ci
$ axyvera verify ./artifact.axy --json {"signature":"valid","content":"intact","overall":"PASS"}