dzhng/jevgrep

What is it?

Key features

• 01Answers natural-language questions about where behavior lives in a codebase.
• 02Returns a file list, source excerpts with line references and declaration locations.
• 03Parses declarations for Python, TypeScript/JavaScript, Go and Rust.
• 04Respects ignore files and filters hidden, binary and credential-like files by default.
• 05Includes `jg files` to count files a search would read, without a network request.

Use cases

• Locating authentication or request-handling logic in an unfamiliar repository.
• Finding which tests cover a specific behavior before changing code.
• Giving a coding agent starting context for a cross-file change.

Quick start

1. 1

   Install the CLI globally with npm

   npm install -g @dzhng/jevgrep
2. 2

   Save your provider API key with auth

   jg auth
3. 3

   Install the agent skill so your coding agent knows how to use jg

   jg skill
4. 4

   Ask a question about a repository

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

Things to know

• !Requires Node.js 22+ and an API key from a supported provider such as Vercel AI Gateway or OpenRouter.
• !Sends eligible source content to the selected external provider, and sensitive-file detection is best-effort only.
• !Most useful for questions spanning unfamiliar files; direct reads or rg may suffice for known symbols.

Featured in Repolode Weekly

• Issue #2 · A Rust headless browser for agents, and typed .sql imports

  Ask in plain language where some behavior lives in a codebase and get back a file list, source excerpts with line references and declaration locations, aimed at coding agents. Declarations are parsed for Python, TS/JS, Go and Rust.

In collections

Topics

FAQ

What is jevgrep?

A CLI that finds relevant code by natural-language question, returning files, leads and source excerpts for coding agents. Jevgrep (the `jg` command) answers questions about a codebase such as "How are telemetry events recorded and sent?" by returning relevant file locations, reading leads and verbatim source excerpts in one stdout response. It uses the Jev model to judge relevance across folders, files and declarations, so a coding agent can start from the right code instead of spending steps on manual search.

Is jevgrep free to use? What license does it have?

jevgrep is open source under the MIT license. Check the license terms before using it in commercial products.

Is jevgrep still maintained?

Actively maintained. The last commit to jevgrep was on Nov 7, 2026.

What can I use jevgrep for?

Locating authentication or request-handling logic in an unfamiliar repository. Finding which tests cover a specific behavior before changing code. Giving a coding agent starting context for a cross-file change.

How do I install jevgrep?

Install the CLI globally with npm: npm install -g @dzhng/jevgrep Save your provider API key with auth: jg auth Install the agent skill so your coding agent knows how to use jg: jg skill Ask a question about a repository: jg "How are telemetry events recorded and sent?" ./my-project

Where can I get jevgrep?

The source code and installation instructions are on GitHub: https://github.com/dzhng/jevgrep