ait plan — Complete Reference
Record Markdown Plan lineage, inspect revisions, and synchronize exact authored Markdown in the selected scope.
Audience: Coding agents and maintainers
Operating boundary#
Purpose: Record Markdown Plan lineage, inspect revisions, and synchronize exact authored Markdown in the selected scope.
Effect class: Mixed read and Plan mutation surface; sync scope is explicit in the emitted options.
Coverage: 8 public help surfaces under ait plan.
The blocks below preserve the RC.6 binary output in full, including every emitted argument, option, default, possible value, conflict, and requirement.
Complete command tree#
ait plan
ait plan list
ait plan show
ait plan revisions
ait plan items
ait plan candidates
ait plan inspect
ait plan syncExact emitted help#
ait plan#
Reference description: Record Markdown Plan lineage, inspect revisions, and synchronize exact authored Markdown in the selected scope.
The RC.6 binary emits no separate prose description for this surface; the sentence above is editorial context. The complete parser-provided usage and options follow unchanged.
Usage: ait plan <COMMAND>
Commands:
list
show
revisions
items
candidates
inspect
sync Reconcile file-backed Markdown into Plan revision lineage. --local writes only local Plan state; --remote publishes the touched local heads. 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 helpait plan list#
Reference description: List Plans in the selected local or remote authority.
The RC.6 binary emits no separate prose description for this surface; the sentence above is editorial context. The complete parser-provided usage and options follow unchanged.
Usage: ait plan list [OPTIONS]
Options:
--local
--remote <REMOTE>
--json
--all Show complete Plan history instead of the bounded active view
-h, --help Print helpait plan show#
Reference description: Show one Plan and its current recorded revision.
The RC.6 binary emits no separate prose description for this surface; the sentence above is editorial context. The complete parser-provided usage and options follow unchanged.
Usage: ait plan show [OPTIONS] <PLAN_ID>
Arguments:
<PLAN_ID>
Options:
--revision <REVISION>
--local
--remote <REMOTE>
--json
-h, --help Print helpait plan revisions#
Reference description: List the recorded Markdown revisions for one Plan.
The RC.6 binary emits no separate prose description for this surface; the sentence above is editorial context. The complete parser-provided usage and options follow unchanged.
Usage: ait plan revisions [OPTIONS] <PLAN_ID>
Arguments:
<PLAN_ID>
Options:
--local
--remote <REMOTE>
--json
--all Show complete revision history instead of the bounded newest view
-h, --help Print helpait plan items#
Reference description: List taskable and non-taskable items recorded for one Plan.
The RC.6 binary emits no separate prose description for this surface; the sentence above is editorial context. The complete parser-provided usage and options follow unchanged.
Usage: ait plan items [OPTIONS] <PLAN_ID>
Arguments:
<PLAN_ID>
Options:
--revision <REVISION>
--local
--remote <REMOTE>
--json
-h, --help Print helpait plan candidates#
Reference description: Inspect authored Markdown candidates that can be synchronized as Plan lineage.
The RC.6 binary emits no separate prose description for this surface; the sentence above is editorial context. The complete parser-provided usage and options follow unchanged.
Usage: ait plan candidates [OPTIONS]
Options:
--local
--remote <REMOTE>
--all
--contains <CONTAINS>
--json
-h, --help Print helpait plan inspect#
Reference description: Inspect one Plan's structure, bindings, and taskability evidence.
The RC.6 binary emits no separate prose description for this surface; the sentence above is editorial context. The complete parser-provided usage and options follow unchanged.
Usage: ait plan inspect [OPTIONS] <PLAN_ID>
Arguments:
<PLAN_ID>
Options:
--revision <REVISION>
--local
--remote <REMOTE>
--json
-h, --help Print helpait plan sync#
Binary description: Reconcile file-backed Markdown into Plan revision lineage. --local writes only local Plan state; --remote publishes the touched local heads. Plan sync never creates a Snapshot or advances a Line.
Reconcile file-backed Markdown into Plan revision lineage. --local writes only local Plan state; --remote publishes the touched local heads. Plan sync never creates a Snapshot or advances a Line.
Usage: ait plan sync [OPTIONS] <TARGET>
Arguments:
<TARGET> Markdown file or directory to reconcile into Plan revision lineage
Options:
--plan-ref <PLAN_REF> Select one structured [plan-ref: ...] root when the target is ambiguous
--prune Archive tracked Plan artifacts missing from the selected target
--local Write local Plan lineage only; never create a Snapshot or advance a Line
--remote <REMOTE> Publish the touched local Plan heads to the named remote
--rebase Replay the current local Plan head after a divergent remote-head rejection
--reconcile Safely adopt verified divergent or mixed local/remote Plan identity before publishing the reconciled head
--json
-h, --help Print help