> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentlinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# agentlinkops citation run

> Run one fixed-sample AI-citation epoch over a prompt panel with dated evidence and a spend cap.

```bash theme={null}
agentlinkops citation run PANEL.json [--dir DIR] [--samples N] [--max-usd USD] [--engine NAME[:PROVIDER]] [--json]
```

## Behavior and output

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](/reference/local/citation-sweep) for freezing retained evidence and [sync](/reference/local/citation-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](/reference/local/configuration) before automating this command. Read [local file contracts](/reference/local/artifacts) for artifact fields. Browse the [local command index](/reference/local/index) for related commands.

<Note>Check the selected environment and workspace access before calling hosted operations. See [capability status](/capability-status).</Note>