ChunkHound
Uma ferramenta de busca semântica de código local-first com capacidades vetoriais e regex, projetada para assistentes de IA.
Documentação
Todo o seu contexto de engenharia, profundamente compreendido.
Inteligência de base de código de código aberto que fornece a agentes e equipes contexto citado em código atual, histórico de git e pesquisa técnica na web.
Local-first · Dezenas de idiomas e tipos de arquivo · Respostas citadas · Pesquisa no histórico do Git · Pesquisa web precisa
Começando · Configuração · Referência da CLI
Requisitos
- Python 3.10+
- uv — instale via
curl -LsSf https://astral.sh/uv/install.sh | sh - Chaves de API (opcional — a pesquisa por regex funciona sem nenhuma):
IA escreve código às cegas
Agentes podem gerar código, mas ainda perdem o contexto que torna o software seguro para alterar: como o comportamento flui entre arquivos, o que mudou em um branch ou release, e quais restrições externas importam.
Revisores, suporte e equipes de produto enfrentam o mesmo obstáculo quando PRs grandes, conflitos de merge, bugs e notas de release precisam de explicação baseada na implementação em vez de suposições.
ChunkHound transforma código atual, histórico de git e pesquisa técnica na web em contexto citado antes que qualquer pessoa edite, revise, depure ou explique software.
Compreensão profunda para quatro tarefas com alto contexto
ChunkHound aplica compreensão da base de código aos fluxos de trabalho onde a falta de contexto causa mais dano.
Pesquisa antes de editar
Forneça a agentes de codificação contexto de arquitetura fundamentado, arquivos relevantes, mudanças recentes e restrições externas antes de escreverem código.
Entenda PRs grandes e releases
Transforme diffs de branch, intervalos de commits, tags e commits específicos em resumos de engenharia citados para revisão, notas de release e rascunhos de changelog.
Rastreie bugs e incidentes
Transforme sintomas, stack traces e relatos de clientes em caminhos de código prováveis, mudanças recentes e restrições externas.
Concilie código com documentação externa
Identifique com precisão os documentos técnicos, APIs, issues e artigos dos quais sua implementação depende e, em seguida, conecte essas evidências externas à pesquisa de código local.
O que você pode perguntar
Fundamente um agente antes de edições
chunkhound research "How does authentication work?"
chunkhound search "JWT refresh token validation"
chunkhound research "What changed in auth recently?" --last-n 20
Entenda um PR grande ou release
chunkhound research "Summarize the behavior changes on this branch for reviewers" --commit-range main..HEAD
chunkhound research "Draft changelog bullets for billing since v2.4" --commit-range v2.4..HEAD
chunkhound search "database migration" --commit-hash abc1234
Obtenha contexto antes de resolver conflitos
chunkhound research "Why did auth session handling change on each side?" --commit-range main..feature/auth
chunkhound search "session refresh conflict" --last-n 50
Rastreie um bug com restrições externas
chunkhound research "why would webhook retries fail?"
chunkhound research "what changed in webhook handling this week?" --last-n 30
chunkhound websearch "Stripe webhook retry schedule"
Explique o comportamento do produto
chunkhound research "What happens when a user cancels a subscription?"
chunkhound research "What changed in billing since v2.4?" --commit-range v2.4..HEAD
O que possibilita a compreensão profunda
- Pesquisa semântica de código — encontre código relevante pelo significado, não apenas pelo texto exato
- Pesquisa de código citada — explique o comportamento entre arquivos com citações de fonte
- Pesquisa no histórico do Git — pergunte pelos últimos N commits, hash de commit, tag, branch ou intervalo para entender PRs grandes e releases
- Pesquisa web precisa — traga documentos externos citados, APIs, issues e artigos para o mesmo fluxo de trabalho da pesquisa de código local
- Autodoc — gere documentação compartilhável a partir de pesquisa baseada em código
- Indexação local-first — mantenha a pesquisa e a indexação de código sob seu controle
- Python, JavaScript, TypeScript, Java, Go, Rust, C/C++, e mais via Tree-sitter
Instalação
uv tool install chunkhound
Experimente
chunkhound index .
chunkhound research "How does authentication work?"
Indexe uma vez, faça uma pergunta real de arquitetura e obtenha uma resposta fundamentada com citações. A pesquisa por regex funciona sem provedores. A pesquisa semântica requer um provedor de embeddings. A pesquisa profunda requer um provedor de LLM e um provedor de embeddings com suporte a reranking; a pesquisa web usa a mesma pilha de provedores. Escolha provedores locais para configurações com zero saída de código.
Para uma configuração completa e personalizável, crie .chunkhound.json na raiz do seu projeto:
{
"embedding": { "provider": "voyageai", "api_key": "your-key" },
"llm": { "provider": "claude-code-cli" }
}
Para integração com editor, todas as opções de provedor e configuração avançada:
→ chunkhound.ai/docs/getting-started
Pesquisar no histórico do Git
Além de pesquisar em sua base de código indexada, o ChunkHound pode pesquisar alterações de código no histórico do git — útil para entender o que mudou em um PR, em um release ou desde um commit específico.
# Last N commits
chunkhound search "authentication changes" --last-n 20
# Changes introduced by a specific commit
chunkhound search "database migration" --commit-hash abc1234
# Custom git range
chunkhound search "API changes" --commit-range v2.0..HEAD
# Deep research over recent changes
chunkhound research "what changed in the auth module?" --last-n 50
--vector-sourcecontrola o escopo:diff(padrão, apenas código alterado),both(mescla diff + DB),db(ignorar diff).
Boa adequação
ChunkHound é especialmente útil para:
- repositórios grandes e monorepos
- bases de código multilíngues
- sistemas legados
- ambientes somente locais ou sensíveis à segurança
- equipes de engenharia que desejam que agentes, suporte e perguntas de produto sejam fundamentados no mesmo índice de código
Comunidade
ChunkHound é licenciado sob MIT, de código aberto e construído pela comunidade.
Licença
MIT