jevgrep

# JevGrep

[](https://www.npmjs.com/package/@nassim-arifette/jevgrep)
[](https://nodejs.org/)
[](https://www.typescriptlang.org/)
[](https://modelcontextprotocol.io/)
[](LICENSE)

**Find code by what it does.** JevGrep helps coding agents find relevant code when
they do not know the file name or symbol to search for.

Ask a question such as “Where is session expiry handled?” and JevGrep scans the
authorized repository, asks Jev to score all eligible fragments, then returns the
original source excerpts with their paths and line numbers. The calling agent can read
those files in detail and continue its work with less exploratory context.

Use the CLI or connect a coding agent
through the local MCP server.

## Demos

### CLI



### MCP



## What it is for

JevGrep is useful when a coding agent needs to:

- locate behaviour without knowing the exact identifier;
- understand a feature spread across implementation, configuration and tests;
- reduce the amount of repository exploration placed in the agent's main context;
- retrieve exact source excerpts instead of a generated summary.

It complements exact tools such as `rg`. If you already know the symbol or literal,
ordinary text search is usually faster.

## Requirements

- Node.js 24
- npm
- a TypeSafe AI, Vercel AI Gateway or OpenRouter API key

JevGrep searches every valid UTF-8 text file, regardless of repository language or
extension.

## Install

Install the public package from npm:

```bash
npm install -g @nassim-arifette/jevgrep
jevgrep --version
```

The unscoped package name `jevgrep` belongs to a different project. Use the complete
scoped name above when installing. The installed command is still `jevgrep`.

Package: [@nassim-arifette/jevgrep](https://www.npmjs.com/package/@nassim-arifette/jevgrep)

To i