![\"GitHits\"](\"./github-githits.png\")
\n\n \n
\n The code context layer for AI coding agents.\n
\n\n\n ![\"npm](\"https://img.shields.io/npm/v/githits.svg\")
\n ![\"npm](\"https://img.shields.io/npm/dm/githits.svg\")
\n ![\"Main\"](\"https://github.com/githits-com/githits-cli/actions/workflows/main.yml/badge.svg\"){kind=icon}
\n ![\"License:](\"https://img.shields.io/badge/license-Apache--2.0-blue.svg\"){kind=icon}
\n ![\"Node\"](\"https://img.shields.io/node/v/githits.svg\")
\n ![\"MCP\"](\"https://img.shields.io/badge/MCP-enabled-5C4EE5\"){kind=icon}
\n
\n
![\"githits-cli](\"https://glama.ai/mcp/servers/githits-com/githits-cli/badges/score.svg\")
\n \n
\n Website ·\n Documentation ·\n Issues\n
\n\nGitHits connects AI coding agents to public open-source evidence across the\nfull software development lifecycle: discovery, planning, research,\nimplementation, debugging, and maintenance.\n\nThe CLI runs a local [MCP](https://modelcontextprotocol.io/) server that your\ncoding tool starts on demand. Agents can then search indexed package and\nrepository source, read exact files and documentation pages, inspect package\nhealth, compare dependency upgrades, and find source-cited examples from real\nopen-source projects when model knowledge and local repository context are not\nenough.\n\n## Quick Start\n\n```sh\nnpx githits@latest init\n```\n\n`init` signs you in, detects supported coding tools, and configures GitHits for\nthe tools you select. It uses the local stdio MCP except for Cursor, whose\ndirect setup uses the hosted remote MCP.\n\nAutomatic setup currently supports Claude Code, Cursor, Windsurf,\nVS Code / Copilot, Cline, Claude Desktop, Codex CLI, Pi, Gemini CLI,\nGoogle Antigravity, OpenCode, Hermes Agent, Zed, Junie, Qwen Code,\nKiro, Kilo Code, Factory Droid, and Amazon Q CLI.\n\nAfter setup, open your coding agent and work normally. Many agents call GitHits\nwhen they need source-backed context. If your agent starts guessing, prompt it\ndirectly:\n\n```text\nUse GitHits Code Navigation to inspect npm:express. Find how middleware\nerrors are handled, read the relevant source, and explain the fix before\nediting code.\n```\n\n## What GitHits Adds\n\nGitHits is designed for the point where an agent needs evidence from the\nbroader open-source ecosystem, not just model memory or local repo context:\n\n| Capability | MCP tools | CLI commands |\n|---|---|---|\n| Code examples | `get_example`, `search_language` | `githits example`, `githits languages` |\n| Code navigation | `search`, `search_status`, `code_files`, `code_read`, `code_grep` | `githits search`, `githits search-status`, `githits code ...` |\n| Documentation access | `docs_list`, `docs_read` | `githits docs ...` |\n| Package inspection | `pkg_info`, `pkg_vulns`, `pkg_deps`, `pkg_changelog`, `pkg_upgrade_review` | `githits pkg ...` |\n| Feedback | `feedback` | `githits feedback` |\n\nUse GitHits when your agent needs to:\n\n- discover, plan, or research how OSS projects solve a vague issue or unfamiliar error\n- find broad prior art or rare needle-in-the-haystack examples across repositories\n- inspect source, tests, symbols, or docs for a known package or repository\n- verify how a dependency actually behaves before changing code\n- debug stack traces that point into third-party code\n- review package health, licenses, vulnerabilities, dependencies, and changelogs\n- compare dependency upgrades using factual evidence\n\n## Examples\n\nFind prior art across open source:\n\n```sh\nnpx githits@latest example \"HTTP retries with exponential backoff in Python\"\n```\n\nSearch indexed code, docs, and symbols for a dependency:\n\n```sh\nnpx githits@latest search \"router middleware\" --in npm:express\nnpx githits@latest search '\"body parser\" OR multer' --in npm:express --source docs\nnpx githits@latest search \"debounce\" --in npm:lodash --source symbol\n```\n\nRead and grep dependency source without cloning:\n\n```sh\nnpx githits@latest code files npm:express lib\nnpx githits@latest code read npm:express lib/router/index.js --lines 120-200\nnpx githits@latest code grep npm:express \"router.use\" lib --regex\n```\n\nInspect package health and upgrade evidence:\n\n```sh\nnpx githits@latest pkg info npm:express\nnpx githits@latest pkg vulns npm:lodash@4.17.20 --severity high\nnpx githits@latest pkg deps npm:express@4.18.2 --depth 2\nnpx githits@latest pkg changelog npm:express --from 4.18.2 --to 5.2.1\nnpx githits@latest pkg upgrade-review npm:zod@4.3.6 --to 4.4.3\n```\n\nBrowse and read package documentation:\n\n```sh\nnpx githits@latest docs list npm:express\nnpx githits@latest docs read