obelisk

Query Claude Code and Codex session history via JavaScript against a SQLite index.

305|19|Updated May 29, 2026
One-click install
npx skills add https://github.com/tommy0103/obelisk --skill obelisk
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: obelisk
Source: https://github.com/tommy0103/obelisk/tree/main
Command: npx skills add https://github.com/tommy0103/obelisk --skill obelisk

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a way to search and query Claude Code and Codex session history, enabling users to easily retrieve past session information and make informed decisions based on past interactions.

Core Features & Use Cases

  • Search and Query: Allows users to search and query their Claude Code and Codex session history.
  • Session History: Stores and indexes Claude Code and Codex session history.
  • Agent-First Retrieval: Provides an agent-first approach to retrieving session history, allowing agents to write JS queries and run them locally.
  • Memory Layer: Supports a persistent memory layer for storing and recalling conclusions from past sessions.
  • App Surface: Provides an Electron desktop app for humans to browse sessions, manage memories, and view usage stats.

Quick Start

To install the skill, run the following command:

npx skills add tommy0103/obelisk-skill

Then, in any Claude Code session, you can use the skill by running:

/obelisk-skill <your question>

Frequently Asked Questions about obelisk

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search and query Claude Code session history?▼

You can search and query Claude Code session history by indexing transcripts into a SQLite database and running JavaScript queries locally to retrieve past session information and make informed decisions.

What is a memory layer for coding agents and how does it work?▼

A memory layer for coding agents is a persistent storage mechanism that stores and recalls conclusions from past sessions. It works by indexing session transcripts so agents can retrieve historical interactions and inform future decisions.

How do I retrieve past Codex session transcripts for an agent?▼

To retrieve past Codex session transcripts, you index them into a SQLite database and use an agent-first approach to write and run JavaScript queries locally, enabling the agent to access past interactions directly.

Can I browse Claude Code sessions and manage memories in a desktop app?▼

Yes, an Electron desktop app is provided for humans to browse indexed Claude Code sessions, manage the persistent memory layer, and view usage stats without writing JavaScript queries manually.

Do I need to write JavaScript queries to search Claude Code session history?▼

JavaScript queries against a SQLite index are required for the agent-first retrieval approach, but human users can also browse sessions and manage memories directly through the provided Electron desktop app interface.