rutter
Recall past decisions and cited notes from a local markdown folder across AI agents
- Pricing
- Open source
- Platforms
- CLI, self-hosted, macOS
- Runs
- Locally
- Version
- 1.0.1
- Listing updated
- 3 days ago
About rutter
rutter is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.
Rutter is a memory layer made of plain files. When a session reaches a decision, the client leaves one line about it, and a hook stores that line unedited in a dated, append-only file in a _librarian/ folder beside your notes. Each record lists the notes the session cited, with their paths and a content hash taken at capture.
The MCP server then lets any client search and recall those records. A note that was renamed without edits is followed by its hash, and a reference that cannot be placed is shown as unresolved rather than dropped. A note edited in place is not flagged yet, and a listed note does not prove the model opened it. There is no model inside it; the reasoning stays in your client.
Capture hooks exist for Claude Code, Codex, Grok, GitHub Copilot CLI, Antigravity CLI and Muse Code, and any other MCP client can recall with one config entry but cannot capture. Memory is shared between one person's agents, not between people. The README calls it a personal tool published as a reference implementation, with no support commitment.
Install
Run in a terminal
claude mcp add rutter --env LIBRARIAN_VAULT_PATH='<LIBRARIAN_VAULT_PATH>' -- npx -y rutter-memoryAdd to claude_desktop_config.json
{
"mcpServers": {
"rutter": {
"command": "npx",
"args": [
"-y",
"rutter-memory"
],
"env": {
"LIBRARIAN_VAULT_PATH": "<LIBRARIAN_VAULT_PATH>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"rutter": {
"command": "npx",
"args": [
"-y",
"rutter-memory"
],
"env": {
"LIBRARIAN_VAULT_PATH": "<LIBRARIAN_VAULT_PATH>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"rutter": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"rutter-memory"
],
"env": {
"LIBRARIAN_VAULT_PATH": "<LIBRARIAN_VAULT_PATH>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"rutter": {
"command": "npx",
"args": [
"-y",
"rutter-memory"
],
"env": {
"LIBRARIAN_VAULT_PATH": "<LIBRARIAN_VAULT_PATH>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"rutter": {
"command": "npx",
"args": [
"-y",
"rutter-memory"
],
"env": {
"LIBRARIAN_VAULT_PATH": "<LIBRARIAN_VAULT_PATH>"
}
}
}
}Configuration
LIBRARIAN_VAULT_PATHFolder of markdown notes (an Obsidian vault works)RequiredLIBRARIAN_USER_LABELName the server uses for whose work this is; defaults to 'the user'
What it does
- Plain markdown records
- Dated, append-only files in a folder you own, readable in a terminal and committable to git.
- Cited notes with hashes
- Each record lists the notes cited and a content hash from capture.
- Six capture hooks
- Claude Code, Codex, Grok, Copilot CLI, Antigravity and Muse Code can write records.
- Recall from any MCP client
- Any client can search and recall with one config entry.
- Unresolved references
- References it cannot place are shown, not dropped.
- Works with Obsidian
- Point it at a folder of markdown notes such as an Obsidian vault.
Good for
- Ask what you concluded last week, in a different AI tool
- Keep one decision log across Claude Code and Codex
- Trace which notes informed a past decision
- Build a git-tracked history of choices made in AI sessions
Pricing
Open source
Free; runs locally.
Prices change. Check ruttermemory.com before you buy.
rutter FAQ
Where are records stored?
As markdown in a `_librarian/` folder beside your notes, set by LIBRARIAN_VAULT_PATH.
What is the npm package called?
rutter-memory. The name rutter on npm belongs to an unrelated library.
Can several people share it?
No. Shared means one person's agents sharing one memory, not sharing between people.
Is it a supported product?
The README says it is a personal tool published as a reference implementation, with no support commitment.
Is rutter free?
Yes. rutter is open source, so you can use and self-host it for free.
How do I add rutter to Claude Code?
Run this command in your terminal: claude mcp add rutter --env LIBRARIAN_VAULT_PATH='<LIBRARIAN_VAULT_PATH>' -- npx -y rutter-memory
What are the best alternatives to rutter?
The closest alternatives to rutter are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and note1.
Alternatives to rutter

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Claude Code Ultimate Guide
MCP serverMCP server for searching the Claude Code Ultimate Guide from any MCP client
Runs locally- Open source
- 6.5K GitHub stars
- AI models and LLM tooling

Nautilus Compass Memory
MCP serverLocal-first long-term memory layer for AI agents, served over MCP
Not checked yet- 5 tools
- Remote
- Open source
- 1.3K GitHub stars
- Knowledge and memory

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity
MedXpert 图书馆连接器(通用版)
MCP serverLocal MCP server that searches and answers questions over your own Markdown wiki
Runs locally- 4 tools
- Open source
- Knowledge and memory