ait pull — Complete Reference
Import a remote Line's Snapshot history, classify head relationships, and optionally materialize the selected result.
Audience: Developers and coding agents
Operating boundary#
Purpose: Import a remote Line's Snapshot history, classify head relationships, and optionally materialize the selected result.
Effect class: Imports local authority; merge and restore options can also change Line or workspace state.
Coverage: 1 public help surface under ait pull.
The blocks below preserve the RC.8 binary output in full, including every emitted argument, option, default, possible value, conflict, and requirement.
Complete command tree#
ait pullExact emitted help#
ait pull#
Binary description: Import the selected remote Line's reachable Snapshot chain and safely create or fast-forward its local Line. The configured default remote and current local Line are used when omitted. Workspace files remain unchanged unless --restore is supplied.
Import the selected remote Line's reachable Snapshot chain and safely create or fast-forward its local Line. The configured default remote and current local Line are used when omitted. Workspace files remain unchanged unless --restore is supplied.
Usage: ait pull [OPTIONS]
Options:
--remote <REMOTE>
Use this configured remote; defaults to the repository's default remote.
--line <LINE>
Import this remote Line and safely create or fast-forward its local Line; defaults to the current local Line.
--merge
Merge a divergent imported remote head into the current local Line and materialize the result; requires --restore and a clean workspace.
--restore
Materialize the pulled Line into the workspace and select that Line; rejected when the local Line is ahead of the remote.
--force
Allow --restore to overwrite local workspace changes; requires --restore and cannot be used with --merge.
--json
Emit the pull result as machine-readable JSON.
-h, --help
Print help (see a summary with '-h')