1.1.1
完整 1.1.1 CLI 参考
浏览每一个公开的 1.1.1 ait 命令与命令组，包含确切的输出语法、选项、默认值、冲突关系和作用边界。
适用人群： 开发者、coding agent 与运维
覆盖范围#
这是被准入的原生 ait 1.1.1 二进制给出的完整公开命令参考，覆盖 29 个顶层命令 和 160 个非根的命令或命令组 help surface。根命令 ait --help 的输出单独放在下面。
Clap 自动生成的 help 别名只是导航辅助，不算成独立的产品操作。隐藏的 和内部的解析器 surface 同样不在这份公开参考里。
怎么读这些语法#
<VALUE>是调用方必须提供的值，尖括号本身不要照着输入。[OPTIONS]、[COMMAND]以及其他方括号分组都是可选的。- 用法行里出现的选择关系是解析器强制的。拼命令时要保持原有的分组。
- 默认值、可选值、冲突和必填要求，都出现在 1.1.1 二进制给出它们的位置。
顶层命令索引#
ait init— 创建或重新初始化本地 AIT 仓库权威，并刷新生效的仓库指令。ait plan— 记录 Markdown Plan 沿革，查看修订版本，并在选定范围内同步确切的原始 Markdown。ait task— 启动绑定 Plan 的工作，查看并审计 Task 状态，完成已接纳的工作，或放弃未完成的 Task。ait blame— 把某个路径或行区间归因到已记录的 Snapshot 与 Plan 沿革，并提供一个明确的有界恢复选项。ait doctor— 针对配置的 memory 根目录、runtime 根目录或 Plan 权威运行定向诊断。ait queue— 以摘要形式查看进行中的工作、评审、远程和 worktree 清单。ait remote— 注册并列出远程权威，或从一个确切的远程 Repository 权威重建本地 Line head。ait release— 创建并查看发布档案，构建并打包原生产物，发布这些产物，并晋级已接纳的发布。ait repo— 查看或管理已注册的远程 Repository 及其 CI 任务、能力和运行记录。ait config— 查看生效的仓库配置，或设置一个明确的受支持配置值。ait external— 查看、物化、固定、链接、解除链接并诊断外部仓库依赖。ait status— 查看当前的 Line、仓库、工作区、远程和 worktree 状态。ait diff— 用可选的有界路径和输出过滤条件，比较当前工作区与已记录的状态。ait pull— 导入远程 Line 的 Snapshot 历史，判定 head 之间的关系，并可选地物化选定的结果。ait push— 上传已记录的 Snapshot 历史，并推进一条确切的远程 Line。ait gc— 查看、校验并清理符合条件的原生存储包。ait stash— 记录、查看、应用并删除本地未完成工作的 stash 条目。ait change— 在一个 Task 内创建、查看、更新、取消以及以其他方式管理 Change 的生命周期。ait snapshot— 创建并查看不可变的仓库状态，遍历它的父级历史，并重放或恢复已记录的内容。ait commit— 通过 Git 友好的 commit 命名入口创建 AIT Snapshot。ait tag— 创建、查看、列出并删除指向已记录状态的本地 AIT Tag 引用。ait patchset— 发布并查看 Change 候选，选定当前候选，并管理它的 CI 请求状态。ait review— 为选定的 Patchset 请求、查看并记录评审决定。ait attest— 创建并查看挂在选定 Patchset 上的带类型证据。ait policy— 对选定的 Patchset 评估、查看并显式豁免受支持的策略检查。ait worktree— 查看、诊断、恢复、迁移并清理由 AIT 持有的 Task worktree 及其元数据。ait workflow— 对有界改动分类、校准工作流状态、准备远程就绪条件，并推动配置好的收尾决策。ait line— 查看并管理 Line，切换或恢复工作区状态，合并已记录的历史，并清理符合条件的 Line 记录。ait git— 在 Git 与 AIT 原生仓库模型之间导入、导出并镜像历史。
根 help#
下面这段是所抓取的 1.1.1 二进制里 ait --help 的完整输出，未作删减。
AIT native local repository and workflow tool.
Usage: ait <COMMAND>
Commands:
init Create or reinitialize a local AIT repository.
line Manage named Lines and their Snapshot heads. [alias: branch]
git Import, export, or mirror history between Git and AIT.
blame Attribute selected lines without modifying workspace files.
doctor Inspect effective AIT configuration and host readiness without repairing it.
queue Summarize active Tasks, Changes, worktrees, and reviews.
remote Manage server endpoints and recover the canonical remote main head.
release Build, inspect, and publish versioned release artifacts.
repo Inspect and manage the configured Repository on its remote server.
config Inspect effective configuration and change supported user settings.
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 Upload one local Line and its Snapshot history to a remote.
gc Inspect and safely maintain local content storage.
stash Park and restore temporary local-only workspace Snapshots.
plan Inspect and sync local or remote Plans.
task Start, inspect, check, finish, or abandon Tasks locally or on a remote.
change Create, inspect, publish, or close Task-owned Changes.
snapshot Create and inspect immutable local Snapshots and restore selected workspace content.
commit Create an AIT Snapshot using Git-friendly commit naming.
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 Record and inspect evidence for remote Patchsets.
policy Check, inspect, or waive remote Patchset requirements.
worktree Inspect, restore, recover, synchronize, rebase, and remove isolated worktrees.
workflow Prepare Changes for review, finish ready work, and repair workflow state.
help Print this message or the help of the given subcommand(s)
Options:
-h, --help Print help
-V, --version Print version说明
AIT 原生本地仓库与工作流工具。
| 参数 / 选项 | 说明 |
|---|---|
init | 创建或重新初始化一个本地 AIT 仓库。 |
line | 管理命名 Line 及其 Snapshot head。[alias: branch] |
git | 在 Git 与 AIT 之间导入、导出或镜像历史。 |
blame | 标注所选行的归属，不修改工作区文件。 |
doctor | 查看生效的 AIT 配置和主机就绪状态，不做修复。 |
queue | 汇总活动的 Task、Change、worktree 和评审。 |
remote | 管理服务器端点并恢复规范的远程 main head。 |
release | 构建、查看并发布带版本的 release 产物。 |
repo | 在远程服务器上查看并管理已配置的 Repository。 |
config | 查看生效配置，并改动受支持的用户设置。 |
external | 管理可复现的外部 Repository 依赖。 |
status | 查看当前仓库、Line、Snapshot、工作区以及可操作的本地状态。 |
diff | 将当前工作区与当前 Line head 比较。 |
pull | 导入一个远程 Line 并安全更新其本地 head。 |
push | 把一条本地 Line 及其 Snapshot 历史上传到远程。 |
gc | 查看并安全维护本地内容存储。 |
stash | 暂存并恢复临时的仅本地工作区 Snapshot。 |
plan | 查看并同步本地或远程 Plan。 |
task | 在本地或远程启动、查看、检查、完成或放弃 Task。 |
change | 创建、查看、发布或关闭 Task 所属的 Change。 |
snapshot | 创建并查看不可变的本地 Snapshot，并恢复选定的工作区内容。 |
commit | 使用 Git 友好的 commit 命名创建 AIT Snapshot。 |
tag | 创建、查看和删除本地 Snapshot Tag。 |
patchset | 发布并查看远程 Change 修订版及其 CI 状态。 |
review | 查看远程 Review 状态，并记录团队、人工 Task 或 AI 代码评审证据。 |
attest | 记录并查看远程 Patchset 的证据。 |
policy | 检查、查看或豁免远程 Patchset 要求。 |
worktree | 查看、恢复、找回、同步、rebase 和删除隔离的 worktree。 |
workflow | 准备 Change 以供评审，完成已就绪工作，并修复工作流状态。 |
help | 打印本消息或给定子命令的帮助 |
-h, --help | 打印帮助 |
-V, --version | 打印版本 |
抓取来源#
- 产品版本：
1.1.1 - 抓取所用二进制的 SHA-256：
6412a60452d5d1ee2c6d4277c09d0804e4ad73e77da58713ec312a04a6870098 - 完整 help 抓取的 SHA-256：
f6c2bb51a447220ed6c6856ea56fbe87aa518b55defd68e766d440e1cefbb185 - CLI 解析器 SHA-256：
829ccf69699c28bcca872cd2b191d256ed8aef4b4e8ada0590fb1e0aacb38215 - CLI 解析器源码：不可变的 1.1.1 源码
生成的收据记录了每条命令路径、给出的描述、用法、子命令列表、help 摘要 和确切的 help 文本。网站和 PDF 构建都会拿这份收据来校验这些页面。