iAmCorey/Wake · 上手攻略

  • 仓库：iAmCorey/Wake
  • 链接：https://github.com/iAmCorey/Wake
  • 分类：AI Agent · 开发者工具
  • 作者：Tom
  • 更新：2026-08-27

这是什么

Wake 是一个本地桌面应用（Rust + GPUI），将你机器上所有 AI 编程 Agent 的历史会话汇聚到一处——浏览、搜索、一键恢复对话。它读的是你本地的会话文件（.jsonl、.sqlite、.db），不触碰云端数据，所有内容留在本机。

支持抓取的 Agent 包括：Claude Code、Codex CLI、Qoder CLI、Copilot CLI、Cursor（CLI 转录）、OpenCode、Kiro、Pi、Oh My Pi、Grok Build、Kimi Code、Antigravity CLI、DeepSeek Harness（dsh）等。

Stars：582（2026-08-27）

解决什么问题

开发者的 Agent 会话散落在十几种路径里——~/.claude/、~/.codex/、~/.cursor/、~/.qoder/ 等等。想回溯三个月前某个实验性项目里 Claude Code 怎么解决了一个诡异的并发 bug？或者找 Codex 某次会话里提到的设计决策？这些对话在你的机器上，但很难快速找到。

Wake 把这些全部索引起来，提供统一的浏览界面和毫秒级全文搜索，让你「想起有过那次对话」之后，5 秒内定位并恢复它。

快速安装

macOS（推荐）

下载最新 release 中的 Wake-<version>-macos.zip，解压后将 Wake.app 拖入 Applications：

# 预编译包（通用二进制，支持 Apple Silicon + Intel）
# 从 https://github.com/iAmCorey/Wake/releases/latest 下载
# 解压后右键 Wake.app → 选择「打开」（绕过 Gatekeeper 首次拦截）

或者从源码构建（需要 Rust 工具链）：

git clone https://github.com/iAmCorey/Wake && cd Wake
./scripts/make-app.sh          # 构建 dist/Wake.app（ad-hoc 签名）
open dist/Wake.app

注意：预编译版本 ad-hoc 签名，首次运行 macOS Gatekeeper 会拦截，需右键 → 「打开」，或运行：

xattr -d com.apple.quarantine Wake.app

Linux（实验性支持，v0.2.5+）

# 方式一：预编译包（.deb 或 tar.gz）
# 从 https://github.com/iAmCorey/Wake/releases/latest 下载 .deb 或 .tar.gz

# Debian/Ubuntu 安装 .deb：
sudo dpkg -i wake-*.deb

# 或解压 tar.gz（用户级安装，无需 root）：
tar xzf wake-*.tar.gz
cd wake-*/
./install.sh   # 安装到 ~/.local（用户级）

# 方式二：从源码构建
sudo apt-get install -y \
  libasound2-dev libfontconfig1-dev libwayland-dev \
  libxkbcommon-dev libxkbcommon-x11-dev libssl-dev \
  libzstd-dev pkg-config cmake clang

git clone https://github.com/iAmCorey/Wake && cd Wake
./scripts/make-linux.sh

Linux 预编译包 asset 名称使用 Debian 的 amd64 标识（实际指 x86_64）。

Windows（实验性支持，v0.2.7+）

# 预编译包：从 https://github.com/iAmCorey/Wake/releases/latest 下载 .zip
# 解压后运行 Wake.exe（无签名，SmartScreen 首次会拦截，点击「更多信息」→「仍要运行」）

# 从源码构建（需要 Rust MSVC 工具链）：
git clone https://github.com/iAmCorey/Wake; cd Wake
powershell -ExecutionPolicy Bypass -File scripts/make-windows.ps1

核心用法

启动与界面

安装后直接运行 Wake.app，界面顶部侧边栏包含：Browse（浏览）、Search（搜索）、Insights（数据洞察）。

会话浏览（Browse）：按 Agent / 项目分组所有索引到的会话，支持按时间排序，实时监控（mtime 变化自动刷新）。

全文搜索（⌘K / Ctrl+K）：调出搜索框，输入任意文本（支持 CJK 拼音搜索），SQLite FTS5 三元组索引在 ~310 会话 / ~800 MB JSONL 数据量下，搜索响应 <1ms，结果直接跳转到对应消息。

会话恢复（Resume）：点击任意会话，可以一键在原项目目录中用对应 Agent 恢复对话。macOS 打开 Terminal/iTerm，Linux 打开系统默认终端，Windows 打开 Windows Terminal / PowerShell / CMD / Alacritty / WezTerm。

数据源支持一览

Agent 会话路径 模型信息 启动来源
Claude Code ~/.claude/projects/**/*.jsonl ✅ —
Codex CLI ~/.codex/sessions + state_5.sqlite ✅ ✅
Qoder CLI ~/.qoder/projects/*/*.jsonl ✅ —
Copilot CLI ~/.copilot/session-store.db — —
Cursor（CLI） ~/.cursor/projects/**/agent-transcripts — —
OpenCode ~/.local/share/opencode/opencode.db ✅ —
OpenCode 2 ~/.local/share/opencode/{opencode.db, opencode-next.db} ✅ —
Kiro ~/.kiro/sessions/cli ✅ —
Gemini CLI ~/.gemini/tmp/**/chats — —
Pi ~/.pi/agent/sessions/**/*.jsonl ✅ —
Oh My Pi ~/.omp/agent/sessions/**/*.jsonl ✅ —
Grok Build ~/.grok/sessions/**/updates.jsonl ✅ —
Kimi Code ~/.kimi-code/sessions/**/wire.jsonl — —
Antigravity CLI ~/.gemini/antigravity-cli/conversation_summaries.db —（仅元数据） —
DeepSeek Harness ~/.dsh/sessions/**/session.jsonl[.zstd] ✅ —

注：「—」表示该 Agent 数据源本身不记录此字段，并非功能缺失。

⚠️ Cursor IDE 聊天、Windsurf、Trae 等使用加密本地存储；Amp、Factory（Warp）等将数据存在云端，均不支持。

Insights 页面（v0.2.x 新增）

  • GitHub 风格热力图：按日展示过去一年的提示活动，当前连续 streak、最长 streak、最活跃日。
  • 维度切换：按时/工作日/月份拆解活动分布。
  • 排行榜：Agents / Projects / Models 三个维度，可按会话数、Token 数、提示数排序。

项目架构与索引

Wake 数据存储路径：
  macOS: ~/Library/Application Support/wake/wake.db
  Linux:  ~/.local/share/wake
  Windows: %LOCALAPPDATA%\wake\wake.db

索引可随时重建（stars/pins 单独存储，重建不丢失）：
  Wake 设置 → Data → Rebuild Index

索引性能（作者本机 ~310 会话 / ~800 MB JSONL）： - 首次全量索引：约 5 秒 - 后续启动：基于 mtime 增量扫描，几乎瞬间 - 搜索延迟：<1ms

开发命令（从源码构建时）

# 开发模式运行
cargo run -p wake

# 全量测试（数据层 + UI 编译门禁）
./scripts/test.sh

# 冒烟测试（包含真实数据扫描，只读）
./scripts/test.sh --smoke

# 仅数据层测试
cargo test -p wake-core

# 数据层冒烟扫描（打印统计信息）
cargo run -p wake-core --bin scan

# 带搜索关键词的冒烟测试
cargo run -p wake-core --bin scan -- --search "useEffect("

典型适用场景

  1. 回溯调试：某次 Claude Code 解决的并发 bug，想恢复那个对话继续深挖。
  2. 跨 Agent 比对：对比 Claude Code、Codex、OpenCode 在同一个项目上的解决思路差异。
  3. 项目回顾：交接时快速浏览某个项目所有 Agent 对话，还原决策历程。
  4. Token 消耗审计：Insights 页查看各 Agent 的 Token 使用分布（需 Agent 数据源本身记录）。
  5. 会话归档：star / pin 重要会话，导出为 Markdown 存档。

坑与注意

⚠️ macOS 首次启动拦截：预编译版 ad-hoc 签名，右键 → 「打开」是唯一方式，运行 xattr -d com.apple.quarantine 也可。

⚠️ Linux/Windows 仍为实验性：数据层和搜索已全面测试；终端恢复（Resume）和桌面集成功能在非 macOS 平台实际使用经验较少，发现问题欢迎提 issue。

⚠️ 加密 Agent 不支持：Cursor IDE、Windsurf、Trae 等加密本地数据；Amp、Factory（Warp）等云端存储，均无法索引。

⚠️ Agent 数据只读：Wake 不会向任何 Agent 的数据文件或数据库写入内容，Credential 文件（auth.json 等）也明确不读取。

⚠️ 网络请求极简：唯一网络请求是用户主动触发的更新检查（查询 GitHub Release 元数据），会话数据不会上传任何服务器。

⚠️ 会话目录实时监控：Browse 模式实时监控文件 mtime，新建 / 删除会话会自动同步，但大量文件（>10 万）场景下 mtime 扫描性能建议自行测试。

与同类对比

工具 定位 数据来源 搜索能力 恢复能力
Wake 跨 Agent 会话聚合 本地（只读） SQLite FTS5，<1ms，CJK ✅ 多终端
Claude Code 历史 单 Agent 本地 基础 仅 Claude Code
OpenRouter / 云端面板 云端管理 云端 平台内 ✅
自建脚本（jq + fzf） DIY 方案 本地 定制 手动

Wake 是目前唯一覆盖 15+ 种编程 Agent 的本地会话聚合工具，开源、Rust 实现、索引性能极高。对于多 Agent 并行的开发者，这是目前最接近「Agent 工作台历史记录仪」的方案。

⚠️ 注意：2026 年桌面 Agent 管理工具赛道火热（Windsurf、Cursor、Conductor、Crystal 等），Wake 的差异化在于「工具无关聚合」——它不取代任何 Agent，而是做跨 Agent 的历史索引，这个定位目前无直接竞品。

一句话推荐结论

如果你同时在用 Claude Code、Codex 或其他多个编程 Agent，想把散落在十几个目录里的历史会话变成可搜索、可恢复的知识库，Wake 是目前最省事的方案——本地运行、不上传数据、安装简单、用完你会后悔没早装。