Documentation Index
Fetch the complete documentation index at: https://docs.archal.ai/llms.txt
Use this file to discover all available pages before exploring further.
Commands grouped here don’t run agents; they inspect existing runs, sessions,
and account state. Every exit code follows the same contract: 0 on success,
non-zero on error.
archal trace
Fetch scenario traces from the Archal control plane (api.archal.ai). This is
a remote lookup — requires archal login or ARCHAL_TOKEN — and returns only
traces you own. It is not a local-cache reader; local artifacts live under
.archal/cache/ and are inspected with cat/jq, not this command.
archal trace # list your most recent 20 traces from the API
archal trace --limit 5 # list the most recent 5
archal trace <name> # show one trace in detail (by the name shown in the listing)
| Flag | Description | Default |
|---|
-n, --limit <count> | Number of traces to list | 20 |
archal trace <name> to see the
detail view, which adds scenario title, error count, and a numbered event
list of span tool calls (relative timestamp, twin.tool, and a short
output-or-error summary capped at 80 chars). A 401/403 from the API means
your token is missing or scoped to a different user.
archal inspect session <id>
Print a hosted session as JSON: resolved services, seeds, TTL, twin URLs, and
worker status. Useful when debugging a CI failure against a specific session
id from the dashboard.
archal inspect session ses-01hxyz...
archal inspect run <id>
Print a managed run bundle as JSON — the run’s scenario, criteria, per-run
scores, and trace metadata.
archal inspect run run-01hxyz...
archal export run <id>
Export the full artifact bundle for a run, including every tool call and state
snapshot, as a single JSON document. Pipe to a file when you want a portable
record or want to share a failing run.
archal export run run-01hxyz... > run.json
archal export run run-01hxyz... --anonymize > run.json
| Flag | Description |
|---|
--anonymize | Redact sensitive evidence payload fields before writing |
archal usage
Print your account’s session-minutes usage for the current billing period and
current plan.
archal doctor
Probe the active twin session end-to-end: reachability, auth, URL resolution,
and tool surface per twin. Use this first when “nothing works”.
archal doctor
archal doctor --twin github # probe a single twin
archal doctor --json # machine-readable output for scripts
| Flag | Description |
|---|
--twin <name> | Probe a single twin by id (defaults to all twins in the active session) |
--json | Emit diagnosis as JSON |
