Communityライティング&編集github.com

DerrickZeng33/find-files-with-everything-cli

Voidtools Everything の CLI を使用した高速な Windows ファイル検索を、Codex、Claude Code などの AI エージェント向けに提供します。

find-files-with-everything-cli とは?

このスキルは、Voidtools Everything のコマンドラインツール `es.exe` を読み取り専用クライアントとして使用し、Windows 環境で超高速にファイルを検索するためのものです。Everything インデックスを活用することで、従来の `dir` や `rg` よりもはるかに高速に、PC 全体または特定のパスからファイルを見つけ出せます。Codex、Claude Code、Cursor などの AI エージェントとの統合に最適化されており、ツール呼び出し回数と返却テキスト量を最小限に抑える設計になっています。クエリは `-n` オプションで結果数を制限し、`-path` や `ext:` などの Everything 検索語を使って効率的に絞り込みます。PowerShell 7 以降での呼び出し時には `-argv` を先頭に配置するなど、シェルごとの注意点もカバーしています。また、`-exit` や `-reindex` などの状態変更オプションは使用せず、あくまで読み取り専用の検索に留めることで、安全かつ予測可能な動作を保証します。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add DerrickZeng33/find-files-with-everything-cli

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Everything でファイルを検索する

es.exe を、実行中の Everything インデックスに対する読み取り専用クライアントとして使用します。ツール呼び出しと返却テキストを最小限に抑えます。

検索方法の選択

  1. 正確なパスがわかっている場合は Test-Path または Get-Item を使用します。
  2. 既知のワークスペース内のファイル名には rg --files、既知のツリー内のコンテンツには rg を使用します。
  3. 場所が不明な場合、ワークスペース外の場合、PC 全体の場合、またはインデックス化されたメタデータに基づく場合は、最初に Everything を使用します。

効率的なクエリを実行する

  1. セッションごとに最大 1 回、またはクエリ失敗後に可用性を確認します。

    Get-Command es.exe -ErrorAction SilentlyContinue
    

    それ以外の場合は、直接検索を実行します。ES が見つからないか、IPC エラー 8 が返された場合は、狭い範囲に限定したフォールバックを使用します。ユーザーが依頼しない限り、ソフトウェアのインストール、起動、修復は行わないでください。

  2. 出力を増やす前にクエリを絞り込みます。

    es.exe -n 20 "report"
    es.exe -path "C:\Work" /a-d -n 20 "ext:xlsx"
    es.exe -size -dm -n 20 "size:>1gb"
    

    フォルダには /ad、ファイルには /a-d、サブツリーには -path、そして ext:、size:、dm:、dc: などの Everything 検索語を使用します。スペースを含むパスと用語は引用符で囲みます。

  3. PowerShell 7 以降から呼び出す場合は、-argv を最初に配置します。Windows PowerShell 5.1 およびその他のシェルでは省略します。

  4. デフォルトではプレーンパスを返します。構造化メタデータが必要な場合にのみ -json と追加の列を使用します。カウントが重要な場合、または上限付きクエリをさらに絞り込む必要がある場合にのみ -get-result-count を使用します。

  5. デフォルトの上限は 20 に保ちます。上限に達した場合は、より多くの結果を要求する前にクエリを絞り込みます。依頼がない限り、結果をファイルにエクスポートしないでください。

結果を報告する

  • 最小限の十分な正確なパスのセットを返し、省略された一致を要約します。
  • 結果が見つからなかった場合は、クエリまたはスコープを明記します。
  • 結果がゼロの検索は、現在の Everything インデックスに関する証拠として扱いますが、インデックス化されていない場所が空であることの証明としては扱いません。
  • 既知のプロジェクトツリーに対して content: を使用しないでください。デフォルトではインデックス化されておらず、通常は rg よりも効率が悪いためです。

検索を読み取り専用に保つ

-exit、-reindex、-save-db、実行回数セッター、保存設定の変更など、ES の状態変更オプションは使用しないでください。ユーザーが個別に要求しない限り、結果の削除、移動、コピー、または開封を行わないでください。

関連スキル