ait stash — Complete Reference

ait stash
ait stash save
ait stash list
ait stash show
ait stash apply
ait stash pop
ait stash drop

Park, inspect, restore, and drop temporary local-only workspace Snapshots without advancing Line heads. A stash can be restored only while its source Line is current.

Usage: ait stash <COMMAND>

Commands:
  save   Save modified workspace content as a temporary local-only stash.
  list   List active local-only stash metadata without changing the workspace.
  show   Inspect metadata for one active local-only stash.
  apply  Restore a same-Line stash and retain its stash record.
  pop    Restore a same-Line stash and then drop its stash record.
  drop   Drop an active stash record without changing workspace content.
  help   Print this message or the help of the given subcommand(s)

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

Save modified managed-workspace content as a temporary local-only stash Snapshot without advancing the current Line head. By default, restore the current Line head into the workspace after saving; --keep-workspace leaves the saved content materialized.

Usage: ait stash save [OPTIONS]

Options:
      --message <MESSAGE>
          Record an optional human-readable message with the stash.

      --keep-workspace
          Leave the saved content materialized; the Line head stays unchanged, so the workspace remains dirty relative to it.

      --json
          Emit the complete machine-readable JSON result.

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

List active local-only stash metadata without changing the workspace.

Usage: ait stash list [OPTIONS]

Options:
      --json  Emit the complete machine-readable JSON result.
  -h, --help  Print help

Inspect metadata for one active local-only stash without changing the workspace. This command reports the stash record and Snapshot summary; it does not display a content diff.

Usage: ait stash show [OPTIONS] <STASH_ID>

Arguments:
  <STASH_ID>
          Exact active stash ID.

Options:
      --json
          Emit the complete machine-readable JSON result.

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

Replace the entire managed workspace with an active stash Snapshot and retain its stash record, without moving the current Line head. The current Line must be the stash's source Line. This is full workspace materialization, not a patch or three-way merge.

Usage: ait stash apply [OPTIONS] <STASH_ID>

Arguments:
  <STASH_ID>
          Exact active stash ID created on the current Line.

Options:
      --force
          Overwrite unsaved managed-workspace changes; this does not permit restoring a stash from another Line.

      --json
          Emit the complete machine-readable JSON result.

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

Replace the entire managed workspace with an active stash Snapshot and drop its stash record only after a successful restore, without moving the current Line head. The current Line must be the stash's source Line. This is full workspace materialization, not a patch or three-way merge.

Usage: ait stash pop [OPTIONS] <STASH_ID>

Arguments:
  <STASH_ID>
          Exact active stash ID created on the current Line.

Options:
      --force
          Overwrite unsaved managed-workspace changes; this does not permit restoring a stash from another Line.

      --json
          Emit the complete machine-readable JSON result.

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

Drop an active stash record without changing workspace content.

Usage: ait stash drop [OPTIONS] <STASH_ID>

Arguments:
  <STASH_ID>  Exact active stash ID.

Options:
      --json  Emit the complete machine-readable JSON result.
  -h, --help  Print help