ait line — 完整参考
查看并管理 Line,切换或恢复工作区状态,合并已记录的历史,并清理符合条件的 Line 记录。
适用人群: 开发者与 coding agent
作用边界#
用途: 查看并管理 Line,切换或恢复工作区状态,合并已记录的历史,并清理符合条件的 Line 记录。
影响类别: 读取与本地写入混合的入口;switch、restore、merge、create、rename、archive 和 cleanup 会改变本地状态。
覆盖: ait line 下共 10 个公开 help surface。
下面的代码块原样保留 1.1.1 二进制的输出,包含它给出的每一个参数、选项、 默认值、可选值、冲突关系和必填要求。
完整命令树#
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#
二进制描述: 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')说明
管理命名 Line 及其 Snapshot head。ait branch 是 Git 友好别名,具有相同子命令、安全检查和输出;记录的对象仍是 AIT Line 与 Snapshot。
| 参数 / 选项 | 说明 |
|---|---|
list | 列出活动的本地 Line 或远程 Line。 |
create | 在一个 Snapshot head 创建新的本地 Line。 |
switch | 选择一条本地 Line,并可选择恢复其文件。 |
show | 显示一条本地或远程 Line 及其当前 head。 |
archive | 归档一条本地或远程 Line,但不删除其 Snapshot。 |
rename | 重命名一个 line,同时保留其稳定身份并调和绑定的指针。 |
delete | 仅删除一个 line 引用,且须先通过绑定与唯一历史保护检查。 |
merge | 将一个 Line 合并进当前 Line,带可续的冲突状态和一个双父级 Snapshot。 |
cleanup | 预览闲置的临时 Line,或用 --yes 归档符合条件的候选。 |
help | 打印本消息或给定子命令的帮助 |
ait line list#
二进制描述: 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 help说明
列出活动的本地 Line 或远程 Line。
| 参数 / 选项 | 说明 |
|---|---|
-h, --help | 打印帮助 |
ait line create#
二进制描述: 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 help说明
在一个 Snapshot head 创建新的本地 Line。
| 参数 / 选项 | 说明 |
|---|---|
--from-snapshot <FROM_SNAPSHOT> | 从此 Snapshot 开始新 Line,而不是从当前 Line head 开始。 |
--switch | 选定新 Line,不改变工作区文件。 |
-h, --help | 打印帮助 |
ait line switch#
二进制描述: 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 help说明
选择一条本地 Line,并可选择恢复其文件。
| 参数 / 选项 | 说明 |
|---|---|
--restore | 把所选 Line head 的文件恢复到工作区。 |
--force | 允许 --restore 覆盖有冲突的工作区改动。 |
-h, --help | 打印帮助 |
ait line show#
二进制描述: 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 help说明
显示一条本地或远程 Line 及其当前 head。
| 参数 / 选项 | 说明 |
|---|---|
-h, --help | 打印帮助 |
ait line archive#
二进制描述: 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 help说明
归档一条本地或远程 Line,但不删除其 Snapshot。
| 参数 / 选项 | 说明 |
|---|---|
-h, --help | 打印帮助 |
ait 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 help说明
重命名一个 line,同时保留其稳定身份并调和绑定的指针。
| 参数 / 选项 | 说明 |
|---|---|
-h, --help | 打印帮助 |
ait 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 help说明
仅删除一个 line 引用,且须先通过绑定与唯一历史保护检查。
| 参数 / 选项 | 说明 |
|---|---|
-h, --help | 打印帮助 |
ait 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 help说明
将一个 Line 合并进当前 Line,带可续的冲突状态和一个双父级 Snapshot。
| 参数 / 选项 | 说明 |
|---|---|
-h, --help | 打印帮助 |
ait line cleanup#
二进制描述: 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说明
预览闲置的临时 Line,或用 --yes 归档符合条件的候选。
| 参数 / 选项 | 说明 |
|---|---|
--idle-for <IDLE_FOR> | 自该 Line 最后一次活动以来的最短时长,例如 7d、12h 或 30m。[default: 7d] |
--kind <CLEANUP_KIND> | 将清理限定为 review_base、review 或 wip Line。 |
--limit <LIMIT> | 最多选出此正数个最旧的候选。 |
--include-protected | 在结果中包含非候选项及其保护原因。 |
--all | 显示每个选中的行;受保护行仍需要 --include-protected。 |
--yes | 归档符合条件的候选;省略此选项时始终只读预览。 |
-h, --help | 打印帮助 |