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

> Copy local epoch summaries to a hosted project.

```bash theme={null}
agentlinkops citation sync [--dir DIR] [--evidence]
```

## Behavior and output

Requires an existing cloud connection and project. Uploads epoch summaries in batches of at most 100 rows. Immutable epoch/cell replays deduplicate; conflicts fail. With --evidence, the command uploads exact local answer envelope bytes with their hashes in bounded batches. Screenshot metadata is included when available, but image bytes remain local. Hosted raw envelopes expire after 30 days; replays do not extend retention.

Before sending any raw-evidence batch, the CLI verifies each envelope against its observation identity and retained digest. Changed content, extra fields, duplicate JSON properties and conflicting references stop raw-evidence upload. Historical local digests follow the original writer convention before schema defaults and the screenshot filename; the upload checksum covers the exact stored envelope bytes. The historical digest does not authenticate screenshot pixels. The CLI can hash the current local image for screenshot metadata without uploading that image. Browser [egress journals](/reference/local/citation-run) remain local and do not enter this upload.

## Arguments

\--dir DIR; --evidence opts into retaining local answer envelopes in the hosted project.

## Exit status

0 when every batch succeeds; 1 when a batch fails; 2 on configuration or local-file 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>