obelisk

Solid

Search and query past Claude Code, Codex, Kimi Code, and Pi session history. Reactive: when the user asks "how did I fix X", "what did we do last time", "find the session where", "上次怎么修的", "之前的session", "历史记录". Proactive: when the user references past work you lack context for, when you're about to modify a file with complex edit history, when the user says "继续之前的" or "continue where we left off", or when understanding prior decisions would improve your current response. Memory: when the user says "记住这个", "remember this", "写入记忆", "save this conclusion", or when you determine a retrieval result contains a conclusion worth persisting.

Data & Documents 954 stars 61 forks Updated yesterday AGPL-3.0

Install

View on GitHub

Quality Score: 91/100

Stars 20%
99
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# obelisk Search and query local Claude Code, Codex, Kimi Code, and Pi session history. Obelisk indexes sessions, messages, tool calls, tool results, summaries, subagents, workflows, workflow agents, parent chains, and raw JSONL lines into SQLite + FTS5. Obelisk has four transcript sources. Treat all of them as ordinary sessions by default: Claude rows use `source='claude'`, Codex rows use `source='codex'`, Kimi Code rows use `source='kimi'`, and Pi rows use `source='pi'`. Use `source` only when provenance matters or the user asks to scope to one provider. Provider-specific records are projected into the same canonical tables; some providers may not emit every kind of subagent or workflow metadata. Obelisk is a CodeAct memory layer: write a small JS query, run it locally, read the JSON, then answer. Do not turn history into a flat document or browse entire sessions by default. ## Fresh Index and Sandbox Permissions Treat a successful Obelisk invocation as a precondition for using its results. Obelisk refreshes `~/.obelisk/obelisk.sqlite` before retrieval so the answer includes the latest sessions and can identify the invoking session. Never degrade to a stale, read-only index when that refresh cannot write. In Codex `workspace-write` or managed sandboxes, `~/.obelisk` may be outside the writable roots. If an Obelisk command fails with `SQLITE_READONLY`, `EACCES`, `EPERM`, `attempt to write a readonly database`, or another permission error for `~/.obelisk`, rerun the sam...

Details

Author
tommy0103
Repository
tommy0103/obelisk
Created
5 months ago
Last Updated
yesterday
Language
JavaScript
License
AGPL-3.0

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Listed

session-retrace

Find a past AI coding conversation from a fuzzy memory — "the session where we fixed the redirect" — across Qoder, Claude Code, Codex and Gemini CLI. Searches the transcript files those tools already keep on disk, ranks sessions with verbatim evidence and a session ID, then prints the chosen chat. Use when the user cannot find an earlier session, asks which chat covered something, asks to search past sessions or conversation history, or wants to reopen a conversation from a rough recollection. Not for searching code or project files (use Grep), summarizing the conversation already open, or durable project memory (use the workspace memory index).

0 Updated today
arm-pz
AI & Automation Listed

session-recall

Search the unified local history of past Claude Code and Codex sessions at the START of a task when the user references a prior bug, feature, decision, file, or piece of work. Use before assuming fresh context for prompts such as "remember when…", "we worked on…", "the X bug", "back to…", "what did we decide about…", or any task that plausibly has history.

13 Updated 2 days ago
AbsoluteMode
AI & Automation Listed

obsidian-search

Search past Claude session logs and captures in the Obsidian vault. Use when someone says "find my notes about X", "search obsidian", "what did I log about X", "find that capture", "look up session from last week", "search my Claude notes". Returns matching entries with excerpts and wikilink references. Read-only.

8 Updated 1 months ago
chuckplayer