ait remote — Complete Reference
Register and list remote authorities or reconstruct a local Line head from an exact remote Repository authority.
Audience: Repository owners and recovery operators
Operating boundary#
Purpose: Register and list remote authorities or reconstruct a local Line head from an exact remote Repository authority.
Effect class: Registration and applied recovery mutate state; recovery without its apply flag is a preview.
Coverage: 4 public help surfaces under ait remote.
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 remote
ait remote add
ait remote list
ait remote recover-headExact emitted help#
ait remote#
Binary description: Manage server endpoints and recover the canonical remote main head.
Manage server endpoints and recover the canonical remote main head.
Usage: ait remote <COMMAND>
Commands:
add Register a remote using the canonical Repository directory name.
list List configured remotes without contacting their servers.
recover-head Preview or atomically rebuild the exact remote main head and its full Snapshot ancestry.
help Print this message or the help of the given subcommand(s)
Options:
-h, --help Print helpait remote add#
Binary description: Register a remote using the canonical Repository directory name.
Register a remote using the canonical Repository directory name.
Usage: ait remote add [OPTIONS] <NAME> <URL>
Arguments:
<NAME> Local name used to select this remote.
<URL> Base URL of the AIT server.
Options:
--default Use this remote by default for both push and pull.
--json Emit the complete machine-readable JSON result.
-h, --help Print helpait remote list#
Binary description: List configured remotes without contacting their servers.
List configured remotes without contacting their servers.
Usage: ait remote list [OPTIONS]
Options:
--json Emit the complete machine-readable JSON result.
-h, --help Print helpait remote recover-head#
Binary description: Preview or atomically rebuild the exact remote main head and its full Snapshot ancestry.
Preview or atomically rebuild the exact remote main head and its full Snapshot ancestry.
Usage: ait remote recover-head [OPTIONS]
Options:
--remote <NAME> Read from this remote; otherwise use the configured default remote.
--jobs <JOBS> Use this many parallel pack downloads (1 through 64). [default: 8]
--apply Activate the reconstructed generation; omission performs a read-only preview.
--json Emit the complete machine-readable JSON result.
-h, --help Print help