CLI con prioridad en la privacidad para buscar código por significado, con embeddings locales, análisis del grafo de llamadas y un servidor MCP para agentes de programación con IA.
cocoindex-io/cocoindex-code
CLI de búsqueda semántica de código basada en AST y servidor MCP que indexa tu base de código para que los agentes de programación encuentren código por su significado.
- Estrellas
- 2,968
- Forks
- 247
- Issues abiertos
- 62
- Último commit
- anteayer
¿Qué es?
cocoindex-code es una herramienta ligera para buscar código de forma semántica en bases de código locales. Analiza los archivos fuente con tree-sitter y los divide en fragmentos basados en AST, genera embeddings y guarda el índice localmente para que puedas buscar mediante descripciones en lenguaje natural en vez de texto exacto. Está basada en el motor de transformación de datos en Rust de CocoIndex y solo vuelve a indexar los archivos que han cambiado.
Puedes usarla desde la línea de comandos con órdenes como ccc index y ccc search, o conectarla a agentes de programación como Claude Code y Codex mediante un servidor MCP (ccc mcp) o una skill de agente instalable. El comando ccc grep, independiente, permite hacer búsquedas estructurales a partir de ejemplos de código sin necesidad de un índice.
Los embeddings pueden generarse con un modelo local de SentenceTransformers, que no requiere una clave de API si se instala con la opción extra completa, o con proveedores cloud a través de LiteLLM. La configuración se guarda en archivos YAML globales y por proyecto, y hay una imagen de Docker para entornos en contenedores.
Funciones clave
- 01Busca código por su significado mediante consultas en lenguaje natural, en vez de comparar texto exacto.
- 02Analiza muchos lenguajes con tree-sitter, incluidos Python, TypeScript, Rust, Go, Java y C/C++.
- 03Solo vuelve a indexar los archivos modificados para que las actualizaciones sean rápidas.
- 04Expone la búsqueda como herramienta MCP para agentes de programación como Claude Code y Codex.
- 05Admite modelos de embeddings locales o proveedores cloud de embeddings mediante LiteLLM.
- 06Incluye ccc grep para hacer búsquedas estructurales a partir de ejemplos de código sin un índice.
Casos de uso
- Ayudar a un agente de programación a encontrar código relevante en un repositorio grande que no conoce.
- Encontrar implementaciones describiendo su comportamiento cuando se desconoce el nombre exacto de la función o la variable.
- Reducir el uso de tokens de los agentes de programación recuperando solo los fragmentos de código relevantes.
- Buscar código privado localmente con un modelo de embeddings local y sin una clave de API.
Inicio rápido
- 1
Instala la CLI con pipx (incluye todo lo necesario)
pipx install 'cocoindex-code[full]' - 2
Instala la skill ccc en tu agente de programación
npx skills add cocoindex-io/cocoindex-code - 3
O crea el índice manualmente en tu proyecto
ccc index - 4
Busca en el código por significado
ccc search "authentication logic"
Antes de usarlo
- La instalación completa descarga aproximadamente 1 GB de torch y transformers para generar embeddings localmente.
- La variante slim requiere un proveedor de embeddings en la nube y una clave de API.
En colecciones
Temas
Preguntas frecuentes
- ¿Qué es cocoindex-code?
- CLI de búsqueda semántica de código basada en AST y servidor MCP que indexa tu base de código para que los agentes de programación encuentren código por su significado. cocoindex-code es una herramienta ligera para buscar código de forma semántica en bases de código locales. Analiza los archivos fuente con tree-sitter y los divide en fragmentos basados en AST, genera embeddings y guarda el índice localmente para que puedas buscar mediante descripciones en lenguaje natural en vez de texto exacto. Está basada en el motor de transformación de datos en Rust de CocoIndex y solo vuelve a indexar los archivos que han cambiado.
- ¿cocoindex-code es gratuito? ¿Qué licencia tiene?
- cocoindex-code es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
- ¿cocoindex-code sigue mantenido?
- Mantenimiento activo. El último commit de cocoindex-code fue el 5 nov 2026.
- ¿Para qué puedo usar cocoindex-code?
- Ayudar a un agente de programación a encontrar código relevante en un repositorio grande que no conoce. Encontrar implementaciones describiendo su comportamiento cuando se desconoce el nombre exacto de la función o la variable. Reducir el uso de tokens de los agentes de programación recuperando solo los fragmentos de código relevantes. Buscar código privado localmente con un modelo de embeddings local y sin una clave de API.
- ¿Cómo se instala cocoindex-code?
- Instala la CLI con pipx (incluye todo lo necesario): pipx install 'cocoindex-code[full]' Instala la skill ccc en tu agente de programación: npx skills add cocoindex-io/cocoindex-code O crea el índice manualmente en tu proyecto: ccc index Busca en el código por significado: ccc search "authentication logic"
- ¿Dónde consigo cocoindex-code?
- El código fuente y las instrucciones de instalación están en GitHub: https://github.com/cocoindex-io/cocoindex-code
Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.
Proyectos relacionados
Herramienta en Rust que crea un grafo semántico de conocimiento de tu código y ofrece herramientas de análisis mediante MCP para agentes de programación.
Convierte el código, la documentación, los esquemas y los PDF de un proyecto en un grafo de conocimiento consultable para asistentes de programación con IA, generado localmente mediante el análisis AST de tree-sitter.
Servidor MCP local de búsqueda semántica de código que permite a Claude Code, Codex, Cursor y OpenCode buscar por significado en tu base de código con embeddings de Ollama o LM Studio.
Un servidor MCP que indexa código, documentación e infraestructura en un grafo de conocimiento local para que los agentes de programación con IA consulten la estructura sin volver a leer archivos.
Indexa bases de código multilingües en un grafo de conocimiento para consultar, buscar y editar código en lenguaje natural mediante un agente de IA o un servidor MCP.