Skip to content
MCP server

Git Why

Search Git history by meaning to find the commit that explains why code is the way it is

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Linux
Runs
Locally
Version
0.2.0
Listing updated
1 day ago

About Git Why

Git Why is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Git Why returns evidence rather than generated answers: a real commit, its author's own message and the relevant diff. Full-text and vector search run separately over every reachable commit and are fused with Reciprocal Rank Fusion, so an exact identifier and a half-remembered paraphrase both work. Embedding uses a small model in-process, so repository text stays local, and after one checksummed download of about 32 MB it works offline.

Beyond search it can resolve the first, last or removed commit for a subject, lay out a timeline, and rank who established an area by commit relevance. An optional daemon keeps the index warm for roughly twice the speed and is never required.

The project publishes unusually candid benchmarks: on 174 recall questions it scores Hit@1 of 0.201, well above other approaches, but it says git log -S is the better choice when you can name the symbol. That advice is built into the skill shipped with its agent plugins.

Install

Run in a terminal

claude mcp add git-why -- npx -y @alliecatowo/git-why

Add to claude_desktop_config.json

{
  "mcpServers": {
    "git-why": {
      "command": "npx",
      "args": [
        "-y",
        "@alliecatowo/git-why"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "git-why": {
      "command": "npx",
      "args": [
        "-y",
        "@alliecatowo/git-why"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "git-why": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@alliecatowo/git-why"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "git-why": {
      "command": "npx",
      "args": [
        "-y",
        "@alliecatowo/git-why"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "git-why": {
      "command": "npx",
      "args": [
        "-y",
        "@alliecatowo/git-why"
      ]
    }
  }
}

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

git_why_search
Search commit history by meaning and text
git_why_status
Report whether the repository index is current

What it does

Semantic history search
Finds commits by meaning when you remember no keywords.
Original commit evidence
Returns the real commit message and diff, not a generated summary.
Timeline and owners
Shows how a subject changed and who established an area.
Local and offline
Embeds in-process and runs offline after one model download.
Optional daemon
Keeps the index warm for faster queries without being required.
Agent plugins
Ships MCP, a routing skill and an index-management skill.

Good for

  • Find why a retry or workaround was added
  • Locate the commit behind a half-remembered bug
  • See how a subsystem changed over time
  • Let an agent check history before changing legacy code

Pricing

Open source

Free

Prices change. Check alliecatowo.github.io before you buy.

Git Why FAQ

How do I install it?

With npm install -g @alliecatowo/git-why, Homebrew, or from source; it needs Node 22.12 or newer.

Does it send my code anywhere?

No. Embedding runs in-process, so repository text never leaves your machine.

Does it generate explanations?

No. It retrieves evidence; the reason is found or it is not there.

When should I use something else?

When you can name the symbol, git log -S is better, according to the project's own benchmarks.

Is Git Why free?

Yes. Git Why is open source, so you can use and self-host it for free.

How do I add Git Why to Claude Code?

Run this command in your terminal: claude mcp add git-why -- npx -y @alliecatowo/git-why

What are the best alternatives to Git Why?

The closest alternatives to Git Why are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Git Why

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools