Controle de versão para agentes de programação: vincula cada commit à sessão do agente que o criou e permite que vários agentes compartilhem a memória do projeto.
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
Instale o CLI globalmente com npm
npm install -g @dzhng/jevgrep - 2
Salve a chave de API do provedor com auth
jg auth - 3
Instale a agent skill para que seu agente de programação saiba como usar jg
jg skill - 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
- Edição 2 · Um navegador headless em Rust para agentes e SQL tipado no TypeScript
Você pergunta em linguagem natural onde certo comportamento está no código e recebe lista de arquivos, trechos com número de linha e local das declarações, pensado para agentes. Analisa declarações em Python, TS/JS, Go e Rust.
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
CLI com foco em privacidade para busca semântica de código, com embeddings locais, rastreamento do grafo de chamadas e um servidor MCP para agentes de programação com IA.
Coleção de ferramentas CLI, skills, hooks e plugins que aumentam a produtividade no Claude Code e em outros agentes de programação via CLI.
Configura agentes de programação com IA, como Claude Code, Cursor, OpenCode e Codex, com memória persistente, workflows compartilhados, skills e servidores MCP.
Workbench desktop local-first que executa vários agentes de programação em paralelo, cada um em seu próprio git worktree, com diffs, editor, terminais e ações de PR em uma só janela.
Servidor MCP open source que permite que agentes de programação, como Claude Code, Codex e Cursor, troquem mensagens, reivindiquem arquivos e compartilhem o estado das tarefas localmente.