Skip to main content
Push selected intentions and pull cloud history. The default run pushes expected ledger entries and pulls cloud history. Start with --dry-run; use --pull-only when you intend only to read and save hosted history.

​
Example

Prints the proposed uploads with network:false. It leaves cloud and local records unchanged.

​
Options

  • --push-only and --pull-only are mutually exclusive. --recover-cursors requires --pull-only and performs cloud reads only
  • it does not change permissions. --dry-run prints {network:false,rows:[…]} with no network. --include-wanted adds wanted entries to push. --lifecycle requires a pull and cannot be combined with --push-only.

​
Exit status

0 on success; 2 on usage, configuration, input or request failure.
By default sync pushes expected entries and pulls placement and target event feeds. --include-wanted adds wanted entries to push. A saved ledgerIds selection limits push.Pull saves observations, events and a separate cursor for each feed. Expired history records a gap and a current-state snapshot.Use --pull-only --recover-cursors after an invalid cursor refusal: sync reads complete snapshots under the configured project and current credential, then replays retained events. It saves snapshots for each recovered feed and retains earlier evidence.It reports denied reads and leaves the authored ledger unchanged. With --lifecycle, it pulls scoped deal snapshots into state.lifecycle after recovering hosted ledger references.It refuses ambiguous mappings or incomplete recovery reads.
Using the saved connection and current project grant, reads complete recovery snapshots and retained events, then saves their local mirror and independent feed cursors. Denied reads stop recovery; it does not broaden access or replay remote writes.
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.