sesame

Search coding-agent sessions with local BM25 full-text search (SQLite FTS5).

What it does

• indexes session files (currently pi JSONL)
• stores normalized session/chunk data in SQLite
• supports concept-style search beyond exact grep
• supports tool-oriented filters (--tools, --tool, --path)

Quickstart (repo)

pnpm install
pnpm run build

Index sessions:

pnpm run dev index

Search:

pnpm run dev search "nix infra simplify"
pnpm run dev search "package.json exports" --tools --tool write

Check index:

pnpm run dev status

CLI docs

See docs/cli-usage.md.

Internals docs

• indexing flow: docs/indexing.md
• library/API usage: docs/library-usage.md
• docs index: docs/README.md

Pi integration

Monorepo packages:

• packages/pi/ (@aliou/sesame-pi): pi coding agent extension exposing the sesame_search tool.
• packages/skills/sesame-cli/ (@aliou/sesame-skill-cli): pi skill for the Sesame CLI.

Development

pnpm run lint
pnpm test
pnpm run typecheck