Gitwhy

The shared AI context engine for git — save, search, and share the reasoning behind code changes.

GitWhy captures the why behind every commit: reasoning, decisions, and trade-offs. This MCP server makes GitWhy's tools available to AI coding agents like Claude, Cursor, Windsurf, and VS Code Copilot.

Install

npm (recommended for MCP clients)

npm install -g gitwhy-mcp

Homebrew (macOS/Linux)

brew install gitwhy-cli/tap/git-why

Scoop (Windows)

scoop bucket add gitwhy https://github.com/quanng28/gitwhy-scoop-bucket
scoop install git-why

MCP Configuration

Claude Desktop / Claude Code

Add to your MCP config (~/.claude/settings.json or Claude Desktop settings):

{
  "mcpServers": {
    "gitwhy": {
      "command": "gitwhy-mcp",
      "args": []
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "gitwhy": {
      "command": "npx",
      "args": ["-y", "gitwhy-mcp"]
    }
  }
}

VS Code

Add to .vscode/mcp.json:

{
  "servers": {
    "gitwhy": {
      "command": "npx",
      "args": ["-y", "gitwhy-mcp"]
    }
  }
}

Tools

Authentication

For cloud features (sync, publish, PR comments), you need a GitWhy API key:

1. Sign up at app.gitwhy.dev
2. Get your API key at app.gitwhy.dev/dashboard/api-keys
3. For local CLI: run git why setup to authenticate
4. For remote (Smithery/Glama): paste your API key when prompted

Links

• Website
• MCP Registry
• npm Package

License

MIT