ait change — Complete Reference

ait change
ait change create
ait change list
ait change show
ait change revert
ait change replay
ait change close
ait change publish

Usage: ait change <COMMAND>

Commands:
  create   Create an additional Change for an existing Task.
  list     List the current scope's open Changes or complete history.
  show     Inspect one task-scoped Change without modifying it.
  revert   Remove one Change's recorded delta from the current workspace.
  replay   Apply one Change's recorded delta to the current workspace.
  close    Archive one Change without landing it.
  publish  Promote one local draft Change record to a remote.
  help     Print this message or the help of the given subcommand(s)

Options:
  -h, --help  Print help

Create an additional Change for an existing Task.

Usage: ait change create [OPTIONS] --title <TITLE> <TASK_ID>

Arguments:
  <TASK_ID>  Existing Task ID that will own the new task-scoped Change.

Options:
      --title <TITLE>     Required title for the new Change.
      --base-line <LINE>  Base Line assertion; defaults to the bound worktree target Line, then the repository default Line.
      --local             Use local Change authority even when the configured Change scope is remote.
      --remote <REMOTE>   Use the named remote Change authority even when the configured Change scope is local.
      --json              Emit stable machine-readable JSON.
  -h, --help              Print help

List the current scope's open Changes or complete history.

Usage: ait change list [OPTIONS]

Options:
      --local            List local Changes even when the configured Change scope is remote.
      --remote <REMOTE>  List Changes from the named remote even when the configured Change scope is local.
      --all              Show complete Change history instead of the bounded open view.
      --json             Emit stable machine-readable JSON; the bounded view still applies unless --all is present.
  -h, --help             Print help

Inspect one task-scoped Change without modifying it.

Usage: ait change show [OPTIONS] <TASK_ID/C-##>

Arguments:
  <TASK_ID/C-##>  Task-scoped Change reference; a bare C-## is accepted only when uniquely resolvable.

Options:
      --local            Read local Change authority even when the configured Change scope is remote.
      --remote <REMOTE>  Read the named remote Change authority even when the configured Change scope is local.
      --json             Emit the complete stable machine-readable Change payload.
  -h, --help             Print help

Remove one Change's recorded fork-to-revision delta from the current workspace. This does not create a Snapshot, move the current Line head, close the Change, or mutate remote state.

Usage: ait change revert [OPTIONS] <TASK_ID/C-##>

Arguments:
  <TASK_ID/C-##>
          Task-scoped Change whose recorded delta will be removed from the workspace.

Options:
      --force
          Overwrite unsaved changes on paths selected by the Change delta.

      --dry-run
          Preview affected paths and overwrite risk without modifying the workspace.

      --local
          Resolve Change lineage locally even when the configured Change scope is remote.

      --remote <REMOTE>
          Resolve Change lineage from the named remote; workspace mutation remains local.

      --json
          Emit the complete stable machine-readable workspace plan or result.

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

Apply one Change's recorded fork-to-revision delta to the current Line workspace. This does not create a Snapshot, move the Line head, land the Change, or mutate remote state.

Usage: ait change replay [OPTIONS] <TASK_ID/C-##>

Arguments:
  <TASK_ID/C-##>
          Task-scoped Change whose recorded delta will be applied to the workspace.

Options:
      --force
          Overwrite unsaved changes on paths selected by the Change delta.

      --dry-run
          Preview affected paths and overwrite risk without modifying the workspace.

      --local
          Resolve Change lineage locally even when the configured Change scope is remote.

      --remote <REMOTE>
          Resolve Change lineage from the named remote; workspace mutation remains local.

      --json
          Emit the complete stable machine-readable workspace plan or result.

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

Archive one Change in the selected scope without landing code. A successful close also attempts bounded safe-only Plan reconciliation for the owning Task.

Usage: ait change close [OPTIONS] <TASK_ID/C-##>

Arguments:
  <TASK_ID/C-##>
          Task-scoped Change to archive without landing.

Options:
      --local
          Archive local Change authority even when the configured Change scope is remote.

      --remote <REMOTE>
          Archive Change authority on the named remote even when the configured scope is local.

      --json
          Emit the complete stable machine-readable closeout payload.

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

Promote one local draft Change record to the configured or named remote. This does not publish a Patchset, publish current workspace content, or land the Change.

Usage: ait change publish [OPTIONS] <TASK_ID/C-##>

Arguments:
  <TASK_ID/C-##>
          Local task-scoped draft Change to promote.

Options:
      --remote <REMOTE>
          Destination remote; omitted uses the repository default remote.

      --json
          Emit the complete stable machine-readable publication payload.

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