tommy0103/obelisk

What is it?

Key features

• 01Indexes sessions, messages, tool calls and subagents from multiple coding-agent providers into one SQLite file.
• 02Full-text search across all indexed layers via FTS5.
• 03Agents query history through the obelisk CLI with overview, sessions, search and sql helpers.
• 04Register conclusions as markdown memory files that agents recall in later sessions.
• 05Desktop app with session browsing, usage heatmaps, and shareable weekly or monthly recap cards.

Use cases

• Asking a coding agent which files it changed in an earlier session and why.
• Finding recent failed tool calls and the tasks where they happened.
• Reviewing what each subagent in a past review workflow concluded.
• Generating a weekly summary of coding activity across several agent tools.

Quick start

1. 1

   Install the CLI with npm (requires Node.js 22.13 or newer)

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

   Verify the CLI installed correctly

   obelisk --version
3. 3

   Install the agent skill

   obelisk install
4. 4

   In an agent session, ask a question with /obelisk (first run builds the index)

Things to know

• !Licensed under AGPL-3.0, a copyleft license that requires derivative works to be shared under the same terms.
• !Requires Node.js 22.13 or newer.
• !Prebuilt desktop app releases are only provided for macOS and Linux amd64; other platforms must run the app from source.

In collections

Topics

FAQ

What is obelisk?

Indexes local coding-agent session history from many tools into one SQLite database that agents can query and humans can browse. Obelisk collects the local history left behind by coding agents such as Claude Code, Codex, GitHub Copilot, Kiro, Kimi Code, OpenCode, Pi and ZCode, and merges it into a single SQLite database at ~/.obelisk/obelisk.sqlite. Sessions, messages, tool calls, subagents, summaries and workflows are all projected into shared tables, with FTS5 full-text search across them and a watcher that keeps the index updated.

Is obelisk free to use? What license does it have?

obelisk is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.

Is obelisk still maintained?

Actively maintained. The last commit to obelisk was on Nov 1, 2026.

What can I use obelisk for?

Asking a coding agent which files it changed in an earlier session and why. Finding recent failed tool calls and the tasks where they happened. Reviewing what each subagent in a past review workflow concluded. Generating a weekly summary of coding activity across several agent tools.

How do I install obelisk?

Install the CLI with npm (requires Node.js 22.13 or newer): npm install --global @obelisk-apps/cli Verify the CLI installed correctly: obelisk --version Install the agent skill: obelisk install In an agent session, ask a question with /obelisk (first run builds the index)

Where can I get obelisk?

The source code and installation instructions are on GitHub: https://github.com/tommy0103/obelisk