ait config — Complete Reference

ait config
ait config show
ait config set
ait config unset

Inspect effective configuration and mutate only admitted user-owned overrides.

Usage: ait config <COMMAND>

Commands:
  show   Inspect effective repository configuration without modifying it.
  set    Set admitted user-owned repository defaults.
  unset  Remove one admitted user-owned override.
  help   Print this message or the help of the given subcommand(s)

Options:
  -h, --help  Print help

Read authoritative root configuration plus the applicable worktree overlay and report effective values. Human output is compact; --json returns the complete machine-readable projection.

Usage: ait config show [OPTIONS]

Options:
      --json
          Emit the complete machine-readable effective configuration.

  -h, --help
          Print help (see a summary with '-h')

Set one or more admitted user-owned defaults, then refresh effective configuration and generated workflow guidance. Repository authority indexes, derived scopes, and Plan-binding internals 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 owns workflow/task/change scopes 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 a non-empty default local user/display name for review actions.

      --user-email <USER_EMAIL>
          Set a non-empty default local user email for review actions.

      --json
          Emit the complete machine-readable effective configuration after the update.

  -h, --help
          Print help (see a summary with '-h')

Delete exactly one admitted optional override from authoritative root 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. Repository authority indexes, workflow-mode, sprint, derived scopes, and Plan-binding internals cannot be unset.

Usage: ait config unset [OPTIONS] <KEY>

Arguments:
  <KEY>
          Admitted optional user override 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')