jevgrep

jevgrep 快速入门

jevgrep（dzhng/jevgrep）是给编码 agent 用的代码检索 CLI：你对仓库提一个「它在哪、怎么工作」的问题，jg 一条命令返回相关文件、阅读线索和逐字源码片段（stdout 一次给全）。内部用 Jev 模型在目录 / 文件 / 声明三层判断相关性。作者用十题 SWE-bench 实测：与无 jevgrep 基线同样完成 8/10 任务，单任务成本从 $7.62 降到 $5.44（约 -30%）。MIT + TypeScript。2026-10-02 核验（GitHub API + README）：1,995★ / 131 fork，创建于 2026-09-26、最近 push 2026-10-01（高频活跃）。

这是什么？适合谁？

编码 agent 在陌生任务上花的第一笔 token 往往不是写代码，而是「找对的文件」。jevgrep 把这一步外包出去：agent 不再自己 grep + 逐文件翻，而是调一次 jg，拿到精选过的文件位置、阅读线索（reading leads）和源码原文，直接开干。

工作方式（README 口径）：jevgrep 探索仓库层级、只沿「有希望」的分支下钻；用内容预览选文件；再识别有用的源码单元及上下文；即使自己判断不了也会保留合格文件的路径。默认文件系统过滤尊重 ignore 文件，排除隐藏/依赖/构建产物/二进制/疑似凭据文件。

十题实测（作者口径，含失败尝试、不含 Jev 本身成本）：两个 agent 都解出 8/10，加 jevgrep 的总成本 $5.44 vs 基线 $7.62，降 28.6%（约 30%）。

适合人群：重度使用 Claude Code / Codex / 各类 CLI agent 的开发者（给他们省找代码的 token）；维护大型陌生代码库的工程师（比手写 grep 链快）；做 agent 上下文优化的工程师（与已有的 fast-jev-compaction 思路互补：一个管压缩、一个管检索）。

不适合谁：不用编码 agent 的纯 IDE 用户（IDE 自带索引检索更顺手）；完全离线环境（检索要调 Jev API，源码内容会发往 provider）。

准备工作

1. Node.js 环境（TypeScript 项目，npm 全局安装）
2. Jev provider 的认证（检索请求通过 auth 时选定的 provider 发给 Jev；jevgrep 前缀 dzhng 同一作者的另一工具也是 Jev 生态）
3. 时间预算：安装 + 首次检索 10 分钟；给 agent 挂上并跑熟 1 小时内
4. 成本：工具 MIT 免费；Jev API 按量计费，但相比省下的主模型 token，作者实测净省约 30%
5. 前置知识：会用命令行、知道自己的 agent 怎么配置外部命令

核心用法：四步上手

第 1 步：全局安装

npm install -g jevgrep

第 2 步：完成认证

首次运行按提示完成 Jev provider 认证（源码内容会经所选 provider 发给 Jev，敏感仓库先读下面踩坑 3）。

第 3 步：在仓库里问第一个问题

jg "用户登录的 session 是在哪里创建和校验的？"

一次 stdout 拿到三类东西：相关文件路径、每个文件为什么相关的阅读线索、可直接引用的逐字源码片段。人自己用也行——把它当「会读代码的 grep」。

第 4 步：接进你的编码 agent

把 jg "<问题描述>" 配置为 agent 的可用命令（Claude Code 的自定义命令 / Codex 的工具配置均可），提示 agent 在开始陌生任务前先问一次 jg，而不是自己反复 grep。

常见踩坑

1. 症状：返回的文件不够全。 根因：jevgrep 刻意只沿「有希望」的分支下钻，是精选不是全量索引。解决：把问题描述得更具体（指向功能而不是泛泛的「代码结构」）；确实需要全量时退回传统 grep。
2. 症状：检索结果里混进了构建产物或依赖代码。 根因：默认过滤尊重 ignore 文件——如果构建产物没进 .gitignore，就不会被排除。解决：补全 ignore 规则后重试。
3. 症状：担心闭源代码外发。 根因：检索会把「合格的源码内容」通过所选 provider 发给 Jev，且 README 明说过滤规则「不是保证」。解决：敏感仓库不走 jevgrep；或先用 dry 方式确认会发送的内容范围。
4. 症状：省成本效果不明显。 根因：省的是「找文件」环节的 token——如果你的 agent 本来就很少做探索（或任务文件名一目了然），收益自然小；28.6% 是十题 SWE-bench 的实测口径，不是普适承诺。
5. 症状：认证或网络错误。 根因：Jev provider 认证失效或出口网络问题。解决：重新走 auth 流程；jg --help 查看诊断选项。

常见问题 FAQ

Q1: 它和 ripgrep / grep 有什么区别？

A: grep 家族按模式匹配，你得知道找什么字符串；jevgrep 按功能语义找——「处理退款的逻辑在哪」这种问题它直接给文件+线索+原文。两者互补：语义定位后仍可用 grep 精确展开。

Q2: 和昨天站上收录的 fast-jev-compaction 什么关系？

A: 同属 Jev 生态的 agent 上下文优化：fast-jev-compaction 管上下文「压缩」（删过时条目），jevgrep 管「输入」（一开始就少喂无关文件）。都用 Jev 决策模型，可叠加使用。

Q3: 支持哪些语言？

A: 官方未声明语言限制；按其「目录/文件/声明」三层模型，任何有源码文件的仓库都能跑，声明级精度在主流语言上最佳。

Q4: 数据隐私怎么算？

A: 搜索会把合格源码内容发给 Jev（经你选定的 provider）；默认过滤排除凭据文件但「不是保证」。闭源/敏感仓库慎用，这是官方 README 明示的边界。

Q5: 一定要编码 agent 才能用吗？

A: 不用。人肉接手陌生仓库时它就是「语义 grep」，一条命令拿到入口文件和线索，比翻目录快。

参考链接

• 官方仓库 dzhng/jevgrep
• Jev 模型页（Vercel AI Gateway）
• npm 包页

本文章基于公开资料整理，AI 辅助生成，独立实测与数据核验日期 2026-10-02（GitHub API 实时抓取 stars/fork/pushed/license；README 全文核验；未在本机做 npm 安装与检索实测）。