Repolode
cocoindex-io

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. 1

    Instala la CLI con pipx (incluye todo lo necesario)

    pipx install 'cocoindex-code[full]'
  2. 2

    Instala la skill ccc en tu agente de programación

    npx skills add cocoindex-io/cocoindex-code
  3. 3

    O crea el índice manualmente en tu proyecto

    ccc index
  4. 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