Skip to main content
Run one fixed-sample AI-citation epoch over a prompt panel with dated evidence and a spend cap. Nominal browser estimates cannot cap a provider invoice.

​
Example

Runs the supplied panel with the explicit offline mock engine and writes local epoch evidence. Mock output is fixture evidence, not a live provider measurement.

​
Options

  • 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.
Reads a versioned JSON panel and writes answer envelopes under citations/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.
Read configuration and file ownership for environment variables, compatibility aliases and writer locks. Read local file contracts for artifact fields. Browse the CLI index for related commands.
Check the selected environment and workspace access before calling hosted operations. See capability status.