# KRouter

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 76 repo stars
- Author: 398894496-arch
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/398894496-arch/KRouter
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/krouter

## What it 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.

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- 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
- 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.

## Similar
- [caveman-compress](https://affpapa.org/en/nevibecode/skills/caveman-compress.md) — skill · 440900 installs
- [archive](https://affpapa.org/en/nevibecode/skills/archive.md) — skill · 1200 installs
- [wiki](https://affpapa.org/en/nevibecode/skills/yeachan-heo-wiki.md) — skill · 685 installs
- [Callosium](https://affpapa.org/en/nevibecode/mcp/callosium.md) — MCP server · ★ 11 repo stars
- [krimto](https://affpapa.org/en/nevibecode/mcp/krimto.md) — MCP server · ★ 7 repo stars
- [Vulcanus](https://affpapa.org/en/nevibecode/mcp/vulcanus.md) — MCP server · ★ 6 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
