# OpenCodeHub

> Apache-2.0 code intelligence graph + MCP server for AI coding agents. Gives agents callers, callees, processes, and blast radius in one MCP tool call — local, offline-capable, deterministic.

OpenCodeHub indexes a repository into a hybrid structural + semantic knowledge graph and exposes it over the Model Context Protocol (MCP) to AI coding agents. The MCP server registers 29 tools across five families — exploration (list_repos, query, context, impact, detect_changes, rename, sql), group / federation (group_list, group_query, group_status, group_contracts, group_cross_repo_links, group_sync), scan / findings / verdict (scan, list_findings, list_findings_delta, list_dead_code, remove_dead_code, license_audit, verdict, risk_trends), HTTP / routing (route_map, api_impact, shape_check, tool_map), and meta (project_profile, dependencies, owners, pack_codebase). The CLI binary is `codehub`. Runtime: Node 22 or 24, pnpm 10, LadybugDB graph store + DuckDB temporal sibling by default (legacy single-file DuckDB layout opt-in via CODEHUB_STORE=duck), web-tree-sitter (WASM) parse runtime by default with native opt-in via OCH_NATIVE_PARSER=1, 15 GA languages, SCIP indexers for TypeScript / TSX / JavaScript / Python / Go / Rust / Java / C# / C / C++ / Kotlin / Ruby. 20-scanner inventory. Apache-2.0 end to end. Repos are first-class graph nodes (`repo_uri`); the cross-repo `group_*` family fans out over named groups; AMBIGUOUS_REPO error envelope returns `choices[]` so a caller can retry deterministically.

## Documentation Sets

- [Abridged documentation](https://theagenticguy.github.io/opencodehub/llms-small.txt): a compact version of the documentation for OpenCodeHub, with non-essential content removed
- [Complete documentation](https://theagenticguy.github.io/opencodehub/llms-full.txt): the full documentation for OpenCodeHub
- [user-guide](https://theagenticguy.github.io/opencodehub/_llms-txt/user-guide.txt): User-facing pages only: install, quick-start, editor integration guides, group and indexing guides.
- [agents](https://theagenticguy.github.io/opencodehub/_llms-txt/agents.txt): Agent-side reference: per-editor MCP setup, the 29-tool catalog, tool decision matrix, idiomatic prompts.
- [mcp](https://theagenticguy.github.io/opencodehub/_llms-txt/mcp.txt): MCP surface: server tools, resources, CLI reference, error codes, language matrix, .docmeta.json schema.
- [contributing](https://theagenticguy.github.io/opencodehub/_llms-txt/contributing.txt): Developer and architecture docs: dev loop, release flow, ADRs, determinism, supply-chain, storage backend, cross-repo federation.

## Notes

- The complete documentation includes all content from the official documentation
- The content is automatically generated from the same source as the official documentation