Skip to main content
Glama
Sign In
gitwhy-cli

gitwhy-mcp

by gitwhy-cli
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Hybrid

GitWhy MCP Server

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

Related MCP server: Projectmem

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

Tool

Description

gitwhy_save

Save development context (reasoning, decisions, trade-offs) for the current session

gitwhy_get

Retrieve a saved context by its ID

gitwhy_search

Search saved contexts by keyword or natural language query

gitwhy_list

Browse saved contexts by domain/topic hierarchy

gitwhy_status

Check setup state, pending commits, and sync status

gitwhy_sync

Upload local contexts to the cloud (private)

gitwhy_publish

Share synced contexts with your team

gitwhy_post_pr

Post context summary as a GitHub PR comment

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

License

MIT

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Selvedge

    masondelan
    A
    license
    A
    quality
    A
    maintenance
    Change tracking for AI-era codebases. AI agents call it to log structured change events (entity + diff + reasoning) before the session ends, then query history with diff, blame, history, changeset, and search. Captures the intent that would otherwise evaporate.
    8
    156 PyPI
    26
    MIT

  • Projectmem

    riponcm
    A
    license
    A
    quality
    A
    maintenance
    Local-first memory layer for AI coding agents — captures issues, attempts, fixes, and decisions, and warns at git commit before you repeat a mistake.
    17
    810 PyPI
    872
    MIT

  • beadless

    KuraPiee
    A
    license
    Not graded
    quality
    B
    maintenance
    Provides AI coding agents with git-native persistent memory and a dependency-aware task graph, letting them record and fuzzy-recall architectural decisions, lessons, and gotchas while creating, claiming, and completing tasks that auto-unblock downstream work. Stores everything as plain JSON and Markdown committed inside the repository, so context stays branch-aware, team-shared, and reviewable in pull requests.
    6 npm
    MIT