chunkhound
ChunkHound describes itself as local-first codebase intelligence: your assistant can search code but does not understand it, so ChunkHound researches the codebase and extracts architecture, patterns and institutional knowledge. It plugs into AI clients through MCP and the README lists Claude, VS Code, Cursor, Windsurf and Zed. Features include the cAST algorithm for semantic code chunking (linked to a research paper), multi-hop semantic search that follows related code beyond direct matches, natural-language semantic search, regex search that needs no API key, and real-time indexing with file watching and branch switching.
It parses 30 languages: programming languages through Tree-sitter (Python, JavaScript, TypeScript, Java, Go, Rust, C/C++ and more), configuration formats such as JSON, YAML, TOML and HCL, and text and PDF through custom parsers. Requirements are Python 3.10+ and uv. Embeddings can come from VoyageAI (recommended), OpenAI or local Ollama, and the code-research LLM can be the Claude Code or Codex CLI (no API key) or an Anthropic or OpenAI key. Install with `uv tool install chunkhound`, put a `.chunkhound.json` in the project root and run `chunkhound index`.
The README positions it for large monorepos, security-sensitive codebases and air-gapped setups, since the code stays on your machine. Note that with a cloud embedding provider, chunks of code are sent to that provider. It is MIT licensed and was last pushed on 2026-10-12. This review is based on the README and repository data; we have not run it ourselves.
Features
Why choose it
Trade-offs
Maintenance check
- Last commit
- 2026-10-22
- Commits, last 90 days
- 36
- Releases, last 90 days
- 2
- Latest release
- v6.1.0 (2026-10-20)
- Open issues
- 113
- Recent issues with at least one comment
- 4/15
Oldest week on the left; the latest four weeks are orange. Source: GitHub commit activity.
Status rule: archived on GitHub = Archived; last commit within 90 days = Active; 91 to 365 days = Slowing; older = Stale. All figures come from the GitHub API on the date shown.
Most discussed open issues
- #41 dengcao/Qwen3-Embedding-8B:Q5_K_M model doesn't support embedding8 comments · 2025-09-30
- #272 MCP server orphan + unbounded memory growth after parent (claude) exits6 comments · 2026-05-07
- #98 Add a `get_file_contents` tool6 comments · 2025-11-21
- #145 Ollama reranking does not work5 comments · 2026-01-06
- #93 Codex CLI doesn't reconnect to mcp server when starting a new conversation in the same session4 comments · 2025-11-17
Issue titles are quoted from GitHub. Open the link to check whether a problem still applies to the version you use.
Compatibility
Quick start
Use cases
Alternatives
Comments
No comments yet. Be the first!