> ## 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] [--json]
```

## Behavior and output

Reads a JSON panel (targets as domain or url with brand and aliases, prompts, engines as mock or perplexity with a model, optional samples and maxUsd), asks each engine each prompt the fixed number of times, and writes immutable content-addressed answer snapshots plus append-only observation and epoch rows under .agentlinkops/citations/ without touching the link ledger. Each cell reports a citation rate with a Wilson interval and its n, classified against the previous epoch as declined, grown or not\_distinguishable, or insufficient\_data when n is too thin; a citation is never reported as removed. The USD cap is checked before every call, so it can be approached but never exceeded; a budget abort leaves a partial-epoch receipt. The mock engine costs nothing; a live engine needs its environment credential (PERPLEXITY\_API\_KEY), whose presence doctor reports and whose value is never printed.

## 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); --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>