Memoria Documentation

An MCP server that prevents your AI from breaking code by revealing hidden file dependencies through git forensics.

What is Memoria?

When you ask an AI to refactor a file, it might break other files that depend on it — even if there's no direct import between them. Memoria prevents this by analyzing git history to find files that frequently change together.

Key Features

• Volatility Engine — Scans commits for panic keywords with time-decay. Recent bugs matter more.
• Entanglement Engine — Finds files that change together >15% of the time, even without imports.
• Sentinel Engine — Detects when coupled files are >7 days out of sync.
• Static Import Engine — Uses git grep to find files that import the target.
• History Search — Search git history to understand WHY code was written.

Quick Start

Add this to your MCP configuration file:

{
  "mcpServers": {
    "memoria": {
      "command": "npx",
      "args": ["-y", "@byronwade/memoria"]
    }
  }
}

See the installation guides for specific instructions for your AI tool.

How to Use

Once installed, simply ask your AI to analyze a file before making changes:

"Analyze src/api/stripe/route.ts before I refactor it"

Memoria will return:

• Coupled files — Files that frequently change together
• Risk score — How bug-prone this code is historically
• Stale dependencies — Coupled files that may need updating
• Evidence — Actual code diffs showing why files are related

Private & Local

Memoria runs 100% on your machine. No code is uploaded to the cloud, no API keys required, works offline. Your code never leaves your computer.

MCP Tools

Memoria exposes two tools via the Model Context Protocol:

• analyze_file — Analyze a file to reveal risk score, coupled files, and hidden dependencies
• ask_history — Search git history to understand why code was written

See the API Reference for complete documentation of each tool.

Requirements

• Node.js 18 or higher
• Git repository with commit history
• An MCP-compatible AI tool (Claude Desktop, Cursor, Windsurf, etc.)