ait config — 完整参考
查看生效的仓库配置,或设置一个明确的受支持配置值。
适用人群: 用户与运维
作用边界#
用途: 查看生效的仓库配置,或设置一个明确的受支持配置值。
影响类别: show 为只读;set 会改动仓库配置,并可能刷新生成的指令。
覆盖: ait config 下共 4 个公开 help surface。
下面的代码块原样保留 1.1.1 二进制的输出,包含它给出的每一个参数、选项、 默认值、可选值、冲突关系和必填要求。
完整命令树#
ait config
ait config show
ait config set
ait config unset原样输出的 help#
ait config#
二进制描述: Inspect effective configuration and change supported user settings.
Inspect effective configuration and change supported user settings.
Usage: ait config <COMMAND>
Commands:
show Inspect effective repository configuration without modifying it.
set Set supported user-owned repository defaults.
unset Remove one supported user setting.
help Print this message or the help of the given subcommand(s)
Options:
-h, --help Print help说明
查看生效配置,并改动受支持的用户设置。
| 参数 / 选项 | 说明 |
|---|---|
show | 查看生效的仓库配置,不做修改。 |
set | 设置受支持的用户持有仓库默认值。 |
unset | 删除一个受支持的用户设置。 |
help | 打印本消息或给定子命令的帮助 |
-h, --help | 打印帮助 |
ait config show#
二进制描述: Read repository configuration plus the applicable worktree settings and report the effective values. Human output is compact; --json returns the complete machine-readable result.
Read repository configuration plus the applicable worktree settings and report the effective values. Human output is compact; --json returns the complete machine-readable result.
Usage: ait config show [OPTIONS]
Options:
--json
Emit the complete machine-readable effective configuration.
-h, --help
Print help (see a summary with '-h')说明
读取仓库配置及适用的 worktree 设置,并报告生效值。人类可读输出精简;--json 返回完整的机器可读结果。
ait config set#
二进制描述: Set one or more supported user-owned defaults, then refresh effective configuration and generated workflow guidance. Internal Repository indexes, derived local/remote settings, and Plan bindings cannot be set here. Use ait config unset <KEY> to remove an optional override.
Set one or more supported user-owned defaults, then refresh effective configuration and generated workflow guidance. Internal Repository indexes, derived local/remote settings, and Plan bindings cannot be set here. Use `ait config unset <KEY>` to remove an optional override.
Usage: ait config set [OPTIONS]
Options:
--workflow-mode <WORKFLOW_MODE>
Set the complete workflow preset. This chooses where Workflow, Task, and Change commands run and defaults sprint mode to on unless --sprint is supplied.
[possible values: solo_local, solo_remote, team_remote]
--sprint <SPRINT>
Set sprint-style Plan/Task binding. On requires exact Plan item refs; off uses unbound Tasks.
[possible values: on, off]
--default-author-mode <DEFAULT_AUTHOR_MODE>
Set the default provenance author mode.
[possible values: human_only, human_with_ai_assist, ai_with_human_review, ai_only_experimental]
--default-model <DEFAULT_MODEL>
Set a non-empty default provenance model name.
--task-review <TASK_REVIEW>
Set Task outcome review policy. Required waits for review; automatic records task_approve using configured user_name.
[possible values: required, automatic]
--task-worktree-alias-root <TASK_WORKTREE_ALIAS_ROOT>
Set a non-empty managed alias root for task worktrees. Relative paths resolve from the Repository root.
--task-worktree-main-seed-ram-max-bytes <TASK_WORKTREE_MAIN_SEED_RAM_MAX_BYTES>
Set a non-negative Repository-local RAM budget in bytes for main-seed-backed task worktree bootstrap.
--id-namespace-prefix <ID_NAMESPACE_PREFIX>
Set a non-empty ASCII-alphanumeric namespace prefix before workflow type codes such as T/C/P/PL/PR.
--user-name <USER_NAME>
Set the non-empty human identity used by explicit and automatic Task review.
--user-email <USER_EMAIL>
Set a non-empty local actor email for non-Task-review identity surfaces.
--json
Emit the complete machine-readable effective configuration after the update.
-h, --help
Print help (see a summary with '-h')说明
设置一个或多个受支持的用户持有默认值,然后刷新生效配置和生成的工作流指引。内部 Repository 索引、派生的本地/远程设置和 Plan 绑定不能在此设置。用 ait config unset <KEY> 删除可选 override。
ait config unset#
二进制描述: Delete exactly one optional user setting from repository configuration, then refresh effective configuration and generated workflow guidance. Fallbacks are: default-author-mode -> ai_with_human_review; default-model -> unset; task-review -> automatic; task-worktree-alias-root -> .ait-worktree-links; task-worktree-main-seed-ram-max-bytes -> no configured budget; id-namespace-prefix -> empty; user-name and user-email -> unset while actor detection remains available. Internal Repository indexes, workflow-mode, sprint, derived local/remote settings, and Plan bindings cannot be unset.
Delete exactly one optional user setting from repository configuration, then refresh effective configuration and generated workflow guidance. Fallbacks are: default-author-mode -> ai_with_human_review; default-model -> unset; task-review -> automatic; task-worktree-alias-root -> .ait-worktree-links; task-worktree-main-seed-ram-max-bytes -> no configured budget; id-namespace-prefix -> empty; user-name and user-email -> unset while actor detection remains available. Internal Repository indexes, workflow-mode, sprint, derived local/remote settings, and Plan bindings cannot be unset.
Usage: ait config unset [OPTIONS] <KEY>
Arguments:
<KEY>
Supported optional user setting to remove.
[possible values: default-author-mode, default-model, task-review, task-worktree-alias-root, task-worktree-main-seed-ram-max-bytes, id-namespace-prefix, user-name, user-email]
Options:
--json
Emit the complete machine-readable effective configuration after removal.
-h, --help
Print help (see a summary with '-h')说明
从仓库配置中删除一个确切的可选用户设置,然后刷新生效配置和生成的工作流指引。回退值为:default-author-mode -> ai_with_human_review;default-model -> unset;task-review -> automatic;task-worktree-alias-root -> .ait-worktree-links;task-worktree-main-seed-ram-max-bytes -> 未配置预算;id-namespace-prefix -> 空;user-name 和 user-email -> unset,但仍可检测 actor。内部 Repository 索引、workflow-mode、sprint、派生的本地/远程设置和 Plan 绑定不能 unset。