在opencode等vibing coding工具使用过程中，我们常常会遇到需要回滚的场景，例如执行undo指令可以恢复上下文，并且还原此次对话设计的相关文件。同样的，Kiro CLI 也提供了两种不同层面的回滚能力工作区文件回滚和对话消息回滚。但是并没有提供开箱即用的方法。
/checkpoint 工作区文件回滚
是一个实验性功能，kiro通过在后台创建 shadow bare git repo 来追踪工作区文件变更，支持创建快照并恢复到之前的状态。
可以使用如下命令启用
kiro-cli settings chat.enableCheckpoint true
实际上会在配置文件添加如下配置
$ cat ~/.kiro/settings/cli.json
{"chat.enableCheckpoint": true
}
常用命令如下，需要注意的是两种回滚的区别
- 默认模式：回退已跟踪的变更和删除，但保留检查点之后新建的文件
- 硬恢复（
--hard）：完全匹配检查点状态，会删除检查点之后新建的文件
| 命令 | 说明 |
|---|---|
/checkpoint init |
手动创建检查点 |
/checkpoint list |
查看所有检查点 |
/checkpoint restore |
交互式选择检查点并恢复 |
/checkpoint restore <tag> |
恢复到指定检查点（如 2 或 2.1） |
/checkpoint restore <tag> --hard |
硬恢复，完全匹配检查点状态 |
/checkpoint diff |
查看当前状态与检查点的差异 |
/checkpoint clean |
清理旧检查点 |
检查点的创建粒度如下
- 每个对话轮次自动创建一个检查点
- 每次工具调用会创建子检查点
/tangent forget对话消息回滚
/tangent forget 用于从对话历史中移除最近的消息，属于对话上下文层面的回滚。
可以使用如下命令启用
kiro-cli settings chat.enableTangentMode true
常用命令如下
| 命令 | 说明 |
|---|---|
/tangent forget 2 |
删除最近 2 条消息 |
/tangent forget |
交互式选择要回退到哪条消息 |
需要注意的是，/tangent forget 不会恢复已编辑的文件。 它只移除对话记录（用户提问 + 助手回复），不涉及任何文件系统操作。如果需要回滚文件变更，必须使用 /checkpoint restore。
两种回滚方式的对比如下，此外/checkpoint 和 /tangent 不能同时使用，在 tangent 模式下 checkpoint 会被禁用。/tangent forget 删除超过 5 条消息时会弹出警告，且操作不可撤销
| 特性 | /checkpoint restore |
/tangent forget |
|---|---|---|
| 回滚对象 | 工作区文件 | 对话消息 |
| 恢复文件变更 | ✅ 是 | ❌ 否 |
| 清除对话历史 | ✅ 会回退对话 | ✅ 会移除消息 |
| 适用场景 | 代码改错了想还原 | 对话跑偏了想重来 |