Skip to main content
These commands inspect existing runs, sessions, and account state. They do not run agents.

​
archal traces

Fetch scenario traces you own. Requires archal login or ARCHAL_TOKEN. 
archal traces                 # list your most recent 20 traces from the API
archal traces --limit 5       # list the most recent 5
archal traces <name>          # show one trace in detail by the name shown in the listing
FlagDescriptionDefault
-n, --limit <count>Number of traces to list20
The listing prints name, score, date, and spans. Pass a name to archal traces <name> to inspect one trace.

​
archal inspect session <id>

Print a hosted session as JSON: services, seeds, TTL, clone URLs, and health. 
archal inspect session ses-01hxyz...

​
archal inspect run <id>

Print a managed run bundle as JSON. 
archal traces --limit 5         # find the recent run or trace name first
archal inspect run run-01hxyz...

​
archal export run <id>

Export a run as a single JSON document. Pipe it to a file to share a failing run. 
archal inspect run run-01hxyz... # confirm the id before exporting
archal export run run-01hxyz... > run.json
archal export run run-01hxyz... --anonymize > run.json
FlagDescription
--anonymizeRedact sensitive evidence payload fields before writing

​
archal usage

Print current plan and usage. 
archal usage

​
archal doctor

Probe the active clone session: reachability, auth, URL resolution, and tool surface per clone. 
archal doctor
archal doctor --clone github      # probe a single clone
archal doctor --json              # machine-readable output for scripts
FlagDescription
--clone <name>Probe a single clone by id (defaults to all clones in the active session)
--jsonEmit diagnosis as JSON