Repolode
dzhng

dzhng/jevgrep

自然言語の質問から関連コードを見つけ、コーディングエージェント向けにファイル、手掛かり、ソース抜粋を返すCLI。

スター
3,198
フォーク
245
未解決の Issue
10
最終コミット
6 時間前

これは何?

Jevgrep(`jg`コマンド)は、「テレメトリーイベントはどのように記録・送信される?」といったコードベースに関する質問に答え、関連ファイルの場所、読み進めるための手掛かり、ソースコードの原文抜粋をまとめて標準出力に返します。Jevモデルを使ってフォルダー、ファイル、宣言の関連性を判定するため、コーディングエージェントは手作業で検索に時間をかけず、適切なコードから作業を始められます。

リポジトリの階層を探索し、内容のプレビューを使ってファイルを選び、周辺のコンテキストとともに有用なソース単位を特定します。宣言の解析はPython、TypeScript/JavaScript、Go、Rustに対応し、それ以外のテキストにはフォールバック処理を使います。検索では、セットアップ時に選択したプロバイダーに対象ソースを送信します。デフォルトのフィルタリングでは、ignore対象、隠しファイル、バイナリファイル、明らかな認証情報ファイルを除外します。

Node.js 22以降で動作し、macOS、Linux、Windowsに対応しています。Vercel AI Gateway、TypeSafe、OpenRouter、OpenCode Zen、またはTypeSafe互換のカスタムエンドポイントを利用できます。`jg skill`インストーラーを使うと、Claude Code、Codex、OpenCodeなど、検出されたコーディングエージェントにエージェントスキルを追加できます。

主な機能

  • 01コードベース内で特定の動作を実装している場所を、自然言語の質問から探せます。
  • 02ファイル一覧、行参照付きのソース抜粋、宣言の場所を返します。
  • 03Python、TypeScript/JavaScript、Go、Rustの宣言を解析します。
  • 04ignoreファイルに従い、デフォルトで隠しファイル、バイナリファイル、認証情報らしきファイルを除外します。
  • 05ネットワークリクエストを送信せず、検索時に読み込まれるファイル数を数える`jg files`を利用できます。

ユースケース

  • 不慣れなリポジトリで、認証やリクエスト処理のロジックを探す。
  • コードを変更する前に、特定の動作をどのテストがカバーしているかを調べる。
  • 複数ファイルにまたがる変更に取りかかるコーディングエージェントに、最初の手掛かりとなる情報を渡す。

クイックスタート

  1. 1

    npmでCLIをグローバルインストールする

    npm install -g @dzhng/jevgrep
  2. 2

    authでプロバイダーのAPIキーを保存する

    jg auth
  3. 3

    コーディングエージェントがjgの使い方を把握できるよう、agent skillをインストールする

    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 とは?
自然言語の質問から関連コードを見つけ、コーディングエージェント向けにファイル、手掛かり、ソース抜粋を返すCLI。 Jevgrep(`jg`コマンド)は、「テレメトリーイベントはどのように記録・送信される?」といったコードベースに関する質問に答え、関連ファイルの場所、読み進めるための手掛かり、ソースコードの原文抜粋をまとめて標準出力に返します。Jevモデルを使ってフォルダー、ファイル、宣言の関連性を判定するため、コーディングエージェントは手作業で検索に時間をかけず、適切なコードから作業を始められます。
jevgrep は無料で使えますか?ライセンスは?
jevgrep は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
jevgrep は今もメンテナンスされていますか?
活発にメンテナンス中。jevgrep の最終コミットは 2026年11月7日 です。
jevgrep は何に使えますか?
不慣れなリポジトリで、認証やリクエスト処理のロジックを探す。 コードを変更する前に、特定の動作をどのテストがカバーしているかを調べる。 複数ファイルにまたがる変更に取りかかるコーディングエージェントに、最初の手掛かりとなる情報を渡す。
jevgrep のインストール方法は?
npmでCLIをグローバルインストールする: npm install -g @dzhng/jevgrep authでプロバイダーのAPIキーを保存する: jg auth コーディングエージェントがjgの使い方を把握できるよう、agent skillをインストールする: jg skill リポジトリについて質問する: jg "How are telemetry events recorded and sent?" ./my-project
jevgrep はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/dzhng/jevgrep

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト