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 | 列印幫助 |