Profile
Back to NewsBack
GitHub Trending 7 min
Reader Mode
tommy0103/obelisk: Every past session, subagent, and workflow -- queryable by your agent, browsable by you

tommy0103/obelisk: Every past session, subagent, and workflow -- queryable by your agent, browsable by you


Obelisk indexes your local coding-agent history into one SQLite database and serves it to two audiences:

  • Agents — the obelisk CLI plus an agent skill that teaches coding agents
to search their own session history. The agent writes JS queries, runs them locally, and answers in plain language.
  • Humans — an Electron desktop app to browse sessions, manage memories,
view usage stats, and see weekly recap cards.

Both read the same ~/.obelisk/obelisk.sqlite, kept fresh by watching every configured provider directory.

20K lines of scattered JSONL → something your agent can search() and sql() against in milliseconds.

Use it from your agent

Obelisk skill demo

/obelisk 上次 auth bug 最后到底改了哪些文件,为什么这么改
/obelisk 这个文件最近在哪些 sessions 里被反复修改
/obelisk 找出最近失败的 tool calls,它们分别发生在哪些任务里
/obelisk 那个 review workflow 的 subagents 各自结论是什么
/obelisk recap this week

Install

Install with your agent (recommended)

The shortest path is to give the bootstrap guide directly to a coding agent with shell access. Paste this as a prompt into Claude Code, Codex, or another agent — not into your terminal:

Install Obelisk by fetching and following this guide:
curl -fsSL https://raw.githubusercontent.com/tommy0103/obelisk/main/SKILL.md

The agent will ask before changing your machine, install and verify the CLI, then ask whether the formal /obelisk skill should be installed for the current project or globally. The bootstrap guide is only for one-time setup; it is not the query skill itself.

Install manually

Obelisk requires Node.js 22.13 or newer. Install the platform-neutral CLI (zero runtime npm dependencies — it uses Node's built-in SQLite):

npm install --global @obelisk-apps/cli
obelisk --version

On macOS, Linux, or WSL, the CLI-only installer is equivalent:

curl -fsSL https://raw.githubusercontent.com/tommy0103/obelisk/main/install.sh | sh

Then install the agent skill:

obelisk install

obelisk install delegates to the standard skills installer for tommy0103/obelisk-skill. Then in any agent session: /obelisk . First run builds the index (~5 seconds for 100 sessions); after that it rebuilds incrementally.

How it works

You ask a question
  ↓
Agent writes a JS query against the SQLite index
  ↓
Runs it via obelisk --query <script>
  ↓
Reads the JSON result, answers in natural language

Default query surface (CLI 0.3.0+): overview(), sessions(), search(), messages(), memories(), summaries(), and sql(). Specialized helpers and legacy script globals remain available. Signatures, options, and query patterns live in the API reference.

Memory layer

When a retrieval produces a conclusion worth keeping, the agent proposes a markdown memory file. After your approval, it registers the file with obelisk --attune Chat with me