ait plan — 完整參考
記錄 Markdown Plan 沿革，檢視修訂版本，並在選定範圍內同步確切的原始 Markdown。
適用對象： coding agent 與維護者
作用邊界#
用途： 記錄 Markdown Plan 沿革，檢視修訂版本，並在選定範圍內同步確切的原始 Markdown。
影響類別： 讀取與 Plan 寫入混合的入口；sync 的範圍在給出的選項裡是明確的。
覆蓋： ait plan 下共 8 個公開 help surface。
下面的程式碼區塊原樣保留 1.1.1 二進位的輸出，包含它給出的每一個引數、選項、 預設值、可選值、衝突關係和必填要求。
完整命令樹#
ait plan
ait plan list
ait plan show
ait plan revisions
ait plan items
ait plan candidates
ait plan inspect
ait plan sync原樣輸出的 help#
ait plan#
二進位描述： Inspect, select, and sync Plan revision history. Without --local or --remote, solo_local uses local Plans and solo_remote uses the configured default remote. Either flag explicitly overrides that default. Remote sync updates local Plan history before publishing; no Plan command creates a Snapshot or advances a Line.
Inspect, select, and sync Plan revision history. Without --local or --remote, solo_local uses local Plans and solo_remote uses the configured default remote. Either flag explicitly overrides that default. Remote sync updates local Plan history before publishing; no Plan command creates a Snapshot or advances a Line.
Usage: ait plan <COMMAND>
Commands:
list List local Plans or Plans from a remote.
show Show one Plan and its selected revision.
revisions List revision history for one Plan.
items List checklist items from one Plan revision.
candidates Find active Plans that can supply Task candidates.
inspect Inspect Task-readiness details for one Plan revision.
sync Sync file-backed Markdown into Plan revision history using the workflow mode's local or remote default. solo_local saves local Plan changes; solo_remote updates local Plan history and publishes the changed heads to the configured default remote. --local or --remote overrides that default. Plan sync never creates a Snapshot or advances a Line.
help Print this message or the help of the given subcommand(s)
Options:
-h, --help
Print help (see a summary with '-h')說明
檢視、選擇並同步 Plan 修訂歷史。未給 --local 或 --remote 時，solo_local 使用本地 Plan，solo_remote 使用設定的預設遠端；任一 flag 都會顯式覆蓋預設值。遠端同步先更新本地 Plan 歷史再發布；任何 Plan 命令都不會建立 Snapshot 或推進 Line。
| 引數 / 選項 | 說明 |
|---|---|
list | 列出本地 Plan 或遠端 Plan。 |
show | 顯示一個 Plan 及其選定修訂版。 |
revisions | 列出一個 Plan 的修訂歷史。 |
items | 列出一個 Plan 修訂版中的清單條目。 |
candidates | 查詢能提供 Task 候選的活動 Plan。 |
inspect | 檢視一個 Plan 修訂版的 Task 就緒詳情。 |
sync | 按工作流程模式的本地或遠端預設值，把檔案承載的 Markdown 同步到 Plan 修訂歷史。solo_local 儲存本地 Plan 改動；solo_remote 更新本地 Plan 歷史，並把改動的 head 發布到設定的預設遠端。--local 或 --remote 覆蓋該預設值。Plan sync 絕不建立 Snapshot 或推進 Line。 |
help | 列印本訊息或給定子命令的幫助 |
ait plan list#
二進位描述： List Plans locally, from --remote, or from the location selected by the workflow mode. Human output is bounded to active Plans unless --all is supplied; JSON always returns the complete command result and therefore rejects --all. This command is read-only.
List Plans locally, from --remote, or from the location selected by the workflow mode. Human output is bounded to active Plans unless --all is supplied; JSON always returns the complete command result and therefore rejects --all. This command is read-only.
Usage: ait plan list [OPTIONS]
Options:
--local
Use local Plans even when the workflow mode defaults to a remote
--remote <NAME>
Use Plans from the named remote even when the workflow mode defaults to local
--json
Emit the complete stable machine-readable payload
--all
Expand human output to include archived Plans; unavailable with --json
-h, --help
Print help (see a summary with '-h')說明
列出本地、--remote 指定遠端或工作流程模式所選位置的 Plan。除非提供 --all，人類可讀輸出只包含活動 Plan；JSON 始終傳回完整命令結果，因此拒絕 --all。此命令為只讀。
ait plan show#
二進位描述： Show one Plan locally, from --remote, or from the location selected by the workflow mode. Without --revision, show the current head revision. Local selectors include PR-<ordinal>, artifact:<path>, title:<title>, and published-plan:<index>; remote selectors are the identifiers returned by remote plan list. This command is read-only.
Show one Plan locally, from --remote, or from the location selected by the workflow mode. Without --revision, show the current head revision. Local selectors include PR-<ordinal>, artifact:<path>, title:<title>, and published-plan:<index>; remote selectors are the identifiers returned by remote plan list. This command is read-only.
Usage: ait plan show [OPTIONS] <PLAN>
Arguments:
<PLAN>
Plan selector; local canonical forms are PR-<ordinal>, artifact:<path>, title:<title>, or published-plan:<index>
Options:
--revision <REVISION>
Select a non-head revision; local canonical forms are plan-revision:<index>, revision-number:<number>, or published-revision:<index>
--local
Use local Plans even when the workflow mode defaults to a remote
--remote <NAME>
Use Plans from the named remote even when the workflow mode defaults to local
--json
Emit the complete stable machine-readable payload
-h, --help
Print help (see a summary with '-h')說明
顯示本地、--remote 指定遠端或工作流程模式所選位置的一個 Plan。未給 --revision 時顯示目前 head 修訂。本地選擇器包括 PR-<ordinal>、artifact:<path>、title:<title> 和 published-plan:<index>；遠端選擇器是 remote plan list 傳回的識別符號。此命令為只讀。
ait plan revisions#
二進位描述： List one Plan's revisions newest first, using local data, --remote, or the location selected by the workflow mode. Human output is bounded unless --all is supplied; JSON already returns the complete command result and therefore rejects --all. This command is read-only.
List one Plan's revisions newest first, using local data, --remote, or the location selected by the workflow mode. Human output is bounded unless --all is supplied; JSON already returns the complete command result and therefore rejects --all. This command is read-only.
Usage: ait plan revisions [OPTIONS] <PLAN>
Arguments:
<PLAN>
Plan selector; local canonical forms are PR-<ordinal>, artifact:<path>, title:<title>, or published-plan:<index>
Options:
--local
Use local Plans even when the workflow mode defaults to a remote
--remote <NAME>
Use Plans from the named remote even when the workflow mode defaults to local
--json
Emit the complete stable machine-readable payload
--all
Expand human output to the complete revision history; unavailable with --json
-h, --help
Print help (see a summary with '-h')說明
按從新到舊列出一個 Plan 的修訂，資料來自本地、--remote 或工作流程模式選擇的位置。除非提供 --all，人類可讀輸出有界；JSON 已傳回完整命令結果，因此拒絕 --all。此命令為只讀。
ait plan items#
二進位描述： List parsed checklist items from one local or remote Plan. Without --revision, inspect the current head. This command is read-only and does not change item or Task state.
List parsed checklist items from one local or remote Plan. Without --revision, inspect the current head. This command is read-only and does not change item or Task state.
Usage: ait plan items [OPTIONS] <PLAN>
Arguments:
<PLAN>
Plan selector; local canonical forms are PR-<ordinal>, artifact:<path>, title:<title>, or published-plan:<index>
Options:
--revision <REVISION>
Select a non-head revision; local canonical forms are plan-revision:<index>, revision-number:<number>, or published-revision:<index>
--local
Use local Plans even when the workflow mode defaults to a remote
--remote <NAME>
Use Plans from the named remote even when the workflow mode defaults to local
--json
Emit the complete stable machine-readable payload
-h, --help
Print help (see a summary with '-h')說明
列出一個本地或遠端 Plan 中解析出的 checklist 條目。未給 --revision 時檢視目前 head。此命令為只讀，不改變條目或 Task 狀態。
ait plan candidates#
二進位描述： Find active local or remote Plans, ordered for Task selection. By default only Plans with at least one taskable item are returned; --all also includes active Plans with zero taskable items. --contains applies case-insensitive OR matching across Plan titles, file paths and selectors, headings, and item text or refs. This command is read-only.
Find active local or remote Plans, ordered for Task selection. By default only Plans with at least one taskable item are returned; --all also includes active Plans with zero taskable items. --contains applies case-insensitive OR matching across Plan titles, file paths and selectors, headings, and item text or refs. This command is read-only.
Usage: ait plan candidates [OPTIONS]
Options:
--local
Use local Plans even when the workflow mode defaults to a remote
--remote <NAME>
Use Plans from the named remote even when the workflow mode defaults to local
--all
Also include active Plans with zero taskable items; archived Plans remain excluded
--contains <TERMS>
Case-insensitive comma-delimited OR search across titles, paths, selectors, headings, item text, and item refs
--json
Emit the complete stable machine-readable payload
-h, --help
Print help (see a summary with '-h')說明
查詢活動的本地或遠端 Plan，並按 Task 選擇順序排列。預設只傳回至少有一個可開 Task 條目的 Plan；--all 也包含沒有可開 Task 條目的活動 Plan。--contains 對 Plan 標題、檔案路徑與選擇器、標題以及條目文字或 ref 做不區分大小寫的 OR 匹配。此命令為只讀。
ait plan inspect#
二進位描述： Inspect summary counts and per-item Task-readiness blockers for one local or remote Plan. Without --revision, inspect the current head. This command is read-only.
Inspect summary counts and per-item Task-readiness blockers for one local or remote Plan. Without --revision, inspect the current head. This command is read-only.
Usage: ait plan inspect [OPTIONS] <PLAN>
Arguments:
<PLAN>
Plan selector; local canonical forms are PR-<ordinal>, artifact:<path>, title:<title>, or published-plan:<index>
Options:
--revision <REVISION>
Select a non-head revision; local canonical forms are plan-revision:<index>, revision-number:<number>, or published-revision:<index>
--local
Use local Plans even when the workflow mode defaults to a remote
--remote <NAME>
Use Plans from the named remote even when the workflow mode defaults to local
--json
Emit the complete stable machine-readable payload
-h, --help
Print help (see a summary with '-h')說明
檢視一個本地或遠端 Plan 的摘要計數和逐條 Task 就緒阻塞項。未給 --revision 時檢視目前 head。此命令為只讀。
ait plan sync#
二進位描述： Sync file-backed Markdown into Plan revision history using the workflow mode's local or remote default. solo_local saves local Plan changes; solo_remote updates local Plan history and publishes the changed heads to the configured default remote. --local or --remote overrides that default. Plan sync never creates a Snapshot or advances a Line.
Sync file-backed Markdown into Plan revision history using the workflow mode's local or remote default. solo_local saves local Plan changes; solo_remote updates local Plan history and publishes the changed heads to the configured default remote. --local or --remote overrides that default. Plan sync never creates a Snapshot or advances a Line.
Usage: ait plan sync [OPTIONS] <TARGET>
Arguments:
<TARGET>
Repository-relative Markdown file or directory to sync into local Plan revision history
Options:
--plan-ref <PLAN_REF>
Select one exact [plan-ref: ...] root when one Markdown target contains multiple Plan roots
--prune
Archive tracked Plan artifacts missing from the complete selected target inventory
--local
Sync local Plan history only, even when the workflow mode defaults to a remote; never create a Snapshot or advance a Line
--remote <NAME>
Sync local Plan history, then publish the updated heads to the named remote even when the workflow mode defaults to local
--rebase
When using a remote, replay the current local Plan head after the remote rejects divergent history
--reconcile
Safely adopt verified divergent or mixed Plan identity before effective local reconciliation or remote publication
--json
Emit the complete stable machine-readable result; failed and partial-success results still exit nonzero
-h, --help
Print help (see a summary with '-h')說明
按工作流程模式的本地或遠端預設值，把檔案承載的 Markdown 同步到 Plan 修訂歷史。solo_local 儲存本地 Plan 改動；solo_remote 更新本地 Plan 歷史，並把改動的 head 發布到設定的預設遠端。--local 或 --remote 覆蓋該預設值。Plan sync 絕不建立 Snapshot 或推進 Line。