Git Why
Search Git history by meaning to find the commit that explains why code is the way it is
- 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-whyAdd to claude_desktop_config.json
{
"mcpServers": {
"git-why": {
"command": "npx",
"args": [
"-y",
"@alliecatowo/git-why"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"git-why": {
"command": "npx",
"args": [
"-y",
"@alliecatowo/git-why"
]
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

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

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

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

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools