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 1.1.1 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#
Binary description: Manage named Lines and their Snapshot heads. ait branch is a Git-friendly alias with the same subcommands, safety checks, and output; the recorded objects remain AIT Lines and Snapshots.
Manage named Lines and their Snapshot heads. `ait branch` is a Git-friendly alias with the same subcommands, safety checks, and output; the recorded objects remain AIT Lines and Snapshots.
Usage: ait line <COMMAND>
Commands:
list List active local Lines or Lines from a remote.
create Create a new local Line at a Snapshot head.
switch Select a local Line, optionally restoring its files.
show Show one local or remote Line and its current head.
archive Archive a local or remote Line without deleting its Snapshots.
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 eligible candidates with --yes.
help Print this message or the help of the given subcommand(s)
Options:
-h, --help
Print help (see a summary with '-h')ait line list#
Binary description: List active local Lines or Lines from a remote.
List active local Lines or Lines from a remote.
Usage: ait line list [OPTIONS]
Options:
--all
--archived
--remote <REMOTE>
--json
-h, --help Print helpait line create#
Binary description: Create a new local Line at a Snapshot head.
Create a new local Line at a Snapshot head.
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#
Binary description: Select a local Line, optionally restoring its files.
Select a local Line, optionally restoring its files.
Usage: ait line switch [OPTIONS] <NAME>
Arguments:
<NAME>
Options:
--restore Restore the selected Line head's files into the workspace.
--force Allow --restore to overwrite conflicting workspace changes.
--json
-h, --help Print helpait line show#
Binary description: Show one local or remote Line and its current head.
Show one local or remote Line and its current head.
Usage: ait line show [OPTIONS] [NAME]
Arguments:
[NAME]
Options:
--json
-h, --help Print helpait line archive#
Binary description: Archive a local or remote Line without deleting its Snapshots.
Archive a local or remote Line without deleting its Snapshots.
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 eligible candidates with --yes.
Preview idle temporary Lines, or archive eligible 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 eligible candidates; omission is always a read-only preview.
--json
-h, --help Print help