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

Create, inspect, publish, or close Task-owned Changes.

Usage: ait change <COMMAND>

Commands:
  create   Create an additional Change for an existing Task.
  list     List open Changes or complete Change history locally or on a remote.
  show     Inspect one Task-owned Change without changing 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 finishing 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 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             Create the Change locally even when Change commands default to a remote.
      --remote <REMOTE>   Create the Change on the named remote even when Change commands default to local.
      --json              Emit stable machine-readable JSON.
  -h, --help              Print help

List open Changes or complete Change history locally or on a remote.

Usage: ait change list [OPTIONS]

Options:
      --local            List local Changes even when Change commands default to a remote.
      --remote <REMOTE>  List Changes from the named remote even when Change commands default to 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-owned Change without changing it.

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

Arguments:
  <TASK_ID/C-##>  Task-owned Change reference; a bare C-## is accepted only when it identifies one Change.

Options:
      --local            Read the local Change even when Change commands default to a remote.
      --remote <REMOTE>  Read the Change from the named remote even when Change commands default to 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 change remote data.

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

Arguments:
  <TASK_ID/C-##>
          Task-owned 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
          Read the Change's local history even when Change commands default to a remote.

      --remote <REMOTE>
          Read the Change's history from the named remote; only local workspace files are changed.

      --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, finish the Change, or change remote data.

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

Arguments:
  <TASK_ID/C-##>
          Task-owned 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
          Read the Change's local history even when Change commands default to a remote.

      --remote <REMOTE>
          Read the Change's history from the named remote; only local workspace files are changed.

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

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

Archive one local or remote Change without applying its code to the target Line. A successful close also attempts a bounded safe Plan repair for the owning Task.

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

Arguments:
  <TASK_ID/C-##>
          Task-owned Change to archive without applying it to the target Line.

Options:
      --local
          Archive the local Change even when Change commands default to a remote.

      --remote <REMOTE>
          Archive the Change on the named remote even when Change commands default to 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 finish the Change.

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

Arguments:
  <TASK_ID/C-##>
          Local Task-owned 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')