Skip to main content
Record a local action claim. This writes a local claim and may add a ledger entry. Use an actual action timestamp and a matching placement; a claim does not prove acquisition.

​
Example

Validates the supplied claim and writes its receipt and any needed ledger entry. The result remains a claim until supported by independent observations.

​
Options

--file CLAIM.json required.

​
Exit status

0 on success; 2 on usage, configuration, input or request failure.

​
What happens

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