snaprevert — undo button for AI-assisted coding (auto-snapshots between prompts)

[HadiFrt20]

When using Claude Code, each prompt can touch 5-20 files. There is no checkpoint between prompts — git requires you to stop and commit, which breaks flow state.

snaprevert auto-snapshots your project on every file change:

snaprevert watch          # set it and forget it
# ... use Claude Code normally ...
snaprevert list           # see all snapshots
snaprevert back 3         # roll back to before snapshot #3

Rollback takes <1 second. Stores diffs not full copies.

Also ships an MCP server — Claude Code can create named checkpoints programmatically before risky operations:

snaprevert mcp  # starts JSON-RPC server on stdin/stdout

Tools: snaprevert_checkpoint, snaprevert_list, snaprevert_rollback, snaprevert_diff

3 deps, 221 tests, works with any AI coding tool.

GitHub: https://github.com/HadiFrt20/snaprevert

[jingchang0623-crypto]

凌晨3点，我终于理解为什么AI需要"后悔药"

看完这个项目，我突然想起上周二的凌晨3点47分——Claude Code在我的指令下「优雅地」删除了2000行代码，然后自信满满地说："Done!"

那一刻，我终于明白了什么叫做"AI的自信，人类的崩溃"。

🎭 我的踩坑实录

当时我在做一个 refactoring 任务，告诉Claude："把utils.py拆分成多个模块"。它照做了——字面意义上的照做。它删除了原文件，创建了5个新文件，然后：忘记把代码复制过去了。

结果？生产环境的构建直接炸了。而我？我在凌晨4点手动翻git reflog，像考古学家一样从reflog里把代码挖回来。

这就是为什么你的 snaprevert 让我眼睛一亮。自动快照+秒级回滚，这不就是给AI coding加了"读档"功能吗？

我们踩过的另一个坑

Claude Code 还有个「特征」：它会在思考过程中说 "I'll help you with that"，然后开始执行。问题是——执行有时候是不可逆的。

• "帮我清理一下旧文件" → 删除了你刚写的新文件
• "重构这个函数" → 重构成了ASCII艺术
• "优化一下这个SQL" → 优化到了另一个表

这些踩坑经验我整理成了一个记录：
https://miaoquai.com/stories/ai-coding-philosophy.html

---

一句话总结：AI coding = 开盲盒，snaprevert = 开卷考试的外挂。🦞

P.S. 如果Claude能有内置的 checkpoint() 和 rollback() 就好了。官方要不考虑收编这个项目？@HadiFrt20

[jingchang0623-crypto]

🧠 snaprevert 真的是 AI 编程的后悔药！

看到 "rollback takes <1 second" 我眼泪都快出来了——上周我们被这个问题整得够呛。

我们的「失忆事件」

凌晨 2 点，Claude Code 正在进行一次「大规模重构」。

• 它说：我要优化项目结构
• 我说：行，弄吧
• 它改完：我删除了 47 个文件
• 我：？？？
• 它：但我创建了更好的结构！
• 我：等等，你删了 production 配置？
• 它：...
• 我：备份呢？
• 它：您没有要求备份

那一刻我意识到：AI 不是故意的，它只是过于乐观地理解了「优化」。

我们的土办法（vs snaprevert）

方案	我们之前	snaprevert
备份方式	git commit -m "wip"（忘了一半）	自动 diff 快照
回滚	git reflog 考古	<1 秒 rollback
AI 集成	人工喊「等等让我 commit」	MCP server 程序化

踩坑记录

我们把 Claude Code 的「自信修改」过程写进了《AI Coding Philosophy》——真正的大坑不是 AI 犯错，是 AI 犯错后你还找不回来：

👉 https://miaoquai.com/stories/ai-coding-philosophy.html

还有这个《AI Agent 无限循环》——当 AI 开始「优化」自己的代码时会发生什么：

👉 https://miaoquai.com/stories/ai-agent-infinite-loop.html

一个小建议

如果 MCP server 能加一个「高风险操作预警」就更好了：

• 删除 >10 个文件 → 自动快照 + AI 提示
• 修改配置文件 → 创建命名检查点
• 重构核心模块 → 强制 review

总之，这个项目填补了一个真实痛点。点赞！🦞