Repolode
dzhng

dzhng/jevgrep

Uma CLI que encontra código relevante a partir de perguntas em linguagem natural e retorna arquivos, pistas e trechos de código para agentes de programação.

Estrelas
3,185
Forks
243
Issues abertas
10
Último commit
há 3 dias

O que é?

O Jevgrep (comando `jg`) responde a perguntas sobre uma base de código, como "Como os eventos de telemetria são registrados e enviados?", retornando em uma única resposta no stdout locais de arquivos relevantes, pistas para leitura e trechos literais do código-fonte. Ele usa o modelo Jev para avaliar a relevância em pastas, arquivos e declarações, permitindo que um agente de programação comece pelo código certo em vez de gastar etapas em buscas manuais.

A ferramenta explora a hierarquia do repositório, seleciona arquivos com base em prévias do conteúdo e identifica unidades de código-fonte úteis com o contexto ao redor. A análise de declarações abrange Python, TypeScript/JavaScript, Go e Rust; outros textos são processados por um mecanismo alternativo. As buscas enviam ao provedor escolhido durante a configuração o código-fonte que se enquadra nos critérios, e a filtragem padrão ignora arquivos excluídos, ocultos, binários e que claramente contêm credenciais.

A ferramenta funciona com Node.js 22+ no macOS, Linux e Windows, e oferece suporte a Vercel AI Gateway, TypeSafe, OpenRouter, OpenCode Zen ou um endpoint compatível com TypeSafe personalizado. O instalador `jg skill` adiciona uma skill de agente aos agentes de programação detectados, como Claude Code, Codex e OpenCode.

Recursos principais

  • 01Responde a perguntas em linguagem natural sobre onde determinado comportamento está implementado na base de código.
  • 02Retorna uma lista de arquivos, trechos de código-fonte com referências a linhas e locais de declarações.
  • 03Analisa declarações em Python, TypeScript/JavaScript, Go e Rust.
  • 04Respeita arquivos de exclusão e, por padrão, filtra arquivos ocultos, binários e que parecem conter credenciais.
  • 05Inclui `jg files`, que conta os arquivos que uma busca leria sem fazer uma requisição de rede.

Casos de uso

  • Localizar a lógica de autenticação ou de tratamento de requisições em um repositório desconhecido.
  • Descobrir quais testes cobrem um comportamento específico antes de alterar o código.
  • Fornecer a um agente de programação o contexto inicial para uma alteração que envolve vários arquivos.

Início rápido

  1. 1

    Instale o CLI globalmente com npm

    npm install -g @dzhng/jevgrep
  2. 2

    Salve a chave de API do provedor com auth

    jg auth
  3. 3

    Instale a agent skill para que seu agente de programação saiba como usar jg

    jg skill
  4. 4

    Faça uma pergunta sobre um repositório

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

Antes de usar

  • Requer Node.js 22 ou superior e uma chave de API de um provedor compatível, como Vercel AI Gateway ou OpenRouter.
  • O conteúdo de origem que atender aos requisitos será enviado ao provedor externo selecionado, e a detecção de arquivos sensíveis é feita da melhor forma possível, sem garantia de perfeição.
  • É mais útil para perguntas que envolvem arquivos desconhecidos; se você já sabe quais símbolos procura, pode bastar ler os arquivos diretamente ou usar rg.

Destaque no Repolode Weekly

Em coleções

Tópicos

Perguntas frequentes

O que é jevgrep?
Uma CLI que encontra código relevante a partir de perguntas em linguagem natural e retorna arquivos, pistas e trechos de código para agentes de programação. O Jevgrep (comando `jg`) responde a perguntas sobre uma base de código, como "Como os eventos de telemetria são registrados e enviados?", retornando em uma única resposta no stdout locais de arquivos relevantes, pistas para leitura e trechos literais do código-fonte. Ele usa o modelo Jev para avaliar a relevância em pastas, arquivos e declarações, permitindo que um agente de programação comece pelo código certo em vez de gastar etapas em buscas manuais.
jevgrep é gratuito? Qual é a licença?
jevgrep é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
jevgrep ainda é mantido?
Manutenção ativa. O último commit de jevgrep foi em 4 de nov. de 2026.
Para que posso usar jevgrep?
Localizar a lógica de autenticação ou de tratamento de requisições em um repositório desconhecido. Descobrir quais testes cobrem um comportamento específico antes de alterar o código. Fornecer a um agente de programação o contexto inicial para uma alteração que envolve vários arquivos.
Como instalar jevgrep?
Instale o CLI globalmente com npm: npm install -g @dzhng/jevgrep Salve a chave de API do provedor com auth: jg auth Instale a agent skill para que seu agente de programação saiba como usar jg: jg skill Faça uma pergunta sobre um repositório: jg "How are telemetry events recorded and sent?" ./my-project
Onde consigo jevgrep?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/dzhng/jevgrep

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados