pi-session-memory

Install

pi install npm:pi-session-memory

A local-first Pi extension for on-demand cross-session transcript search across Pi, Claude Code, and Codex, plus native project-session migration to Pi /resume sessions.

What it does

• Indexes local Pi, Claude Code, and Codex JSONL transcript turns in local SQLite.
• Provides recall_memory for literal raw-history search that returns every match.
• Provides fetch_session for read-only expansion of the smallest useful transcript range.
• Synchronizes changed history at Pi session start; /memory-backfill performs an explicit full rescan.
• Migrates current-project Claude Code or Codex sessions into separate native Pi sessions.
• Matches equivalent Windows project CWDs during migration, including \\ versus /, drive-letter case, and trailing separators.

Search results are derived from stored source transcripts only and are never automatically injected into model context. Put project rules and preferences in AGENTS.md.

Commands

Command	Description
/pi-session-memory-helper	Show cross-session search and migration help.
/memory-status	Show locally indexed session and turn totals.
/memory-search <query>	Search locally indexed raw transcript history.
/memory-backfill	Explicitly rescan historical Pi, Claude Code, and Codex JSONL.
/project-session-migration	Convert current-project Codex sessions for /resume.
/project-claude-session-migration	Convert current-project Claude Code sessions for /resume.

Agent tools

Tool	Use when
recall_memory	The user explicitly asks about a prior discussion, or agrees to history search. Use 2–8 specific literal entities.
fetch_session	A recall excerpt lacks needed context. Fetch the smallest useful range. It is read-only.
get_memory_stats	The user asks how much local history is indexed.
backfill_memory	The user explicitly asks to import, backfill, or rescan history.
migrate_codex_project_sessions	The user wants to continue current-project Codex work through /resume.
migrate_claude_project_sessions	The user wants to continue current-project Claude Code work through /resume.

Flow

session_start -> syncChangedHistory() -> SQLite raw transcript index
recall_memory -> matching raw transcript turns -> fetch_session (optional, read-only)
project migration command/tool -> native Pi session JSONL -> /resume

History remains on the local machine, by default in ~/.pi/agent/memory.db. Deleting that database removes only the index; restarting Pi rebuilds it from local source JSONL files.

Migration compatibility

Migration selects sessions whose recorded project CWD is equivalent to the current Pi project CWD. On Windows, C:\\Work\\app\\, C:/Work/app, and differences only in path letter case are treated as the same project. Migrated sessions are written using the current Pi project CWD, so they appear under that project in /resume.

Development

npm test          # core database, raw recall, importer, and migration regression suite