这是什么
Wake 是一个本地优先的桌面应用,由 Rust + GPUI 构建。它把所有 AI 编码代理(如 Claude Code、Codex、Cursor 等)的会话历史集中到一个统一的界面中,支持浏览、全文搜索、一键恢复到终端继续工作。数据完全本地存储,仅在你主动检查更新时才会访问网络。

项目由 iamcorey 开发,采用 MIT 协议,最新版本 v0.8.6,目前已在 GitHub 上获得 1422 个 Star、92 个 Fork,开放 5 个 Issue,社区活跃。
适合谁
经常使用多个 AI 编程助手的开发者、技术团队,以及希望系统管理和检索过往会话的用户。
如果你同时使用 Claude Code、Codex、Cursor 等多个工具,Wake 能帮你告别在多个目录中手动翻找历史记录的困扰。
能做什么
- 统一浏览:所有会话按代理/项目分组,支持实时文件监听增量更新,Grok Build 子代理会嵌套在父会话下。
- 全文搜索(⌘K / Ctrl+K):基于 SQLite FTS5 三字母索引,中文和代码子串(如
useEffect()都能有效检索,并直接跳转到匹配消息。 - 会话查看:每条消息渲染清晰,含用户/助手气泡、内嵌图片(可复制或保存)、可折叠工具调用簇、思考摘要、30+ 语言代码高亮。
- 一键恢复:在终端中重新打开会话(macOS 支持 Terminal/iTerm,Linux/Windows 原生终端),执行
claude --resume、codex resume等命令。 - 管理功能:星标/置顶(存储在 Wake 自己的数据库中,不修改原始文件)、导出 Markdown 或保存图片、删除(移入系统废纸篓加墓碑,避免恢复)。
- 洞察统计:GitHub 风格活动热力图、小时/星期/月份分布、代理/项目/模型排行榜(按会话数、令牌数、提示数切换)。
- 远程主机:通过 SSH 镜像其他机器上的会话,带
@host徽标,支持搜索和复制 SSH 命令恢复。 - MCP 集成:内置只读 MCP 服务器
wake-mcp,让 Claude Code、Codex、Cursor 等 MCP 客户端搜索全部历史、读取会话,新代理可以无缝接手之前的任务。 - 命令行工具:
wake-cli提供同样功能,可通过 shell 脚本调用,如wake-cli sessions --project "$PWD"、wake-cli search "…"、wake-cli show。
使用前准备
- 系统要求:macOS 14+ 为优先支持;Linux 和 Windows 为实验性支持(自 v0.2.5 和 v0.2.7 起)。
- 需要安装 Wake 应用本体,可从 GitHub Releases 下载最新版本 v0.8.6。
- 若要通过 MCP 或 CLI 集成,请确保已安装对应的 Agent 客户端。
安装方法
通过 GitHub Releases 下载对应平台的安装包安装。同时,你也可以通过 npx 安装 Wake 的 skill,让 Agent 自动识别并调用:
npx skills add iAmCorey/Wake
安装后,Wake 会自动扫描本机常见 Agent 的会话目录,并在启用时保持索引最新。
使用示例
启动 Wake 后,主界面会按代理/项目分组展示所有会话。在搜索框输入关键词,即可快速找到历史对话;点击会话可查看完整记录;点击“恢复”按钮,可一键在终端中继续该会话。例如,在 Claude Code 中配置 MCP:
claude mcp add --scope user wake -- "/Applications/Wake.app/Contents/MacOS/wake-mcp"
在 Codex 中,可在 ~/.codex/config.toml 添加:
[mcp_servers.wake]
command = "/Applications/Wake.app/Contents/MacOS/wake-mcp"
风险与注意事项
- 数据安全:Wake 只读访问 Agent 数据,不修改原始文件,所有数据保留在本机。
- 支持范围:不支持的 Agent 包括 Windsurf、Trae(数据加密)、Amp、Factory (Droid)、Warp(云端会话)等。
- 远程主机同步需要预先配置 SSH 无密码登录和 rsync(macOS 和多数 Linux 自带,Windows 需自行安装)。
- Windows 用户需注意 rsync 与 SSH 的来源一致性,建议使用 Cygwin/cwRsync 的 bin 目录置于 PATH 前。
- 本工具为实验性支持,可能出现兼容性问题,请根据官方文档调整配置。