ait stash — 完整参考
记录、查看、应用并删除本地未完成工作的 stash 条目。
适用人群： 开发者与 coding agent
作用边界#
用途： 记录、查看、应用并删除本地未完成工作的 stash 条目。
影响类别： 改动本地 stash 和工作区；list 和 show 为只读。
覆盖： ait stash 下共 7 个公开 help surface。
下面的代码块原样保留 1.1.1 二进制的输出，包含它给出的每一个参数、选项、 默认值、可选值、冲突关系和必填要求。
完整命令树#
ait stash
ait stash save
ait stash list
ait stash show
ait stash apply
ait stash pop
ait stash drop原样输出的 help#
ait stash#
二进制描述： 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.
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')说明
暂存、查看、恢复和丢弃临时的仅本地工作区 Snapshot，不推进 Line head。stash 仅当其来源 Line 为当前 Line 时才能恢复。
| 参数 / 选项 | 说明 |
|---|---|
save | 将已修改的工作区内容保存为临时的仅本地 stash。 |
list | 列出活动的仅本地 stash 元数据，不改变工作区。 |
show | 查看一个活动的仅本地 stash 的元数据。 |
apply | 恢复一个同 Line 的 stash 并保留其 stash 记录。 |
pop | 恢复一个同 Line 的 stash，然后丢弃其 stash 记录。 |
drop | 丢弃一条活动的 stash 记录，不改变工作区内容。 |
help | 打印本消息或给定子命令的帮助 |
ait stash save#
二进制描述： 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 files in place.
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 files in place.
Usage: ait stash save [OPTIONS]
Options:
--message <MESSAGE>
Record an optional human-readable message with the stash.
--keep-workspace
Leave the saved files in the workspace; 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')说明
把受管工作区的改动内容保存为临时、仅本地的 stash Snapshot，不推进当前 Line head。默认在保存后把当前 Line head 恢复到工作区；--keep-workspace 会把已保存文件留在原处。
ait stash list#
二进制描述： List active local-only stash metadata without changing the workspace.
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说明
列出活动的仅本地 stash 元数据，不改变工作区。
| 参数 / 选项 | 说明 |
|---|---|
--json | 输出完整的机器可读 JSON 结果。 |
-h, --help | 打印帮助 |
ait stash show#
二进制描述： 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.
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')说明
查看一个活动的仅本地 stash 的元数据，不改变工作区。此命令报告 stash 记录和 Snapshot 摘要；不显示内容 diff。
ait stash apply#
二进制描述： 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 restores the complete workspace rather than applying a patch or three-way merge.
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 restores the complete workspace rather than applying 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')说明
用一个活动 stash Snapshot 替换整个受管工作区，保留其 stash 记录，并且不移动当前 Line head。当前 Line 必须是 stash 的来源 Line。此操作恢复完整工作区，而不是应用 patch 或三方合并。
ait stash pop#
二进制描述： 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 restores the complete workspace rather than applying a patch or three-way merge.
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 restores the complete workspace rather than applying 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')说明
用一个活动 stash Snapshot 替换整个受管工作区，只在成功恢复后删除其 stash 记录，并且不移动当前 Line head。当前 Line 必须是 stash 的来源 Line。此操作恢复完整工作区，而不是应用 patch 或三方合并。
ait stash drop#
二进制描述： Drop an active stash record without changing workspace content.
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说明
丢弃一条活动的 stash 记录，不改变工作区内容。
| 参数 / 选项 | 说明 |
|---|---|
<STASH_ID> | 确切的活动 stash ID。 |
--json | 输出完整的机器可读 JSON 结果。 |
-h, --help | 打印帮助 |