Answer a question from the user's OWN past sessions (RAG): retrieves the most relevant threads and returns a synthesized answer with [thread N] citations + the source list. Use for 'how did we...' / 'what did I decide about...' instead of reading many threads. Needs an LLM engine configured (distillation enabled).

CONTRADICTION GUARD: before you make a technical decision or change, pass it as proposal to see SETTLED decisions on the same topic (each with its rationale), so you don't silently undo or re-litigate a past choice. Returns the closest prior decisions, best match first; an empty list means none conflict. Searches ALL projects unless project is given. Call this BEFORE acting on a non-trivial decision; if it returns something that contradicts your plan, reconcile with the user rather than overriding it. Requires distilled or recorded decisions.

Mark a TODO done so it drops out of the open-TODO lists. Pass the id from list_open_todos. The completion persists across re-indexing.

Find PRIOR SESSIONS where the user already worked on something similar to a task you're about to start — the 'have I done this before?' guard. Pass a short description of the task/problem as query; returns past threads (each with its most-relevant decision or gotcha and the threadId) so you can reuse the earlier solution instead of redoing or re-deciding it. Searches ALL projects unless project is given. Call at the START of a task. Requires distilled threads.

Fetch one indexed thread as a packed markdown transcript (budget-limited, ready to drop into context). Pass a threadId from search_threads.

Get the distilled knowledge for one thread by threadId: a short summary plus key decisions, gotchas, and open TODOs. A fast, high-signal recap instead of reading the whole transcript. Decisions/gotchas/summary exist only if the user enabled distillation; TODOs are always available.

List the git commits a thread likely PRODUCED — inferred on-device by overlapping the thread's discussed files with git log in the same time window. Answers 'which commit came out of this conversation?'. Each result has a short SHA, subject, and an overlap count (more shared files = higher confidence). Empty if none are inferred yet (the user runs cal commits in the repo to compute them). Pass a threadId from search_threads.

List unfinished TODOs / action items the user left across past coding sessions (newest first), optionally scoped to a project path or source. Extracted heuristically from the history (markdown task checkboxes + TODO/FIXME markers), so it works with NO API key and no AI distillation. Each TODO carries the threadId it came from — fetch that thread for full context.

List saved session snapshots (newest first), optionally scoped to a project-path substring. Returns snapshot metadata with an id to load.

List all tags the user has applied to their threads, each with the number of threads it's on. Use to discover the user's topic labels / collections, then pass a tag to recent_threads to filter by it.

Load a saved snapshot's full checkpoint (carry-forward project memory + packed transcript) as markdown, ready to drop into context to continue the session. Pass an id from list_snapshots.

Get a project's durable MEMORY: the decisions, gotchas, and open TODOs distilled across ALL past AI-coding sessions on it, with coverage counts. Omit project to use the repo the server runs in. Call this at the START of work on a project to recall what was already decided and what to watch out for. Decisions/gotchas need the user to have distilled threads; TODOs are always available.

Recall concrete technical DECISIONS the user made across ALL past sessions (and why), semantically matched to a query. Use BEFORE re-deciding something the user may have already settled. Returns decision facts, each with the threadId it came from. Requires the user to have distilled some threads.

Recall GOTCHAS / pitfalls / non-obvious constraints the user discovered across ALL past sessions, semantically matched to a query. Use to avoid repeating a known mistake. Returns gotcha facts with the threadId they came from. Requires the user to have distilled some threads.

List the user's most recently updated conversation threads (newest first), optionally filtered by source or project path. Use this to see what the user has been working on lately. Returns thread summaries with a threadId to fetch.

Record a DECISION you/the user just made for a project, so it persists in the project's memory and future cross-thread recall (and the check_decision guard). Pass the WHY as rationale when you have it. Omit project to use the repo the server runs in. Use when you settle a technical choice worth remembering.

Record a GOTCHA / pitfall just discovered for a project, so it persists in the project's memory and future recall. Omit project to use the current repo.

List the recurring ERRORS the user keeps hitting across their indexed sessions — normalized error signatures grouped by how often they recur (count) and how many threads they span. Scoped to the repo the server runs in by default; pass project (a path substring) for another repo, or "*" for all projects. Use this before retrying an approach to avoid repeating a known failure. Each cluster has an example line, a count, a thread count, and first/last-seen timestamps.

Search only the conversation history for the CURRENT project — the git repository (or directory) this MCP server was launched in. Use this first when the user asks about prior work on the project you're in; it scopes results to this repo. Falls back to all sources within that project.

Search the user's indexed AI coding-agent conversation threads across every tool they use (Claude Code, Codex, Cursor, Gemini, Qwen, Goose, OpenCode, Continue, Cline, Roo Code, Kilo Code, and in-app chats). Keyword full-text by default; set hybrid=true to also use on-device semantic similarity. Returns matching threads with snippets and a threadId to fetch. Use this to recall past decisions, prior solutions, or earlier discussion before redoing work.

Save a resumable SNAPSHOT of a thread: its packed transcript plus a carry-forward block of the project's distilled decisions/gotchas/open TODOs. Use this to checkpoint a session before context is compacted, or to hand work off to another agent or tool. Returns the snapshot id to load later. Pass a threadId from search_threads.

Find every past thread that mentioned a file path (e.g. 'embed/mod.rs') — which sessions touched this file. Substring match over indexed file references. Returns thread summaries.