还在为翻找 Claude Code、Codex 的历史记录而头疼吗？Obelisk 桌面应用把本地各种编码 Agent（coding agent）的历史会话统一索引进一个 SQLite 数据库，让你用鼠标就能搜索、筛选、回看每一条会话，还能管理记忆、查看 token 用量、生成周报卡片——这是目前少有的、专为"Agent 会话管理"而生的本地工具，全程数据不出机器。

1️⃣ Obelisk 是什么？为什么需要它

用编码 Agent 干活时，历史会话散落在各家工具的私有目录里：~/.claude/projects、~/.codex/sessions、~/.dsh/sessions……格式各异、动辄几万行 JSONL，想回忆"上周那个 auth bug 最后怎么改的"几乎不可能。

Obelisk 的做法很直接（见 PRODUCT.md 中的产品定位）：

• 统一索引：把 12 种 Agent 的历史会话——Claude Code、Codex、GitHub Copilot、DeepSeek Harness、Hermes Agent、Kiro、Kimi Code、OMP、OpenCode、Pi、ZCode——投影进同一个本地数据库~/.obelisk/obelisk.sqlite；
• 桌面浏览：Electron 应用提供会话列表、记忆管理、用量统计、周报卡片四大板块（界面实现见 app/src/renderer/src/views/）；
• Agent 可查：同一份索引还能让 Agent 用 JS 查询毫秒级检索自己的历史。

一句话：2 万行散落的 JSONL，变成毫秒级可搜索的会话索引。

🚀 一键安装：预编译包与源码运行两种方式

方式一：直接安装预编译包（推荐新手）

macOS 和 Linux（amd64）都有官方预编译包，在仓库 Releases 页面下载即可。应用内置自动更新：macOS 走 Sparkle，Debian 包走DebUpdater，升级无感。

方式二：从源码运行（适合开发者）

构建需要 Node.js 22.13+，应用本身跑在 Electron 内置的 Node 上：

git clone https://gitcode.com/gh_mirrors/obelisk6/obelisk cd obelisk/app npm ci npm run dev

启动后第一次会自动建立索引（约 100 个会话 5 秒左右），之后后台监听各 provider 目录，自动增量更新，无需手动干预。

💡 提示：桌面应用运行期间独占索引写入权，此时obeliskCLI 处于只读模式，二者可安全并存。

🔍 五大核心界面：浏览、搜索、统计一次配齐

应用的主导航对应 router.js 中的五组路由，逐个来看：

Sessions：会话搜索与项目筛选

这是最核心的界面（SessionList.vue）。你可以：

• 全文搜索任意会话内容，支持按项目、按来源（source）过滤、按时间排序；
• 项目侧边栏一屏看到所有项目及其会话数量，点选即过滤；
• 会话详情把 tool call 可读化展示——diff 变更、终端输出、文件查看器都做了专门渲染，不再是原始 JSON 墙；
• 超长会话采用虚拟滚动渲染（列表约 2915 条消息也依然流畅），万级会话不卡顿。

顶部面包屑会显示"来源项目 → 会话标题"，标题下方是创建时间、最后活跃时间、消息总数和 git 分支，定位一次开发上下文非常高效。

Memory：Agent 记忆管理

当 Agent 从检索中得出值得保留的结论时，会提议写入一个 markdown 记忆文件；你确认后它注册进 packages/core/src/schema.sql 定义的 Memories 表。Memory 界面提供记忆列表与详情，随时可以审查或撤销——它是"结论的缓存"，不会替代原始会话证据。

Activity：GitHub 风格热力图 + Token 用量统计

打开 Activity 页（Activity.vue），你能看到：

• 每日热力图：像 GitHub 贡献图一样按颜色深浅展示每天的 token 消耗；
• 每周柱状图 / 累计曲线：观察你的 Agent 使用节奏；
• Lifetime tokens、峰值日等关键统计一目了然。

Recap：把一周的工作做成可分享卡片

/obelisk recap流程（规范见 skill-doc/references/recap/overview.md）会把一段时间的会话做成 Spotify Wrapped 风格的周报/月报卡片：封面卡、思考卡、氛围卡、工作流卡、收尾卡五种 archetype 主题，桌面端可直接浏览并导出。

Settings：数据源、自动刷新与索引重建

设置页（Settings.vue）能管理：

• 数据源：非默认位置（如 Pi 的自定义目录、VS Code Insiders 的 User 目录）可手动指定；
• 自动刷新开关；
• Rebuild index一键全量重建索引；
• 默认代码编辑器协议（VS Code / Cursor / Windsurf / Zed 等）。

🤖 附赠：同一份索引，Agent 也能查

Obelisk 的另一面是给 Agent 提供obeliskCLI 与 skill：Agent 针对 SQLite 索引现场写一段 JS 查询、本地执行、再用人话回答你。默认查询接口包括overview()、sessions()、search()、messages()、memories()、summaries()和sql()（详见 CONTEXT.md 的运行时接口说明）。

比如直接问"上次 review 出了什么问题"，Agent 会自动检索历史 workflow 会话，输出带文件行号定位的结构化结论——这一切都建立在桌面应用维护的同一份索引上。

❓ 常见问题

📌 总结

Obelisk 桌面应用解决的正是"编码 Agent 历史会话管理"这个空白：一键索引、全文搜索、项目筛选、token 统计、记忆管理、周报卡片，全部本地完成。如果你每天同时开着 Claude Code、Codex 等多个 Agent，强烈建议装上它——让散落的会话变成可查询、可回看、可分享的资产。