grepai
Yoan Bernabeu · Programación
grepai es una herramienta de línea de comandos que prioriza la privacidad y busca en tu base de código por significado en lugar de por texto exacto. Crea un índice local de tu código con embeddings vectoriales, así que escribes "flujo de autenticación de usuario" y aterrizas en la función que lo gestiona, aunque tenga otro nombre. De paso rastrea quién llama y a quién, mantiene el índice al día con un vigilante de archivos y se conecta a asistentes de código con IA como Claude Code y Cursor mediante un servidor MCP. Todo corre en tu máquina. Nada se sube a ningún sitio.
Acerca de grepai
Qué es grepai
grepai es una CLI de código abierto para búsqueda semántica de código, creada por el desarrollador Yoan Bernabeu y publicada bajo licencia MIT. El nombre guiña un ojo al grep original de 1973, pero la idea es otra. El grep clásico casa patrones de texto. grepai convierte tus funciones y clases en vectores y casa significado, así que una búsqueda de "manejo de errores" puede sacar a la luz una función llamada catchException que nunca se te habría ocurrido teclear.
La herramienta nació para dos públicos. Los desarrolladores hartos de adivinar nombres de símbolos en repos grandes son el primero. El segundo son los agentes de IA de programación, que queman un montón de tokens haciendo grep y releyendo archivos antes de entender nada. Al darle a un agente una lista corta de código relevante en vez de la salida cruda de una búsqueda, grepai recorta los tokens de entrada que necesitan esos agentes. Usuarios de r/ClaudeAI han reportado justo eso. Un desarrollador contó que su gasto de tokens de entrada en Claude Code cayó en picado.
La limitación principal es la puesta en marcha. grepai necesita un proveedor de embeddings para convertir código en vectores, o sea que instalas Ollama y descargas un modelo, o entregas una clave de API para un proveedor en la nube. No es un comando que ejecutas y olvidas. En una máquina modesta, el primer índice de un repo grande también tarda. Para quien vive en la terminal, es un precio justo. Para el resto, probablemente sea más maquinaria de la que quieren.
Primeros pasos
- Instala grepai con el script de una línea para tu sistema, o usa Homebrew en macOS. En Windows, copia el comando de PowerShell de la página de GitHub.
- Descarga un modelo de embeddings para Ollama, normalmente
nomic-embed-text, porque los embeddings locales mantienen tu código en tu máquina. - Ejecuta
grepai initdentro de tu proyecto para crear la configuración y montar el índice. - Arranca
grepai watchpara que el vigilante de archivos mantenga el índice al día mientras editas. - Busca en inglés sencillo con
grepai search "error handling", o rastrea relaciones congrepai trace callers "Login".
Información del producto
Un vistazo rápido a los precios, las plataformas compatibles y el rendimiento de grepai.
Ideal para
Los usuarios, tareas y casos de uso en los que esta herramienta encaja mejor.
Usuarios
- Desarrolladores en bases de código grandes o desconocidas
- Usuarios de agentes de IA de programación
- Equipos que cuidan la privacidad
Tareas
- Explorar una base de código heredada
- Refactorización segura
- Dar contexto a un asistente de IA
Casos de uso
- Incorporarte a un proyecto nuevo y necesitar entender una función rápido
- Trabajar sin conexión
- Sesiones largas de programación donde los tokens se acumulan
Funciones clave
Búsqueda semántica en lenguaje natural
En lugar de casar patrones de texto, grepai convierte el código en embeddings y busca por significado. Describes lo que buscas, como "dónde validamos la entrada", y te devuelve código que no encontrarías con una palabra clave. ¿Y por qué importa eso? Porque las bases de código reales nunca nombran las cosas como esperas. Es la razón de peso para usarlo en lugar de ripgrep, y funciona entre convenciones de nombres que no encajan.
Trazado de grafos de llamadas
El comando grepai trace muestra quién llama a una función y qué llama esa función a su vez. Antes de una refactorización, eso te dice el radio de impacto de un cambio. Cubre una lista larga de lenguajes: Go, TypeScript, JavaScript, Python, PHP, Java, C#, F#, C, C++, Rust y Zig.
100% local y privado
Como herramienta local de búsqueda de código, grepai mantiene la indexación, los embeddings y la búsqueda en tu máquina cuando la apuntas a un modelo de Ollama. Sin nube. Sin llamadas a API. Sin código saliendo de tu portátil. Para equipos con código sensible, eso elimina la objeción habitual a la búsqueda asistida por IA.
Servidor MCP para agentes de IA
grepai incluye un servidor MCP para código, más un modo de salida JSON, así que las herramientas de IA pueden llamarlo directamente. Claude Code, Cursor, Windsurf, Codex CLI y Gemini CLI se integran con él. Eso deja que los agentes cojan contexto de código enfocado en vez de recorrer resultados crudos de grep, y es la función que ahorra más tokens en una sesión larga.
Actualizaciones del índice en tiempo real
Un vigilante de archivos mantiene el índice fresco mientras trabajas, así que no reindexas a mano tras cada cambio. Los resultados de búsqueda reflejan tus últimas ediciones, algo que importa cuando iteras rápido.
Un solo binario, instalación rápida
grepai se instala como un único binario sin dependencias. Según los números del propio proyecto, indexa 10k archivos en segundos y devuelve búsquedas en milisegundos. Eso lo mantiene usable en repos grandes.
Ventajas y desventajas
Ventajas
- Encuentra código por significado, así que los nombres que no encajan dejan de ser un obstáculo.
- Corre del todo en local con Ollama, manteniendo el código fuente fuera de cualquier servidor.
- Se integra con Claude Code, Cursor y otros agentes vía MCP, recortando el uso de tokens.
- Gratis y de código abierto bajo MIT, con instalación de una línea y un solo binario.
Desventajas
- Necesita un proveedor de embeddings, así que la puesta en marcha implica instalar Ollama o compartir una clave de API en la nube.
- La primera indexación de un repo grande tarda un rato en hardware modesto.
- El trazado de grafos de llamadas depende del soporte de lenguajes, así que algunos no están cubiertos.
Preguntas frecuentes
Indexa tu código por significado y te deja buscarlo en lenguaje natural, así que encuentras funciones relevantes aunque no sepas sus nombres. También rastrea relaciones de llamadas y puede pasar resultados a agentes de IA de programación.
Contenido relacionado
Explora herramientas, habilidades y artículos relacionados con grepai.
Alternativas a grepai
Base Code
Base44 (Wix) · Programación · ProductividadBase Code es un entorno de desarrollo en la nube compartido de Base44. El equipo describe cambios sobre un repositorio de GitHub en el chat, los ve en una vista previa y los envía como pull requests.
Google EmbeddingGemma 2
Google DeepMind · Escritura · Imagen · ProgramaciónGoogle EmbeddingGemma 2 es un modelo abierto de 740 millones de parámetros que convierte texto, código, imágenes, audio y fotogramas de vídeo en vectores de un mismo espacio de 768 dimensiones, y funciona en móviles y portátiles.
GitGlow
GitGlow · Programación · ProductividadGitGlow es un cliente Git de escritorio que reúne tu código y los cambios de tus agentes de IA en una sola revisión, para que sepas qué va a salir de tu máquina antes de publicarlo.