Behavior and output
Reads a versioned JSON panel and writes answer envelopes undercitations/evidence/<epochId>/, plus citations-observations.jsonl and citations-epochs.jsonl at the selected ledger root. Select mock for an offline run; missing live credentials do not select it for you. Each cell reports known and unknown samples separately, a Wilson interval and a descriptive comparison with its prior epoch. Supplemental statistics remain local and do not imply lifetime coverage or a proven change date. The runner reserves estimated cost before calls and retries; a supplier overrun is recorded and stops subsequent calls. Budget aborts retain partial evidence. Locale support is engine-specific; unsupported combinations are refused. Browser measurement requires AGENTLINKOPS_PROXY_URL and does not fall back to a direct connection. An explicitly authorized diagnostic can use AGENTLINKOPS_BROWSER_EGRESS=direct-diagnostic with no proxy configured.
Starting with CLI 0.6.6, browser epochs save a separate journal at citations/egress/<epochId>.jsonl under the ledger root. It records lease hashes, meter readings, attempt status and cleanup uncertainty, up to 10,000 records and 8 MiB. The runner saves each attempt’s receipts before starting another and attempts cleanup after failures. It refuses an existing journal path and stops on a journal write failure. A missing or partial final record means incomplete evidence. The standard URL proxy has no meter: unknown cost stays null, and the journal supplies no epoch dollar total. Nominal browser estimates cannot cap a provider invoice. See sweep for freezing retained evidence and sync for optional hosted copies.
Arguments
PANEL.json required; —dir DIR (the .agentlinkops directory to write under, default ./.agentlinkops); —samples N overrides the panel’s sample count; —max-usd USD overrides the panel’s cap (overrides are echoed on stderr); —engine NAME[:PROVIDER] overrides the panel’s engine list (chatgpt:web-own-browser measures the consumer UI through the Camoufox browser engine; the API provider otherwise); —json prints the epoch receipt as JSON.Exit status
0 when every cell is grown, not_distinguishable or insufficient_data; 1 when a cell declined with complete evidence; 2 on usage, panel, credential or budget-abort failure. Read configuration and file ownership before automating this command. Read local file contracts for artifact fields. Browse the local command index for related commands.Check the selected environment and workspace access before calling hosted operations. See capability status.