Search across all indexed sessions, stored knowledge, and session summaries. Returns ranked results. By default, results are scoped to the project you specify — always pass your current working directory as project for best results. Set global: true to search across all projects. Global knowledge (stored without a project) is always included regardless of scope.

Index a specific session .db file into the persistent knowledge base. Supports incremental updates — if the session was already indexed but has new events, only the new data is processed.

Scan the sessions directory and index any new or updated session .db files. Incremental by default — only processes sessions with new events. Use force to rebuild everything.

Show statistics about the persistent knowledge base — sessions, chunks, tags, stored knowledge, summaries, and disk usage.

Remove sessions older than their TTL (default 90 days). Returns count of pruned sessions.

Store a piece of knowledge in the brain. Use for facts, notes, preferences, or anything worth remembering permanently. By default, knowledge is stored globally (available across all projects). Set scope to 'project' and pass your working directory as project_dir to scope it to a specific project.

Remove a piece of stored knowledge by ID or key.

List all manually stored knowledge entries. Pass your working directory as project to see only global + project-scoped entries.

Returns session chunks for the calling agent to summarize. The agent should read the chunks, write a concise summary (3-8 sentences covering what was worked on, key decisions, errors resolved, files changed, and outcome), then call kb_store_summary to save it. No API key needed — YOU are the summarizer.

Store a session summary generated by the calling agent. Use this after kb_summarize returns session chunks and you have written a summary.