# GitHits

- [GitHits documentation](https://docs.githits.com/index.md): Connect coding agents and software factories to open-source code, documentation, and package data through MCP, the CLI, or the REST API.
- [What is GitHits?](https://docs.githits.com/introduction.md): Dependency source, documentation, and package data for coding agents and software factories.
- [Quick start](https://docs.githits.com/quickstart.md): Connect your coding agent or software factory to GitHits through MCP.
- [Automatic local MCP setup](https://docs.githits.com/installation/automatic-setup.md): Use the GitHits hybrid CLI to automatically configure local MCP for supported AI coding tools.
- [Manual remote MCP setup](https://docs.githits.com/installation/manual-setup.md): Configure the hosted GitHits MCP server in any MCP-capable client that supports remote servers.
- [GitHits CLI Skills setup](https://docs.githits.com/installation/skills.md): Install GitHits Skills when you prefer a Skills workflow that calls the GitHits CLI instead of MCP tools.
- [Quick-start guidance for MCP clients](https://docs.githits.com/tools/quick-start.md): Load GitHits tool routing and usage instructions with quick_start.
- [Resolve a target](https://docs.githits.com/tools/target-resolution.md): Find canonical package, repository, or documentation targets from an open-source dependency name.
- [Code: search, grep, files, and source](https://docs.githits.com/tools/code-navigation.md): Search indexed code, grep matches, list files, and read exact source lines.
- [Documentation: hosted and repo-backed docs](https://docs.githits.com/tools/documentation-access.md): Use search, list, and read to find, browse, and read hosted docs and repository-backed docs for indexed packages.
- [Package Intelligence: metadata, vulnerabilities, dependencies, and upgrades](https://docs.githits.com/tools/package-inspection.md): Check package metadata, vulnerabilities, dependencies, changelogs, and upgrades.
- [Example](https://docs.githits.com/tools/code-examples.md): Generate implementation examples from how open-source projects use libraries and APIs.
- [Research](https://docs.githits.com/tools/research.md): Ask how a package or repository works and get an answer with cited sources.
- [Experimental tools](https://docs.githits.com/tools/experimental-tools.md): Enable experimental Research in the CLI and local MCP server.
- [GitHits CLI command reference: all commands and flags](https://docs.githits.com/cli/commands.md): Complete reference for every GitHits CLI command, organized by category: setup, authentication, MCP server, Code, Documentation, and Package Intelligence.
- [GitHits CLI environment variable reference](https://docs.githits.com/cli/environment-variables.md): GitHits CLI environment variables for authentication, request grouping, storage, profiling, and output.
- [GitHits CLI configuration: config.toml reference](https://docs.githits.com/cli/configuration.md): Reference for GitHits config.toml: file locations, OAuth storage, and experimental tools.
- [Authentication special cases](https://docs.githits.com/authentication.md): Handle GitHits authentication manually for CI, headless machines, custom storage, and troubleshooting.
- [Use GitHits in agentic coding workflows](https://docs.githits.com/guides/agentic-workflow.md): Prompts for planning, implementation, debugging, review, and maintenance.
- [Trigger GitHits manually](https://docs.githits.com/guides/trigger-githits.md): Prompt your agent to use GitHits when it does not call the tools on its own.
- [Authenticate GitHits in CI and headless environments](https://docs.githits.com/guides/headless-ci.md): Authenticate GitHits in CI pipelines, SSH sessions, and containers with an API token, tunneled OAuth, or file storage.
- [Troubleshooting GitHits: auth, MCP, and startup issues](https://docs.githits.com/guides/troubleshooting.md): Fix common GitHits problems: keychain prompts, expired tokens, MCP server not loading, Node.js version errors, and slow npx startup.
- [GitHits REST API](https://docs.githits.com/api/overview.md): Direct HTTP access to dependency source, documentation, and package data.
- [API quickstart](https://docs.githits.com/api/quickstart.md): Inspect an exact package version with an authenticated HTTP request to the GitHits API.
- [API authentication](https://docs.githits.com/api/authentication.md): Authenticate automated workflows with GitHits API tokens, and use CLI login or the playground for local testing.
- [Requests and responses](https://docs.githits.com/api/requests-and-responses.md): Choose response information with fields, encode parameters and read documentation or source code through the unified GitHits API.
- [API errors](https://docs.githits.com/api/errors.md): Handle GitHits problem responses, request IDs, rate limits and ambiguous request outcomes.
- [API versioning](https://docs.githits.com/api/versioning.md): Distinguish the GitHits v1 API contract from package versions and track reference updates.
- [Get a package or repository changelog](https://docs.githits.com/api-reference/v1/packages/get-a-package-or-repository-changelog.md): Read release notes for a package or repository, ordered newest first. Retrieve recent releases to catch up on changes, or a version range to review everything between two releases.
- [Review package upgrades](https://docs.githits.com/api-reference/v1/packages/review-package-upgrades.md): Compare the versions you currently use with proposed upgrades for up to 30 packages. Each review brings together security advisories, dependency changes, compatibility information, and release notes to help you decide what to upgrade.
- [Inspect a package release](https://docs.githits.com/api-reference/v1/packages/inspect-a-package-release.md): Get an overview of a package and one of its published releases, including its description, license, and deprecation status. You can also include download counts, GitHub repository details, security advisories, and release notes.
- [Inspect package dependencies](https://docs.githits.com/api-reference/v1/packages/inspect-package-dependencies.md): Explore the dependencies of a package release, from its direct dependencies to the full dependency graph. The response can also include dependency declarations, relationships between packages, and issues such as outdated or deprecated dependencies.
- [Inspect package vulnerabilities](https://docs.githits.com/api-reference/v1/packages/inspect-package-vulnerabilities.md): Find known security advisories for a package release, with severity information, affected versions, and recommended upgrade versions. The response includes summary counts and a paginated advisory list.
- [Generate an example from open-source references](https://docs.githits.com/api-reference/v1/examples/generate-an-example-from-open-source-references.md): Generate a code example for a programming task using open-source references. The response contains Markdown with source references, license attribution, and a link to the saved example.
- [Compare two exact source trees](https://docs.githits.com/api-reference/v1/experimental/compare-two-exact-source-trees.md): Compare source changes between two package versions or two refs in a public repository. The response lists changed files and can include added and deleted line counts and patches.
- [Research a question with cited sources](https://docs.githits.com/api-reference/v1/experimental/research-a-question-with-cited-sources.md): Research a question about a package, GitHub repository, or documentation site and receive a Markdown answer with links to its sources. Continue the conversation with follow-up questions in the same thread. Answer generation can take up to 210 seconds.
- [Generate an SBOM from uploaded files](https://docs.githits.com/api-reference/v1/experimental/generate-an-sbom-from-uploaded-files.md): Generate a dependency inventory from manifest and lockfile uploads without creating a project. Manifest-only inputs resolve concrete versions and transitives. Compatible lockfiles supply recorded versions for associated manifests; uncovered manifests resolve separately.
- [Resolve a target name](https://docs.githits.com/api-reference/v1/experimental/resolve-a-target-name.md): Find packages, repositories, and documentation sites from a name. Results include ranked matches and related projects to help you identify the project you mean.
- [Submit solution or session feedback](https://docs.githits.com/api-reference/v1/feedback/submit-solution-or-session-feedback.md): Record whether a generated example or a session was useful, with optional written feedback. You can rate a saved example using its solution identifier or submit feedback for a session.
- [Find regex or literal matches across source and documentation](https://docs.githits.com/api-reference/v1/grep/find-regex-or-literal-matches-across-source-and-documentation.md): Find exact text across ordered package, repository, and documentation-site targets. Package targets also search their selected hosted docs. Matching is case-sensitive RE2 regex by default, with no surrounding context. Set `pattern_type` to `literal` for plain text, or `ignore_case` to true to ignore…
- [Search supported programming languages](https://docs.githits.com/api-reference/v1/languages/search-supported-programming-languages.md): Find supported programming languages by name or alias. Results provide a canonical name, a display name, and aliases for each match, ordered by relevance.
- [List files and documentation paths](https://docs.githits.com/api-reference/v1/list/list-files-and-documentation-paths.md): Browse a known package, repository, or documentation site to find the path you want to read. Package targets stay within the package's own tree; repository targets cover the whole snapshot. Both include local documentation. To browse hosted docs, use an explicit `site:` target from resolve or a docs…
- [Read documentation or source code](https://docs.githits.com/api-reference/v1/read/read-documentation-or-source-code.md): Read a documentation page or an exact source file. The response identifies which kind was returned and includes the information needed to cite the page, package version, or repository commit.
- [Search documentation, code and symbols](https://docs.githits.com/api-reference/v1/search/search-documentation-code-and-symbols.md): Search documentation, source code, and symbols across packages, public repositories, and documentation sites. Results include matching text and source locations you can use to read the original page or file.
- [Get search status and retained results](https://docs.githits.com/api-reference/v1/search/get-search-status-and-retained-results.md): Retrieve the status and saved results of a search started with `POST /v1/searches`. Use this endpoint to follow a search that is still running or to retrieve its results again while they are retained.
- [Changelog](https://docs.githits.com/changelog/overview.md): Recent updates to GitHits — new features, improvements, and bug fixes.

## OpenAPI Specs

- [openapi](https://api.githits.dev/v1/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.