KRouter — Claude Code MCP server: features and installation
KRouter — an MCP server for Claude Code keeps decisions in local Markdown files and surfaces related notes as an agent handles a message. Claude Code and Codex use two retrieval layers; Cursor uses the session-start index.
MIT ★ 76 updated 2026-11-16
Open on GitHubWhat KRouter does
KRouter lets a coding agent recall earlier decisions and connect them to a current task. It searches local notes, gives a relevant page to the agent, and the answer cites that page. If the memory has no matching entry, the agent replies without one.
The per-message hook searches on the machine, with no model call or data sent elsewhere. Personal use needs neither an API key nor a server. Claude Code and Codex use message lookup plus a session-start index; Cursor uses the index at session start. Apps that only run the MCP server get search tools, not automatic memory retrieval.
Start installation with curl -fsSL https://github.com/398894496-arch/KRouter/releases/latest/download/bootstrap.sh -o /tmp/krouter-install.sh && sh /tmp/krouter-install.sh. Run ~/.dsh-krouter/current/scripts/krouter doctor to check the setup, then try ~/.dsh-krouter/current/scripts/krouter search "what did we decide about X?" for a first lookup.
What it helps with
- recall an earlier decision from a passing mention
- give an agent a related note with its source page
- bring a lesson from one task into a similar situation
- replace an old decision after a change of mind
Example prompts for the agent
- Recall what we decided about moving the Clippings originals to the archive.
- Find notes connected to the rules for this module.
- Check whether we have a lesson from a similar task.
How to install KRouter
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about KRouter
How do I install KRouter in Claude Code?
Run curl -fsSL https://github.com/398894496-arch/KRouter/releases/latest/download/bootstrap.sh -o /tmp/krouter-install.sh && sh /tmp/krouter-install.sh, check the setup with ~/.dsh-krouter/current/scripts/krouter doctor, then make a first lookup with ~/.dsh-krouter/current/scripts/krouter search "what did we decide about X?".
What does KRouter do?
It keeps memory in local Markdown files and supplies notes related to a message or topic. Answers cite the source page, and lessons from earlier tasks can surface in similar situations.
What does KRouter need to run?
Personal use needs no API key or server. Automatic retrieval depends on host hooks: Claude Code and Codex support both retrieval layers, while Cursor uses the session-start index.