AgentIndex icon
AgentIndex
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompareGuides
Submit Tool
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompareGuides
Home/
Code Assistant/
chunkhound
chunkhound logo

chunkhound

Active·★ 1.5k·MIT·Updated 2026-10-22

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.

This write-up is based on the project's README and public repository data. We have not hand-tested the tool. Data as of 2026-10-20.

License
MIT
Latest release
v6.1.0 · 2026-10-20
Last commit
2026-10-20
Contributors
31
Forks
142
Open issues and PRs
108
First published
2025-06-04
PyPI package
chunkhound 6.1.0 · 2,383 downloads last week

Source: GitHub, npm and PyPI public APIs.

#codebase intelligence#semantic search#code analysis#local-first#AI assistant#code research#multi-hop search#developer tools
$ Install
$ curl -LsSf https://astral.sh/uv/install.sh | sh && uv tool install chunkhound
↗ Visit site★ GitHub
01

Features

01Semantic code chunking via cAST Algorithm for deep understanding.
02Multi-hop semantic search discovers interconnected code relationships.
03Local-first operation ensures your code stays on your machine for privacy.
04Supports structured parsing for over 30 programming and configuration languages.
05Real-time indexing with automatic file watching and smart diffs.
02

Why choose it

+Local-first: the index stays on your machine, and regex search works with no API keys
+Semantic search plus multi-hop search that follows related code beyond direct matches
+30 languages parsed with Tree-sitter and custom parsers, including config files and PDF
+Real-time indexing with file watching, smart diffs and branch switching
03

Trade-offs

!Semantic search and code research need an embedding provider and an LLM; with VoyageAI or OpenAI, code chunks leave your machine (Ollama keeps embeddings local)
!Requires Python 3.10+ and uv, and a config file plus an indexing step before first use
!The README gives few concrete numbers on indexing speed or accuracy; details are on the documentation site
04

Maintenance check

ActiveChecked: 2026-10-22
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
Commits per week, last 12 weeks
Commits per week, last 12 weeks: 3, 1, 1, 0, 1, 4, 3, 0, 5, 5, 8, 3

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.

05

Compatibility

Python
Runtime
Verified via docs
uv
Package Manager
Verified via docs
Multiple Programming Languages
Codebase Analysis
Verified via docs
IDEs/LLMs (via MCP)
Integration
Verified via docs
06

Quick start

1
$ curl -LsSf https://astral.sh/uv/install.sh | sh
2
$ uv tool install chunkhound
07

Use cases

↳Managing large monorepos with complex cross-team dependencies.
↳Analyzing security-sensitive codebases in a local-only environment.
↳Projects requiring consistent search across multiple programming languages.
↳Development in offline or air-gapped environments.
08

Alternatives

⚡Top VS:
VSpg-aiguide★1.9k→VScodanna★756→VScontextplus★2.0k→VSgptme★4.5k→
pg-aiguide logo
pg-aiguide★ 1.9k
MCP server and Claude plugin for Postgres skills and documentation. Helps AI coding tools generate better PostgreSQL code.
VSCompare→
codanna logo
codanna★ 756
Local code intelligence MCP server and CLI for AI coding agents
VSCompare→
contextplus logo
contextplus★ 2.0k
Semantic Intelligence for Large-Scale Engineering. Context+ is an MCP server designed for developers who demand 99% accuracy. By combining Tree-sitter AST parsing, Spectral Clustering, and Obsidian-style linking, Context+ turns a massive codebase into a searchable, hierarchical feature graph.
VSCompare→
gptme logo
gptme★ 4.5k
Your agent in your terminal, equipped with local tools: writes code, uses the terminal, browses the web, vision.
VSCompare→
Context-Engine logo
Context-Engine★ 401
Context-Engine MCP - Agentic Context Compression Suite
VSCompare→
codebase-context logo
codebase-context★ 66
Second brain for AI agents working on your codebase - team coding patterns detection, persistent memory, preflight checks, and hybrid search with evidence scoring. Local-first MCP server.
VSCompare→
vibe logo
vibe★ 687
🎨 Vibe Design System - Official monday.com UI resources for application development in React.js
VSCompare→
arbor logo
arbor★ 161
Graph-native code intelligence that replaces embedding-based RAG with deterministic program understanding.
VSCompare→
See all alternatives →

Comments

Log in to leave a comment

No comments yet. Be the first!

On this page
01Features02Why choose it03Trade-offs04Maintenance check05Compatibility06Quick start07Use cases08Alternatives
chunkhound /
chunkhound
↗

Local-first MIT codebase search for AI assistants: semantic, regex and multi-hop code research over MCP

1.5k142MIT
Last commit1d ago
StatusActive
CategoryCode Assistant
Contributors31
Latest releasev6.1.0
Links
Documentation↗Discussion↗Issues↗Releases↗
Cloud Infrastructure
Ad

Deploy on DigitalOcean

Host your MCP servers, Docker containers, and AI agents with $200 free credit over 60 days.

Claim $200 Free Credit
© 2026 AgentIndex.app|Built by a 10-year iOS Developer.
Best by use caseAboutContactAdvertisePrivacy PolicyTerms of UseQYSGitHubBuy me a coffee ☕

Browse by Category

MCP ServersCode AssistantWorkflow AutomationRAG / Knowledge BaseMulti-AgentBrowser AutomationLLM InfraDev ToolingObservability

Not affiliated with Anthropic, OpenAI or Microsoft.