ait line — Complete Reference
Inspect and manage Lines, switch or restore workspace state, merge recorded history, and clean eligible Line records.
Audience: Developers and coding agents
Operating boundary#
Purpose: Inspect and manage Lines, switch or restore workspace state, merge recorded history, and clean eligible Line records.
Effect class: Mixed read and local mutation surface; switch, restore, merge, create, rename, archive, and cleanup alter local state.
Coverage: 10 public help surfaces under ait line.
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 line
ait line list
ait line create
ait line switch
ait line show
ait line archive
ait line rename
ait line delete
ait line merge
ait line cleanupExact emitted help#
ait line#
Reference description: Inspect and manage Lines, switch or restore workspace state, merge recorded history, and clean eligible Line records.
The RC.8 binary emits no separate prose description for this surface; the sentence above is editorial context. The complete parser-provided usage and options follow unchanged.
Usage: ait line <COMMAND>
Commands:
list
create
switch
show
archive
rename Rename a line while preserving its stable identity and reconciling bound pointers.
delete Delete only a line ref after binding and unique-history protection checks.
merge Merge one Line into the current Line with resumable conflict state and a two-parent Snapshot.
cleanup Preview idle temporary Lines, or archive the admitted candidates with --yes.
help Print this message or the help of the given subcommand(s)
Options:
-h, --help Print helpait line list#
Reference description: List active or archived Lines in the selected local or remote view.
The RC.8 binary emits no separate prose description for this surface; the sentence above is editorial context. The complete parser-provided usage and options follow unchanged.
Usage: ait line list [OPTIONS]
Options:
--all
--archived
--remote <REMOTE>
--json
-h, --help Print helpait line create#
Reference description: Create a named Line, optionally from an exact Snapshot, and optionally switch or restore the workspace to it.
The RC.8 binary emits no separate prose description for this surface; the sentence above is editorial context. The complete parser-provided usage and options follow unchanged.
Usage: ait line create [OPTIONS] <NAME>
Arguments:
<NAME>
Options:
--from-snapshot <FROM_SNAPSHOT> Start the new Line at this Snapshot instead of the current Line head.
--switch Select the new Line without changing workspace files.
--json
-h, --help Print helpait line switch#
Reference description: Make a named Line current and optionally restore its recorded head into the workspace.
The RC.8 binary emits no separate prose description for this surface; the sentence above is editorial context. The complete parser-provided usage and options follow unchanged.
Usage: ait line switch [OPTIONS] <NAME>
Arguments:
<NAME>
Options:
--restore Materialize the selected Line head into the workspace.
--force Allow --restore to overwrite conflicting workspace changes.
--json
-h, --help Print helpait line show#
Reference description: Show the selected or current Line and its recorded state.
The RC.8 binary emits no separate prose description for this surface; the sentence above is editorial context. The complete parser-provided usage and options follow unchanged.
Usage: ait line show [OPTIONS] [NAME]
Arguments:
[NAME]
Options:
--json
-h, --help Print helpait line archive#
Reference description: Archive a named Line in the selected authority.
The RC.8 binary emits no separate prose description for this surface; the sentence above is editorial context. The complete parser-provided usage and options follow unchanged.
Usage: ait line archive [OPTIONS] <NAME>
Arguments:
<NAME>
Options:
--remote <REMOTE>
--json
-h, --help Print helpait line rename#
Binary description: Rename a line while preserving its stable identity and reconciling bound pointers.
Rename a line while preserving its stable identity and reconciling bound pointers.
Usage: ait line rename [OPTIONS] <OLD> <NEW>
Arguments:
<OLD>
<NEW>
Options:
--remote <REMOTE>
--json
-h, --help Print helpait line delete#
Binary description: Delete only a line ref after binding and unique-history protection checks.
Delete only a line ref after binding and unique-history protection checks.
Usage: ait line delete [OPTIONS] --yes <NAME>
Arguments:
<NAME>
Options:
--remote <REMOTE>
--yes
--json
-h, --help Print helpait line merge#
Binary description: Merge one Line into the current Line with resumable conflict state and a two-parent Snapshot.
Merge one Line into the current Line with resumable conflict state and a two-parent Snapshot.
Usage: ait line merge [OPTIONS] [SOURCE]
Arguments:
[SOURCE]
Options:
--message <MESSAGE>
--continue
--abort
--json
-h, --help Print helpait line cleanup#
Binary description: Preview idle temporary Lines, or archive the admitted candidates with --yes.
Preview idle temporary Lines, or archive the admitted candidates with --yes.
Usage: ait line cleanup [OPTIONS]
Options:
--idle-for <IDLE_FOR> Minimum time since the Line's last activity, such as 7d, 12h, or 30m. [default: 7d]
--kind <CLEANUP_KIND> Restrict cleanup to review_base, review, or wip Lines.
--limit <LIMIT> Select at most this positive number of oldest candidates.
--include-protected Include non-candidates and their protection reasons in the result.
--all Show every selected row; protected rows still require --include-protected.
--yes Archive the admitted candidates; omission is always a read-only preview.
--json
-h, --help Print help