Search

"Searching is half of finding." — Senegalese proverb

Pi Session Manager provides powerful full-text search across all your sessions, powered by a dual-engine architecture.

Search Engines

SQLite FTS5

The primary search engine. All session content is indexed into an FTS5 virtual table inside the SQLite database (~/.pi/agent/session-manager.db). This provides:

• Fast prefix and phrase matching
• BM25 ranking
• Low memory footprint

FTS5 can be toggled via the enable_fts5 setting in the configuration file.

Tantivy

A Rust-native full-text search library (similar to Lucene) used as a secondary index. Tantivy provides:

• More sophisticated tokenization
• Better relevance scoring for complex queries
• Concurrent indexing

Both engines run in parallel and results are merged.

Filters

Role Filter

Narrow results to specific message roles:

Tool Filter

Filter by specific tool types used in sessions:

• bash — shell commands
• read / edit / write — file operations
• search — code search calls
• Custom tool names

Snippet Highlighting

Search results display highlighted snippets showing the matching text in context. Click a result to jump directly to the matching message in the Session Viewer.

Plugin System

The search system uses a plugin architecture with three built-in plugins:

Plugins are registered in src/plugins/ and can be extended to add custom search sources.

Command Palette

Press Cmd/Ctrl + K to open the command palette — a cmdk-based interface that combines search with quick actions:

• Search sessions by name or content
• Switch views (list, project, kanban)
• Open settings
• Toggle terminal
• Navigate to any session

Keyboard Shortcuts