重启不丢 agent 会话：tmux-restore 让 Claude Code 断点续聊

跑着 Claude Code 的 tmux 会话，最怕的就是重启——机器一关，窗口布局没了是小事，agent 聊到一半的对话断了才是大事。一个刚上了 HN 首页的 Show HN 项目 tmux-restore 专治这个：重启后不仅 tmux 的会话、窗口、分屏、工作目录、滚动历史完整回来，跑在里面的 coding agent 还会重新打开当时所在的同一段对话，带着原来的参数接着干。

先给体量：仓库 andrewboldi/tmux-restore，MIT 协议，32 星、0 fork，创建于 2026 年 10 月 31 日、仅 6 次提交——很早期。

怎么做到的

两层配合，各干各的擅长：

1. 每分钟保存一次，关机瞬间再保存一次（Linux 用 systemd、macOS 用 launchd 的后台服务）；
2. 恢复时先由 tmux-resurrect + tmux-continuum 把布局与滚动历史放回来——这是它站着的肩膀，不是作者重写了 tmux 恢复；真正的新东西是各 agent 的小适配器：从 agent 自己的会话文件里找到对话 ID、拼出恢复命令重新打开。

安全边界：危险操作不自动重跑

恢复策略里有一条很关键的克制：有风险的操作不会自动重跑。编辑器与监控类进程会直接重启；其他的——部署、开发服务器等——只会以待输入状态打在命令行上，等人按回车才执行。断点续聊不该等于"无人值守重放"。

支持范围与安装

支持 5 个 agent：Claude Code、Codex、Gemini CLI、opencode、pi——就这五个，别当成"所有 agent 都行"。安装是一行 curl -fsSL …/install.sh | bash，会自动装好缺失的 tmux、TPM 与插件并全部打开；再跑一次即更新。想接新 agent，适配器就是一个短文件，CONTRIBUTING 里有说明。

两句提醒

① 32 星、6 次提交，很早期，生产主力机慎用，先在副机试；② 安装方式是 curl 管道直接进 bash——这是信任作者脚本的做法，愿不愿意信、要不要先读一遍脚本，读者自己定，本文不替这个安装方式背书。

参考来源

• 仓库：https://github.com/andrewboldi/tmux-restore