ChunkHound
Una herramienta de búsqueda semántica de código local con capacidades vectoriales y de expresiones regulares, diseñada para asistentes de IA.
Documentación
Todo tu contexto de ingeniería, profundamente comprendido.
Inteligencia de código abierto para bases de código que brinda a agentes y equipos contexto citado a través del código actual, el historial de git y la investigación técnica web.
Local-first · Decenas de lenguajes y tipos de archivo · Respuestas citadas · Investigación en historial de git · Investigación web precisa
Primeros pasos · Configuración · Referencia de CLI
Requisitos
- Python 3.10+
- uv — instala vía
curl -LsSf https://astral.sh/uv/install.sh | sh - Claves de API (opcional — la búsqueda regex funciona sin ninguna):
La IA escribe código a ciegas
Los agentes pueden generar código, pero aún les falta el contexto que hace que el software sea seguro de modificar: cómo fluye el comportamiento entre archivos, qué cambió en una rama o versión, y qué restricciones externas importan.
Los revisores, el soporte y los equipos de producto se topan con la misma pared cuando los PR grandes, los conflictos de fusión, los errores y las notas de versión necesitan explicación respaldada por la implementación en lugar de suposiciones.
ChunkHound convierte el código actual, el historial de git y la investigación técnica web en contexto citado antes de que alguien edite, revise, depure o explique software.
Comprensión profunda para cuatro tareas con mucho contexto
ChunkHound aplica la comprensión de la base de código a los flujos de trabajo donde la falta de contexto duele más.
Investigación antes de editar
Brinda a los agentes de codificación contexto de arquitectura fundamentado, archivos relevantes, cambios recientes y restricciones externas antes de que escriban código.
Comprender PR grandes y versiones
Convierte diffs de ramas, rangos de commits, etiquetas y commits específicos en informes de ingeniería citados para revisión, notas de versión y borradores de changelog.
Rastrear errores e incidentes
Convierte síntomas, trazas de pila e informes de clientes en rutas de código probables, cambios recientes y restricciones externas.
Conciliar el código con documentación externa
Identifica con precisión la documentación técnica, las API, los problemas y los artículos de los que depende tu implementación, y luego conecta esa evidencia externa con la investigación de código local.
Qué puedes preguntar
Fundamentar un agente antes de editar
chunkhound research "How does authentication work?"
chunkhound search "JWT refresh token validation"
chunkhound research "What changed in auth recently?" --last-n 20
Comprender un PR grande o una versión
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
Obtener contexto antes de resolver conflictos
chunkhound research "Why did auth session handling change on each side?" --commit-range main..feature/auth
chunkhound search "session refresh conflict" --last-n 50
Rastrear un error con restricciones 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"
Explicar el comportamiento del producto
chunkhound research "What happens when a user cancels a subscription?"
chunkhound research "What changed in billing since v2.4?" --commit-range v2.4..HEAD
Qué impulsa la comprensión profunda
- Búsqueda semántica de código — encuentra código relevante por significado, no solo por texto exacto
- Investigación de código citada — explica el comportamiento entre archivos con citas de fuente
- Investigación en historial de git — pregunta por los últimos N commits, hash de commit, etiqueta, rama o rango para comprender PR grandes y versiones
- Investigación web precisa — trae documentación externa citada, API, problemas y artículos al mismo flujo de trabajo que la investigación de código local
- Autodoc — genera documentación compartible a partir de investigación respaldada por código
- Indexación local-first — mantén la búsqueda e indexación de código bajo tu control
- Python, JavaScript, TypeScript, Java, Go, Rust, C/C++ y más vía Tree-sitter
Instalación
uv tool install chunkhound
Pruébalo
chunkhound index .
chunkhound research "How does authentication work?"
Indexa una vez, haz una pregunta real de arquitectura y obtén una respuesta fundamentada con citas. La búsqueda regex funciona sin proveedores. La búsqueda semántica requiere un proveedor de embeddings. La investigación profunda requiere un proveedor de LLM y un proveedor de embeddings con soporte de reranking; la investigación web usa la misma pila de proveedores. Elige proveedores locales para configuraciones con cero salida de código.
Para una configuración completa, crea .chunkhound.json en la raíz de tu proyecto:
{
"embedding": { "provider": "voyageai", "api_key": "your-key" },
"llm": { "provider": "claude-code-cli" }
}
Para integración con editores, todas las opciones de proveedores y configuración avanzada:
→ chunkhound.ai/docs/getting-started
Buscar en el historial de git
Además de buscar en tu base de código indexada, ChunkHound puede buscar cambios de código en el historial de git — útil para comprender qué cambió en un PR, una versión o desde un 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 el alcance:diff(predeterminado, solo código modificado),both(fusiona diff + DB),db(ignora diff).
Buen ajuste
ChunkHound es especialmente útil para:
- repositorios grandes y monorepos
- bases de código multilingües
- sistemas heredados
- entornos solo locales o sensibles a la seguridad
- equipos de ingeniería que quieren que las preguntas de agentes, soporte y producto estén fundamentadas en el mismo índice de código
Comunidad
ChunkHound tiene licencia MIT, es de código abierto y está construido por la comunidad.
Licencia
MIT