> ## 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 receipt add

> Record a local action claim.

```bash theme={null}
agentlinkops 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>Check the selected environment and workspace access before calling hosted operations. See [capability status](/capability-status).</Note>