Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (pi-session-search) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

pi-session-search

Index, summarize, and search past pi coding sessions. Provides semantic search across your entire session history — both active and archived sessions.

Features

Semantic search — Find past sessions by topic, not just keywords (session_search)
Browse & filter — List sessions by project, date range, archive status (session_list)
Read conversations — View the full conversation from any past session (session_read)
Auto-indexing — Parses JSONL session files on startup, tracks changes incrementally
Archive support — Indexes both ~/.pi/agent/sessions/ and ~/.pi/agent/sessions-archive/
Multiple embedders — OpenAI, AWS Bedrock, or local Ollama

Install

pi install pi-session-search

Or add to ~/.pi/agent/settings.json:

{
  "packages": ["npm:pi-session-search"]
}

Setup

Run /session-search-setup in pi to configure the embedding provider:

OpenAI — Uses text-embedding-3-small (needs OPENAI_API_KEY)
Bedrock — Uses Titan Embeddings v2 (needs AWS credentials)
Ollama — Uses nomic-embed-text (needs local Ollama running)

Config is stored at ~/.pi/session-search/config.json.

Usage

Semantic search

session_search(query="how did we debug the Lambda timeout")
session_search(query="CI pipeline configuration", limit=5)

Browse sessions

session_list(project="Rosie", after="2026-03-01")
session_list(archived=true, limit=20)

Read a session

session_read(session="<file-path-or-uuid>")
session_read(session="<id>", offset=50, limit=50)

Commands

Command	Description
`/session-search-setup`	Configure embedding provider
`/session-reindex`	Force full re-index of all sessions

How It Works

On startup, discovers all .jsonl session files in ~/.pi/agent/sessions/ (and ~/.pi/agent/sessions-archive/ if it exists)
Parses each session to extract: user messages, assistant text, tool calls, files modified, models used, compaction summaries
Generates a summary and embedding for each session
Stores the index at ~/.pi/session-search/index/
On subsequent startups, only re-indexes new or changed sessions
Re-syncs in the background every 5 minutes to pick up new sessions

You can also configure extra session/archive directories during setup if you store sessions in non-default locations.

Environment Variables

Variable	Description
`OPENAI_API_KEY`	Required for OpenAI embedder

License

MIT