ait line — 完整参考
查看并管理 Line，切换或恢复工作区状态，合并已记录的历史，并清理符合条件的 Line 记录。
适用人群： 开发者与 coding agent
作用边界#
用途： 查看并管理 Line，切换或恢复工作区状态，合并已记录的历史，并清理符合条件的 Line 记录。
影响类别： 读取与本地写入混合的入口；switch、restore、merge、create、rename、archive 和 cleanup 会改变本地状态。
覆盖： ait line 下共 10 个公开 help surface。
下面的代码块原样保留 1.0.0 二进制的输出，包含它给出的每一个参数、选项、 默认值、可选值、冲突关系和必填要求。
完整命令树#
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 cleanup原样输出的 help#
ait line#
参考描述： 查看并管理 Line，切换或恢复工作区状态，合并已记录的历史，并清理符合条件的 Line 记录。
1.0.0 二进制没有为这个 surface 单独给出描述，上面那句是文档补充的说明。 下面是解析器提供的完整用法和选项，未作改动。
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#
参考描述： 在选定的本地或远程视图中列出活跃或已归档的 Line。
1.0.0 二进制没有为这个 surface 单独给出描述，上面那句是文档补充的说明。 下面是解析器提供的完整用法和选项，未作改动。
Usage: ait line list [OPTIONS]
Options:
--all
--archived
--remote <REMOTE>
--json
-h, --help Print helpait line create#
参考描述： 创建一条具名 Line，可选地基于某个确切的 Snapshot，并可选地把工作区切换或恢复到它。
1.0.0 二进制没有为这个 surface 单独给出描述，上面那句是文档补充的说明。 下面是解析器提供的完整用法和选项，未作改动。
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#
参考描述： 把一条具名 Line 设为当前 Line，并可选地把它记录的 head 恢复到工作区。
1.0.0 二进制没有为这个 surface 单独给出描述，上面那句是文档补充的说明。 下面是解析器提供的完整用法和选项，未作改动。
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#
参考描述： 查看选定的或当前的 Line 及其记录的状态。
1.0.0 二进制没有为这个 surface 单独给出描述，上面那句是文档补充的说明。 下面是解析器提供的完整用法和选项，未作改动。
Usage: ait line show [OPTIONS] [NAME]
Arguments:
[NAME]
Options:
--json
-h, --help Print helpait line archive#
参考描述： 在选定的权威中归档一条具名 Line。
1.0.0 二进制没有为这个 surface 单独给出描述，上面那句是文档补充的说明。 下面是解析器提供的完整用法和选项，未作改动。
Usage: ait line archive [OPTIONS] <NAME>
Arguments:
<NAME>
Options:
--remote <REMOTE>
--json
-h, --help Print helpait line rename#
二进制描述： 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#
二进制描述： 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#
二进制描述： 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#
二进制描述： 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