面向编码智能体的版本追踪工具,把每次提交关联到生成它的会话,并让多个智能体共享项目记忆。
dzhng/jevgrep
一个命令行工具,用自然语言提问即可找到相关代码,为编程智能体返回文件、线索和源码片段。
- Star
- 3,185
- Fork
- 243
- 未关闭 Issue
- 10
- 最近提交
- 3天前
这是什么?
Jevgrep(命令为 `jg`)用于回答关于代码库的问题,例如“遥测事件是如何记录和发送的?”。它会在一次标准输出中返回相关文件位置、阅读线索和原文源码片段,借助 Jev 模型判断文件夹、文件和声明之间的相关性,让编程智能体直接从正确的代码开始,而不是靠手动逐步搜索。
工具会遍历仓库目录结构,依据内容预览筛选文件,并提取有用的代码单元及其上下文。声明解析支持 Python、TypeScript/JavaScript、Go 和 Rust,其他文本使用回退方式处理。默认过滤会跳过被忽略的文件、隐藏文件、二进制文件和明显的凭证文件;搜索时符合条件的源码会发送给配置时选定的服务商。
工具要求 Node.js 22+,支持 macOS、Linux 和 Windows,可接入 Vercel AI Gateway、TypeSafe、OpenRouter、OpenCode Zen 或兼容 TypeSafe 的自定义端点。运行 `jg skill` 可将智能体技能安装到检测到的 Claude Code、Codex、OpenCode 等编程智能体中。
核心功能
- 01用自然语言提问,定位代码库中某段行为所在的位置。
- 02返回文件列表、带行号的源码片段以及声明位置。
- 03支持 Python、TypeScript/JavaScript、Go 和 Rust 的声明解析。
- 04默认遵守忽略文件规则,并过滤隐藏文件、二进制文件和疑似凭证文件。
- 05提供 `jg files` 命令,无需网络请求即可统计搜索将读取的文件数量。
适用场景
- 在不熟悉的仓库中定位认证或请求处理逻辑。
- 修改代码前,查找覆盖某项具体行为的测试。
- 为编程智能体提供跨文件修改任务的初始上下文。
快速上手
- 1
使用 npm 全局安装 CLI
npm install -g @dzhng/jevgrep - 2
使用 auth 命令保存提供商 API 密钥
jg auth - 3
安装智能体技能,让编码智能体学会使用 jg
jg skill - 4
对代码仓库提问
jg "How are telemetry events recorded and sent?" ./my-project
使用前须知
- 需要 Node.js 22+,并需要受支持提供商(如 Vercel AI Gateway 或 OpenRouter)的 API 密钥。
- 会将符合条件的源代码内容发送到所选外部提供商,且敏感文件检测仅为尽力而为。
- 最适合跨越多个陌生文件的问题;对于已知符号,直接读取或 rg 搜索可能已足够。
入选 Repolode 开源周刊
- 第 2 期 · 给 AI 代理用的 Rust 无头浏览器,以及能做类型推断的 SQL 导入
用自然语言问“某个行为在代码哪里”,返回文件列表、带行号的源码片段和声明位置,专为编码代理设计。目前能解析 Python、TS/JS、Go 和 Rust 的声明。
收录于专题
标签
常见问题
- jevgrep 是什么?
- 一个命令行工具,用自然语言提问即可找到相关代码,为编程智能体返回文件、线索和源码片段。 Jevgrep(命令为 `jg`)用于回答关于代码库的问题,例如“遥测事件是如何记录和发送的?”。它会在一次标准输出中返回相关文件位置、阅读线索和原文源码片段,借助 Jev 模型判断文件夹、文件和声明之间的相关性,让编程智能体直接从正确的代码开始,而不是靠手动逐步搜索。
- jevgrep 可以免费使用吗?用的什么许可证?
- jevgrep 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
- jevgrep 还在维护吗?
- 活跃维护中。jevgrep 最近一次提交是在 2026年11月4日。
- jevgrep 适合用来做什么?
- 在不熟悉的仓库中定位认证或请求处理逻辑。 修改代码前,查找覆盖某项具体行为的测试。 为编程智能体提供跨文件修改任务的初始上下文。
- jevgrep 怎么安装和运行?
- 使用 npm 全局安装 CLI: npm install -g @dzhng/jevgrep 使用 auth 命令保存提供商 API 密钥: jg auth 安装智能体技能,让编码智能体学会使用 jg: jg skill 对代码仓库提问: jg "How are telemetry events recorded and sent?" ./my-project
- 在哪里获取 jevgrep?
- 源代码和安装说明在 GitHub 上:https://github.com/dzhng/jevgrep
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
本地运行的语义代码搜索命令行工具,支持调用图追踪,并可作为 MCP 服务供 AI 编程助手调用。
为 Claude Code 等命令行编程代理提供的一组 CLI 工具、技能、钩子和插件。
为 Claude Code、Cursor、OpenCode、Codex 等 AI 编程助手统一配置持久记忆、工作流、技能和 MCP 服务。
本地优先的桌面工作台,让多个编程智能体并行工作,每个任务使用独立 git worktree,并在同一窗口中完成代码审查与 PR 操作。
一个开源 MCP 服务器,让 Claude Code、Codex、Cursor 等编码智能体之间能实时通信并共享任务状态。