Repolode
Enviar
yoanbernabeu

yoanbernabeu/grepai

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.

Ver en GitHubSitio web
Estrellas
1,941
Forks
160
Issues abiertos
81
Último commit
hace 4 días

¿Qué es?

grepai es una herramienta de línea de comandos para buscar en bases de código por significado, en lugar de por coincidencias exactas de texto. Crea un índice vectorial del código mediante embeddings, de modo que una consulta en lenguaje natural como «flujo de autenticación de usuarios» pueda encontrar funciones relevantes aunque tengan otros nombres.

La herramienta funciona íntegramente en tu máquina y es compatible con proveedores locales de embeddings, como Ollama, además de LM Studio y OpenAI. Un observador de archivos en segundo plano mantiene el índice actualizado a medida que cambian los archivos. También incluye análisis del grafo de llamadas, para que puedas ver qué funciones llaman a una determinada antes de modificarla.

grepai se ofrece como servidor MCP, lo que permite que agentes de IA como Claude Code, Cursor y Windsurf lo utilicen como herramienta. El proyecto afirma que esto reduce los tokens de entrada que los agentes dedican a leer código, ya que reciben contexto específico en lugar de resultados de búsqueda sin procesar.

Funciones clave

  • 01Búsqueda semántica que encuentra código por intención, no por coincidencias exactas de texto
  • 02Análisis del grafo de llamadas para encontrar qué funciones llaman a una determinada
  • 03Funcionamiento íntegramente local con embeddings de Ollama, LM Studio u OpenAI
  • 04Observador de archivos que mantiene el índice actualizado automáticamente
  • 05Servidor MCP para que los agentes de IA utilicen grepai

Casos de uso

  • Permitir que Claude Code o Cursor encuentren código relevante sin leer archivos completos
  • Encontrar código por concepto cuando no se conoce el nombre exacto de la función
  • Comprobar qué funciones llaman a una determinada antes de refactorizarla
  • Buscar en una base de código privada sin enviar el código a servicios externos

Inicio rápido

  1. 1

    Instalar con Homebrew (macOS)

    brew install yoanbernabeu/tap/grepai
  2. 2

    Instalar un proveedor de embeddings: descargar con pull el modelo nomic-embed-text de Ollama

    ollama pull nomic-embed-text
  3. 3

    Inicializar grepai en el proyecto y, después, iniciar el daemon de indexación

    grepai init && grepai watch
  4. 4

    Buscar código por significado

    grepai search "error handling"

Antes de usarlo

  • Se necesita un proveedor de embeddings independiente, como Ollama, LM Studio u OpenAI.
  • En el README, la instalación en Linux y Windows se hace con un script de instalación de curl o PowerShell, no con un gestor de paquetes.

En colecciones

Servidores MCP para Claude CodeHerramientas, skills y plugins para Claude CodeAsistentes y agentes de programación con IAServidores MCPHerramientas de CLI y terminal

Temas

#code-search#semantic-search#embeddings#mcp#cli#vector-search#developer-tools#ai#claude-code#cursor

Preguntas frecuentes

¿Qué es grepai?
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. grepai es una herramienta de línea de comandos para buscar en bases de código por significado, en lugar de por coincidencias exactas de texto. Crea un índice vectorial del código mediante embeddings, de modo que una consulta en lenguaje natural como «flujo de autenticación de usuarios» pueda encontrar funciones relevantes aunque tengan otros nombres.
¿grepai es gratuito? ¿Qué licencia tiene?
grepai es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿grepai sigue mantenido?
Mantenimiento activo. El último commit de grepai fue el 2 nov 2026.
¿Para qué puedo usar grepai?
Permitir que Claude Code o Cursor encuentren código relevante sin leer archivos completos Encontrar código por concepto cuando no se conoce el nombre exacto de la función Comprobar qué funciones llaman a una determinada antes de refactorizarla Buscar en una base de código privada sin enviar el código a servicios externos
¿Cómo se instala grepai?
Instalar con Homebrew (macOS): brew install yoanbernabeu/tap/grepai Instalar un proveedor de embeddings: descargar con pull el modelo nomic-embed-text de Ollama: ollama pull nomic-embed-text Inicializar grepai en el proyecto y, después, iniciar el daemon de indexación: grepai init && grepai watch Buscar código por significado: grepai search "error handling"
¿Dónde consigo grepai?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/yoanbernabeu/grepai

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados