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

> Add a placement intention to the ledger.

```bash theme={null}
linktrail add --source https://publisher.example.com/post --target https://example.com/guide
```

## Behavior and output

Prints the new lk\_ identifier. Duplicate source, target and scope combinations fail. This command records intent without checking the page. Wanted defaults to weekly cadence, expected to daily, and retired has no default cadence.

## Arguments

\--source URL and --target URL required; --intent wanted|expected|retired defaults to wanted; --scope exact|domain|subdomain|path defaults to exact; --anchor TEXT; --rel comma,separated; --cadence daily|weekly|monthly or 3600..2592000 seconds; --ref TEXT; repeat --tag TEXT; --note TEXT.

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