tommy0103/obelisk

这是什么？

核心功能

• 01将多个编程智能体的会话、消息、工具调用和子智能体索引进同一个 SQLite 文件。
• 02基于 FTS5 对所有已索引内容进行全文检索。
• 03智能体通过 obelisk 命令行查询历史，提供概览、会话、搜索和 SQL 等函数。
• 04可将结论登记为 Markdown 记忆文件，供智能体在后续会话中调用。
• 05桌面应用支持会话浏览、用量热力图，以及可分享的周报或月报卡片。

适用场景

• 让编程智能体回溯早前会话中改过哪些文件以及原因。
• 查找最近失败的工具调用，并定位它们发生的任务。
• 回看过去某个代码审查工作流中各子智能体得出的结论。
• 汇总一周内跨多个编程智能体工具的编码活动。

快速上手

1. 1

   使用 npm 安装命令行工具（需要 Node.js 22.13 或更新版本）

   npm install --global @obelisk-apps/cli
2. 2

   验证命令行工具是否安装成功

   obelisk --version
3. 3

   安装智能体技能

   obelisk install
4. 4

   在智能体会话中使用 /obelisk 提问（首次运行会构建索引）

使用前须知

• !采用 AGPL-3.0 许可证，这是一种著作权传递许可证，衍生作品需以相同条款发布。
• !需要 Node.js 22.13 或更新版本。
• !桌面应用的预构建版本仅提供 macOS 和 Linux amd64；其他平台需要从源码运行应用。

收录于专题

标签

常见问题

obelisk 是什么？

把本地多款编程智能体的会话历史索引进一个 SQLite 数据库，供智能体查询，也供人浏览。 Obelisk 把 Claude Code、Codex、GitHub Copilot、Kiro、Kimi Code、OpenCode、Pi、ZCode 等编程智能体留在本地的历史记录汇总到一个 SQLite 数据库（位于 ~/.obelisk/obelisk.sqlite）中。会话、消息、工具调用、子智能体、摘要和工作流都被整理进统一的表结构，并支持 FTS5 全文检索，后台监听会持续更新索引。

obelisk 可以免费使用吗？用的什么许可证？

obelisk 以 AGPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。

obelisk 还在维护吗？

活跃维护中。obelisk 最近一次提交是在 2026年11月1日。

obelisk 适合用来做什么？

让编程智能体回溯早前会话中改过哪些文件以及原因。 查找最近失败的工具调用，并定位它们发生的任务。 回看过去某个代码审查工作流中各子智能体得出的结论。 汇总一周内跨多个编程智能体工具的编码活动。

obelisk 怎么安装和运行？

使用 npm 安装命令行工具（需要 Node.js 22.13 或更新版本）: npm install --global @obelisk-apps/cli 验证命令行工具是否安装成功: obelisk --version 安装智能体技能: obelisk install 在智能体会话中使用 /obelisk 提问（首次运行会构建索引）

在哪里获取 obelisk？

源代码和安装说明在 GitHub 上：https://github.com/tommy0103/obelisk