1.0.0
文档修订 2
完整 1.0.0 CLI 参考
浏览每一个公开的 1.0.0 ait 命令与命令组,包含确切的输出语法、选项、默认值、冲突关系和作用边界。
适用人群: 开发者、coding agent 与运维
覆盖范围#
这是被准入的原生 ait 1.0.0 二进制给出的完整公开命令参考。它覆盖 native ait 1.0.0 binary。它覆盖 28 个顶层命令 和 159 个非根的命令或命令组 help surface。根命令 ait --help 的输出单独放在下面。
Clap 自动生成的 help 别名只是导航辅助,不算成独立的产品操作。隐藏的 和内部的解析器 surface 同样不在这份公开参考里。
怎么读这些语法#
<VALUE>是调用方必须提供的值,尖括号本身不要照着输入。[OPTIONS]、[COMMAND]以及其他方括号分组都是可选的。- 用法行里出现的选择关系是解析器强制的。拼命令时要保持原有的分组。
- 默认值、可选值、冲突和必填要求,都出现在 1.0.0 二进制给出它们的位置。
顶层命令索引#
ait init— Create or reinitialize local AIT repository authority and refresh the effective repository instructions.ait plan— Record Markdown Plan lineage, inspect revisions, and synchronize exact authored Markdown in the selected scope.ait task— Start Plan-bound work, inspect and audit Task state, land admitted work, or abandon an unfinished Task.ait blame— Attribute a path or line range to recorded Snapshot and Plan lineage, with an explicit bounded restore option.ait doctor— Run focused diagnostics for the configured memory root, runtime root, or Plan authority.ait queue— Read active work, review, remote, and worktree inventory in summary form.ait remote— Register and list remote authorities or reconstruct a local Line head from an exact remote Repository authority.ait release— Create and inspect release dossiers, build and package native artifacts, publish them, and promote admitted releases.ait repo— Inspect or administer a registered remote Repository and its CI jobs, capabilities, and runs.ait config— Inspect effective repository configuration or set an explicit supported configuration value.ait external— Inspect, materialize, pin, link, unlink, and diagnose external repository dependencies.ait status— Inspect the current Line, repository, workspace, remote, and worktree state.ait diff— Compare the current workspace with recorded state using optional bounded path and output filters.ait pull— Import a remote Line's Snapshot history, classify head relationships, and optionally materialize the selected result.ait push— Upload recorded Snapshot history and advance an exact remote Line.ait gc— Inspect, validate, and prune eligible native storage packs.ait stash— Record, inspect, apply, and remove local work-in-progress stash entries.ait change— Create, inspect, update, cancel, and otherwise manage the Change lifecycle within a Task.ait snapshot— Create and inspect immutable repository state, traverse its parent history, and replay or restore recorded content.ait tag— Create, inspect, list, and remove local AIT Tag references to recorded state.ait patchset— Publish and inspect Change candidates, select the current candidate, and manage its CI request state.ait review— Request, inspect, and record review decisions for a selected Patchset.ait attest— Create and inspect typed evidence attached to a selected Patchset.ait policy— Evaluate, inspect, and explicitly waive supported policy checks for a selected Patchset.ait worktree— Inspect, diagnose, recover, relocate, and clean AIT-owned Task worktrees and their metadata.ait workflow— Classify bounded edits, reconcile workflow state, prepare remote readiness, and drive configured closeout decisions.ait line— Inspect and manage Lines, switch or restore workspace state, merge recorded history, and clean eligible Line records.ait git— Import, export, and mirror history between Git and AIT's native repository model.
根 help#
下面这段是所抓取的 1.0.0 二进制里 ait --help 的完整输出,未作删减。
AIT native local repository and workflow tool.
Usage: ait <COMMAND>
Commands:
init Create or reinitialize a local AIT repository.
line
git
blame Attribute selected lines without modifying workspace files.
doctor Inspect effective AIT configuration and host readiness without repairing it.
queue
remote Manage server endpoints and recover the canonical remote main head.
release
repo Inspect and manage the configured remote Repository authority.
config Inspect effective configuration and mutate only admitted user-owned overrides.
external Manage reproducible external Repository dependencies.
status Inspect the current repository, Line, Snapshot, workspace, and actionable local status.
diff Compare the current workspace with the current Line head.
pull Import one remote Line and safely update its local head.
push
gc Inspect and safely maintain local content storage.
stash Park and restore temporary local-only workspace Snapshots.
plan Inspect and reconcile local or remote Plan authority.
task Start, inspect, audit, land, or abandon scoped Task lifecycle authority.
change
snapshot Create and inspect immutable local Snapshots and restore selected workspace content.
tag Create, inspect, and delete local Snapshot Tags.
patchset Publish and inspect remote Change revisions and their CI state.
review Inspect remote Review state and record team, human Task, or AI code-review evidence.
attest
policy
worktree Inspect, restore, recover, synchronize, rebase, and remove isolated worktrees.
workflow
help Print this message or the help of the given subcommand(s)
Options:
-h, --help Print help
-V, --version Print version抓取来源#
- 产品版本:
1.0.0 - 抓取所用二进制的 SHA-256:
7c1c10d9a7df3c8b0efd718f634c00ad958ce4e629f93a581b41c955c3895029 - 完整 help 抓取的 SHA-256:
69d151aedee72e824412034699b51b2721ded4b226a35d6da7575292ef88f4e7 - CLI 解析器 SHA-256:
5b56bf0adaf3382f0b499f5b4b4eed0f70c2a6ccabab1d89d4e97c9e785dc138 - CLI 解析器源码:不可变的 1.0.0 源码
生成的收据记录了每条命令路径、给出的描述、用法、子命令列表、help 摘要 和确切的 help 文本。网站和 PDF 构建都会拿这份收据来校验这些页面。