# GitHits

Hooks your agent up to public open-source: code, docs, examples, vulnerabilities and changelogs. Useful when the model is guessing and local repo context runs out.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 119
- Author: githits-com
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/githits-com/githits-cli
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/githits

## What it does

GitHits runs a local MCP server that your coding tool starts on demand. The agent gets indexed package and repository source, reads exact files and documentation pages, checks package health, compares dependency upgrades and pulls source-cited examples from real projects.

Quick start is `npx githits@latest init`. It signs you in, detects supported tools and configures GitHits for the ones you pick. Cursor's direct setup uses the hosted remote MCP; everything else goes through local stdio. After that, work normally — many agents call GitHits on their own when they need source-backed context. If yours starts guessing, prompt it directly.

There is a CLI too: `githits example`, `githits search`, `githits read`, `githits grep`, `githits pkg ...`. `githits code diff` compares whole repositories unless you narrow it with an explicit path glob. A raw diff does not prove upgrade safety, so check the changelog and tests before you bump a dependency.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.githits.com`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http githits https://mcp.githits.com
```

2. **Platform CLI**
```bash
claude mcp add githits -- npx -y githits
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add githits --url https://mcp.githits.com
```

2. **Platform CLI**
```bash
codex mcp add githits -- npx -y githits
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "githits": {
            "url": "https://mcp.githits.com"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "githits": {
            "command": "npx",
            "args": [
                "-y",
                "githits"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "githits": {
            "type": "http",
            "url": "https://mcp.githits.com"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "githits": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "githits"
            ]
        }
    }
}
```

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http githits https://mcp.githits.com
```

2. **Platform CLI**
```bash
gemini mcp add githits npx -y githits
```

## When to use it
- find how an unfamiliar library is used in real code
- read dependency source without cloning the repo
- check vulnerabilities and changelog before an upgrade
- debug a stack trace that points into third-party code
- compare two package versions by actual changes

## Example prompts
- Find prior art across open source for HTTP retries with exponential backoff in Python.
- Check npm:lodash@4.17.20 for high-severity vulnerabilities.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md