Search your past coding-agent sessions. Sesame indexes Pi JSONL session files into a local SQLite FTS5 index and ranks results with BM25, so you can find the session where you fixed that bug or touched that file.
- Ranked full-text search, or browse recent sessions with no query.
- Filters by project directory, date, tool call, file path, and skill.
- A
sesame skillsleaderboard of the skills your sessions loaded. - Watch mode keeps the index current.
- Everything stays local.
With Nix, using the release binaries for macOS (arm64) and Linux (arm64, x64):
nix profile install github:aliou/sesameBinaries are also attached to each CLI release (tags @aliou/sesame-cli@<version>). To use Sesame as a library, see @aliou/sesame.
sesame index
sesame search "nix infra simplify"
sesame search "package.json exports" --tools --tool write
sesame search "*" --skill vitest
sesame search --after 7d
sesame skills
sesame status
sesame watchsesame --help and sesame <command> --help list every flag. Full reference: docs/cli-usage.md.
Sesame reads ~/.config/sesame/config.jsonc and creates it if missing:
{
"piSessionPaths": ["~/.pi/agent/sessions"]
}The index lives at ~/.local/share/sesame/index.sqlite. SESAME_DATA_DIR, SESAME_CONFIG_DIR, SESAME_CACHE_DIR, SESAME_RUNTIME_DIR, and the XDG variables override the default directories.
skills/sesame/SKILL.md teaches a Pi agent to search its own past sessions with the CLI:
pi install git:github.com/aliou/sesameRequires Node.js 26 or newer and pnpm (nix develop provides both).
pnpm install
pnpm run build # CLI bundle at packages/cli/dist/sesame.cjs
pnpm run lint
pnpm run typecheck
pnpm testHow indexing works: docs/indexing.md. All docs: docs/README.md.