Repolode
dzhng

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. 1

    使用 npm 全局安装 CLI

    npm install -g @dzhng/jevgrep
  2. 2

    使用 auth 命令保存提供商 API 密钥

    jg auth
  3. 3

    安装智能体技能,让编码智能体学会使用 jg

    jg skill
  4. 4

    对代码仓库提问

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

使用前须知

  • 需要 Node.js 22+,并需要受支持提供商(如 Vercel AI Gateway 或 OpenRouter)的 API 密钥。
  • 会将符合条件的源代码内容发送到所选外部提供商,且敏感文件检测仅为尽力而为。
  • 最适合跨越多个陌生文件的问题;对于已知符号,直接读取或 rg 搜索可能已足够。

入选 Repolode 开源周刊

收录于专题

标签

常见问题

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 数据每日更新。

相关项目