Repolode
dzhng

dzhng/jevgrep

Una CLI que encuentra código relevante a partir de preguntas en lenguaje natural y devuelve archivos, pistas y fragmentos de código fuente para agentes de programación.

Estrellas
3,177
Forks
242
Issues abiertos
8
Último commit
anteayer

¿Qué es?

Jevgrep (el comando `jg`) responde preguntas sobre una base de código, como «¿Cómo se registran y envían los eventos de telemetría?», devolviendo en una sola respuesta por stdout ubicaciones de archivos relevantes, pistas para continuar la lectura y fragmentos literales del código fuente. Usa el modelo Jev para evaluar la relevancia en carpetas, archivos y declaraciones, de modo que un agente de programación pueda empezar por el código adecuado en lugar de dedicar pasos a buscar manualmente.

Explora la jerarquía del repositorio, selecciona archivos mediante vistas previas del contenido e identifica unidades de código fuente útiles junto con su contexto. El análisis de declaraciones abarca Python, TypeScript/JavaScript, Go y Rust; para otros textos se usa un mecanismo alternativo. Las búsquedas envían al proveedor seleccionado durante la configuración el código fuente que cumple los requisitos, y el filtrado predeterminado omite archivos ignorados, ocultos, binarios y que claramente contienen credenciales.

La herramienta funciona con Node.js 22 o posterior en macOS, Linux y Windows, y es compatible con Vercel AI Gateway, TypeSafe, OpenRouter, OpenCode Zen o un endpoint personalizado compatible con TypeSafe. El instalador `jg skill` añade una skill para agentes a los agentes de programación detectados, como Claude Code, Codex y OpenCode.

Funciones clave

  • 01Responde preguntas en lenguaje natural sobre dónde se encuentra una funcionalidad en una base de código.
  • 02Devuelve una lista de archivos, fragmentos de código fuente con referencias a líneas y ubicaciones de declaraciones.
  • 03Analiza declaraciones en Python, TypeScript/JavaScript, Go y Rust.
  • 04Respeta los archivos de exclusión y, de forma predeterminada, filtra archivos ocultos, binarios y que parecen contener credenciales.
  • 05Incluye `jg files` para contar los archivos que leería una búsqueda, sin realizar una solicitud de red.

Casos de uso

  • Localizar la lógica de autenticación o de gestión de solicitudes en un repositorio desconocido.
  • Encontrar qué pruebas cubren un comportamiento específico antes de modificar el código.
  • Proporcionar contexto inicial a un agente de programación para un cambio que abarca varios archivos.

Inicio rápido

  1. 1

    Instala el CLI globalmente con npm

    npm install -g @dzhng/jevgrep
  2. 2

    Guarda la clave de API de tu proveedor con auth

    jg auth
  3. 3

    Instala la agent skill para que tu agente de programación sepa cómo usar jg

    jg skill
  4. 4

    Haz una pregunta sobre un repositorio

    jg "How are telemetry events recorded and sent?" ./my-project

Antes de usarlo

  • Requiere Node.js 22 o superior y una clave de API de un proveedor compatible, como Vercel AI Gateway u OpenRouter.
  • El contenido fuente que cumpla los requisitos se envía al proveedor externo seleccionado, y la detección de archivos sensibles solo ofrece garantías razonables, no absolutas.
  • Es más útil para preguntas que abarcan archivos que no conoces; si ya sabes qué símbolos buscas, puede bastar con leerlos directamente o usar rg.

Destacado en Repolode Weekly

En colecciones

Temas

Preguntas frecuentes

¿Qué es jevgrep?
Una CLI que encuentra código relevante a partir de preguntas en lenguaje natural y devuelve archivos, pistas y fragmentos de código fuente para agentes de programación. Jevgrep (el comando `jg`) responde preguntas sobre una base de código, como «¿Cómo se registran y envían los eventos de telemetría?», devolviendo en una sola respuesta por stdout ubicaciones de archivos relevantes, pistas para continuar la lectura y fragmentos literales del código fuente. Usa el modelo Jev para evaluar la relevancia en carpetas, archivos y declaraciones, de modo que un agente de programación pueda empezar por el código adecuado en lugar de dedicar pasos a buscar manualmente.
¿jevgrep es gratuito? ¿Qué licencia tiene?
jevgrep es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿jevgrep sigue mantenido?
Mantenimiento activo. El último commit de jevgrep fue el 4 nov 2026.
¿Para qué puedo usar jevgrep?
Localizar la lógica de autenticación o de gestión de solicitudes en un repositorio desconocido. Encontrar qué pruebas cubren un comportamiento específico antes de modificar el código. Proporcionar contexto inicial a un agente de programación para un cambio que abarca varios archivos.
¿Cómo se instala jevgrep?
Instala el CLI globalmente con npm: npm install -g @dzhng/jevgrep Guarda la clave de API de tu proveedor con auth: jg auth Instala la agent skill para que tu agente de programación sepa cómo usar jg: jg skill Haz una pregunta sobre un repositorio: jg "How are telemetry events recorded and sent?" ./my-project
¿Dónde consigo jevgrep?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/dzhng/jevgrep

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

Proyectos relacionados