> ## 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.

# linktrail receipt add

> Record a local action claim.

```bash theme={null}
linktrail receipt add --file claim.json
```

## Behavior and output

Requires kind internal|external, source, target, acted\_at timestamp with timezone and actor.role human|agent. Optional ledger links an existing matching entry; scope defaults to exact; intent\_after defaults to expected for internal and wanted for external. Optional expect, ref, tags, note, idempotency and report are preserved. report.state must be claimed. Internal hosts must belong to config.project.site. Writes receipts.jsonl and, when needed, a ledger entry through a recoverable receipt-transaction.json journal. Output is \{receipt,created}. Claims do not prove acquisition.

## Arguments

\--file CLAIM.json required.

## Exit status

0 on success; 2 on usage, configuration, input or request 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>Reference follows the current development CLI and HTTP contracts. Hosted availability depends on the selected environment. See [capability status](/capability-status).</Note>