JevGrep CLI
JevGrep finds code from a description of what it does and returns lines with paths, as a CLI and as an agent MCP server.
- 112 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Source fragments and questions are sent to an external model provider.
- Automatic secret exclusion can miss sensitive files.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/nassim-arifette-jevgrepDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Source fragments and questions are sent to an external model provider.
- Automatic secret exclusion can miss sensitive files.
This is third-party code. Review the repository files before installing.
What it does
Semantic code search. A question like "Where is session expiry handled?" returns verbatim excerpts with `path:start-end` and a relevance score. The agent makes one call instead of a long walk through files, and the answer fits a set token budget, 8000 by default. Fragments are scored by the Jev model through TypeSafe AI, Vercel AI Gateway or OpenRouter, so a key from one of them is needed. A repository is authorized separately with `jevgrep init`, the tool asks consent before sending and `jevgrep inspect` shows which files would go. For Claude Code and Codex there is an MCP mode: `jevgrep mcp`.
Who it is for. Developers of large repositories where `grep` is powerless: they know what code does but forgot the function name.
Good fit when
- You need to find where user access to a project is checked.
- An agent must quickly learn what happens when a payment webhook arrives twice.
- The repository is too large for a model context window.
- Before the first search you check which files would go to the provider.
Not a fit when
- Code fragments cannot be sent to an external provider.
- The function name is known and `rg` is enough.
- Node.js 24 is not available on the machine.
Example request
Use jevgrep to find where this repository handles session expiry and show paths with line numbers.Limitations
Every search sends the provider matching repository fragments, the question, relative paths and the enclosing symbol name. Line numbers stay local. `.env` files, keys and dependencies are excluded, but secret detection can miss things, so run `jevgrep inspect` before the first search and extend `.jevgrepignore`. Node.js 24 is required. The unscoped `jevgrep` npm package belongs to another project: install `@nassim-arifette/jevgrep`. Comparison numbers in the README come from small question sets.
How to disable. Remove the package with `npm uninstall -g @nassim-arifette/jevgrep` and the MCP entry with `claude mcp remove jevgrep`. Provider keys live in the user config directory, delete them there and revoke at the provider.
FAQ
How do I ask a question?
`jevgrep search --query "Where is session expiry handled?"` prints excerpts with paths, lines and a score.
Which providers are supported?
TypeSafe AI by default, Vercel AI Gateway and OpenRouter. Set the key with `jevgrep init --global`.
How do I connect it to Claude Code?
Run `claude mcp add --transport stdio jevgrep -- jevgrep mcp --config "/absolute/path/to/config.json"`.
What goes to the provider?
Eligible code fragments, your question and relative paths. `.env` files and common credential files are excluded.
How is it different from `ripgrep`?
`ripgrep` searches text and names, JevGrep searches by meaning. In the author test of 55 questions JevGrep reached R@5 0.877 on Python against 0.325 for `ripgrep`.
Discussion
No questions or reviews yet.
Related
CLI toolsJevgrep
jevgrep
A CLI for coding agents: finds code by a task description rather than by a string. A key from one of the model providers is needed
Semantic code search and call graphs for agents, fully local. MCP mode connects the search to Claude Code and Cursor
Source search ranks matches using code structure and gives agents relevant snippets without a separate search index.
An MCP server that indexes code with tree-sitter and returns individual functions and classes to the agent instead of whole files
The zg local-first search tool: ripgrep, BM25 and vector search unified behind one interface for humans and agents
A Rust MCP server and CLI with a call graph and hybrid semantic code search for Claude Code and Codex
README in short
The README explains meaning-based code search, compares it with models, CodeGraph, BM25 and ripgrep and covers installation, provider setup, project authorization, privacy and MCP client setup.