// Search past coding sessions with Sesame local BM25 search. Use for ranked multi-word queries, tool-call searches, or listing recent sessions when exact lookup is too strict.
| name | sesame |
| description | Search past coding sessions with Sesame local BM25 search. Use for ranked multi-word queries, tool-call searches, or listing recent sessions when exact lookup is too strict. |
Sesame indexes coding agent sessions into SQLite FTS5 and ranks results with BM25.
Use sesame when you need:
"nix infra cleanup", "publish workflow changesets")--tools, --tool bash, --path package.json)"*" with filters and --exclude)Use find_sessions for quick exact keyword lookups. Use read_session after you identified the session to inspect.
sesame search "query"
sesame search "query" --json
sesame search "query" --cwd /path/to/project
sesame search "query" --after 7d
sesame search "query" --before 2026-01-01
sesame search "query" --limit 5
sesame search "query" --tools
sesame search "query" --tool bash
sesame search "query" --path package.json
sesame search "query" --exclude <session-id> --exclude <session-id>
Special query to list sessions instead of full-text match:
sesame search "*" --limit 20
sesame search "*" --cwd /path --after 2w --exclude <session-id>
sesame index
sesame index --full
sesame status
sesame watch
sesame watch --interval 30
sesame search "query".sesame index or keep sesame watch running.--cwd, --after, --before, --tools, --tool, or --path.--exclude to page through additional results across repeated searches.--json when another tool/agent needs structured output.7d, 2w, 1mYYYY-MM-DD (ISO date)0.00-1.00 for display. Higher is better.sesame watch runs an initial index pass, then re-indexes on change.