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

> Push selected intentions and pull cloud history.

```bash theme={null}
linktrail sync --dry-run
```

## Behavior and output

By default sync pushes expected entries and pulls both placement and target event feeds. --include-wanted opts wanted entries into push. A saved ledgerIds selection limits push. Pull writes observations/events and independent feed cursors; expired history records a gap and snapshot. Prints counts and failures.

## Arguments

\--push-only and --pull-only are mutually exclusive; --dry-run prints \{network:false,rows:\[...]} with no network; --include-wanted.

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