Paths-LE

Paths-LE：手間なくパスを抽出

キーを1回押すだけで、現在のファイルからすべてのファイルパスを抽出
JavaScript、TypeScript、JSON、YAML、HTML、CSS、TOML、CSV、Environment ファイル、そしてテキストスキャンによるその他すべてのファイル

便利ですか？ 星や評価を付けると、ほかの開発者にも見つけてもらいやすくなります — ★ GitHub · ★ Open VSX · ★ Marketplace

できること

ファイルを開いて Paths-LE: Extract Paths を実行すると、ドキュメント内のすべてのファイルパスが新しいエディターに表示されます。そこで重複を削除し、並べ替えられます。VS Code と、Cursor や VSCodium などの VS Code ベースのエディターで動作します（Open VSX からインストールできます）。

• インポート分析 — JS/TS のローカルインポートを抽出します。複数行のインポート文にも対応し、npm パッケージ名は除外されます
• アセット監査 — HTML/CSS 内のすべての src、href、srcset、url()、@import
• 設定の確認 — JSON/JSONC、YAML、TOML、CSV、.env ファイルからパスらしい値を抽出します
• その他あらゆるファイル — Python、Go、Markdown、XML、Dockerfile など。パーサーは使わず、テキストスキャンで引用符付きのファイル名と、パス区切り文字を含むあらゆる文字列を検出します

インストール

AI エージェントから使う

同じエンジンがMCPサーバーとして動作するため、コマンドを実行する代わりに、エージェントから直接呼び出せます。

extract_paths(content, format?, filename?, dedupe?, maxResults?)

ファイル、相対パス、絶対パス、URLに分類されたすべてのパスを、1始まりの行番号と列番号とともに返します。パスは記載されたとおりに報告され、ワークスペースを基準に解決したり、ディスク上のファイルに触れたりすることはありません。

サーバーはコンテンツを受け取ってデータを返します。ファイルの読み取りや、独自のネットワークリクエストは行いません。npmではpaths-le-mcpとして、MCPレジストリではio.github.nolindnaidoo/paths-leとして公開されています。

{
  "mcpServers": {
    "paths-le": {
      "command": "npx",
      "args": ["-y", "paths-le-mcp"]
    }
  }
}

npm install -g paths-le-mcp

{
  "mcpServers": {
    "paths-le": { "command": "paths-le-mcp" }
  }
}

echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | npx -y paths-le-mcp

Extract は、開いているドキュメントを読み取ります。スキャンではディスク上の多数のファイルを読み取り、1 つのレポートにまとめます。

• ワークスペース全体：コマンドパレットから Paths-LE: Extract Paths from Workspace を実行します。
• 1 つのフォルダー：エクスプローラーでフォルダーを右クリックして Extract Paths from Folder を選択するか、Paths-LE: Extract Paths from Folder を実行してフォルダーを選択します。

プロジェクトでは同じパスが何か所にも書かれるため、レポートには重複を除いたパスが使用頻度の高い順に表示され、それぞれの記載回数と記載場所も示されます。

# Paths-LE workspace report

`my-project` · 4 file(s) read · 2 distinct path(s), 4 occurrence(s) in 3 file(s)

| Path | Occurrences | Files |
|---|---|---|
| `./lib/util` | 3 | 2 |
| `./config/app.json` | 1 | 1 |

## `./lib/util` (3)

- `src/a.ts` · **1:20**, **2:20**
- `src/b.ts` · **1:20**

## `./config/app.json` (1)

- `deploy.json` · **2:14**

## Could not be read (1)

- `bad.csv`: Invalid CSV: quoted field is never closed (row 1, cell 2)

これは paths-le.showPositions がオンの場合です。デフォルトではオフになっており、その場合は各行にファイル名と、そのファイル内でのパスの記載回数が表示されます：src/a.ts (2)。クリップボードにコピーされる内容は、Extract と同様に paths-le.clipboardIncludesPositions に従います。

形式リーダーが読み取りを拒否したファイルは、理由とともに一覧表示され、決して見落とされることはありません。パスを含む不正な形式の CSV ファイルは、パスをまったく含まないファイルとは異なります。

スキャンでは、各パスが記載どおりに報告されます。resolution の設定にかかわらず、シンボリックリンクやワークスペース相対パスの解決は行いません。これらの設定は、1 台のマシン上にある 1 つのドキュメントを対象とするものです。

スキャンで読み取る内容。 ファイルはディスクから読み取られるため、保存していない編集は反映されません。安全サイズを超えるファイルや UTF-8 テキストではないファイルは読み取られません。5,000 ファイルまたは 10,000 件のパス出現に達すると停止します。レポートの末尾には、対象から除外された各項目が記載されるため、短いレポートをプロジェクトに問題がない証拠と誤解することはありません。

スキップされるものと、その変更方法。 デフォルトで 3 つのスイッチがオンになっており、それぞれ Settings で個別にオフにできます。

スイッチをオフにせずに結果を調整できるリストが 2 つあります。さらにスキップするには、scanExcludes にパターンを追加します。スイッチによってスキップされるものを読み取るには、scanAlwaysInclude に追加します。

{
	// Also skip the test fixtures.
	"paths-le.workspace.scanExcludes": ["**/fixtures/**"],
	// Read the vendored code, though the built-in list skips it.
	"paths-le.workspace.scanAlwaysInclude": ["**/vendor/**"]
}

Paths-LE: Open Settings を実行すると、Settings エディターでこれらすべてを開けます。

スキャンに関する設定は、Settings の下にあります。

CLI

同じ抽出処理をターミナルやエージェントのループから実行できます。このリポジトリのcrate/にあるRust製CLIは、拡張機能と同じコーパスcrate/fixtures/を共有しているため、2つの間でドキュメントの読み取り方に違いがあればCIで失敗します。npmからnpm install -g paths-leでインストールするか（またはnpx paths-leで実行）、crates.ioからcargo install paths-leでインストールできます。どちらも同じコマンドをインストールし、出力はバイト単位で完全に一致します。

エディターだけではできない処理も行います。見つけたものを、実行場所のファイルシステムに照らして解決します。 すべてのパスに判定結果が付きます。存在する、見つからない、監査対象ツリーの外に出ている、正規形式ではない、またはリンク先を明示したシンボリックリンクです。

npm (paths-le) またはcrates.io (paths-le) からインストールできます。 どちらも同じpaths-leコマンドをインストールします。

npm install -g paths-le   # or run it once: npx paths-le
cargo install paths-le

paths-le .                    # audit a tree; summary on stderr, JSON on stdout when piped
paths-le --strict .           # count sloppily-written paths too
paths-le --no-resolve src/    # just list what is written, touch nothing
paths-le mcp                  # the same audit over MCP on stdio

終了コードが答えです。0は問題なし、1は検出結果あり、2は質問の形式が不正です。そのため、paths-le --strict .はそのままCIのステップとして使えます。

対応形式

JS/TS、JSON/JSONC、HTML、CSS、テキストスキャンでは、位置は実際のソース位置（パスの正確な行と列）です。TOMLとYAMLではソーステキスト内の位置を特定しますが、同じ値が繰り返されている場合は概算になることがあります。CSVの位置は行／セル座標です。バージョン文字列（1.8.1）とIPアドレスはパスとして扱われません。また、HTML/CSSの抽出ではdata:／javascript: URLを除外します。裸のドメイン（example.com、www.example.org）はパスではありませんが、docs.rsのように国別コードの拡張子で終わる名前はパスとして扱われます。

テキストスキャンでは、引用符で囲まれている場合に限り、裸のname.extを対象とします。Pythonファイル内のos.pathとmain.pyは同じ形をしており、辞書を使わない限り両者を区別するルールはありません。しかし、ソースコードではファイル名を引用符で囲み、属性アクセスは引用符で囲まないため、引用符の有無で区別できます。シェルコマンドを含むYAMLスカラー（run: node ./scripts/build.js）はスペースを含む1つのトークンなので、JSONやTOMLと同様に、そこからパスは抽出されません。

コマンド

デフォルトでは、どのコマンドにもキーは割り当てられていません。エディターの Keyboard Shortcuts で、任意のキーを割り当ててください。

設定

言語

英語以外に12言語に対応しています。

ドイツ語 · スペイン語 · フランス語 · インドネシア語 · イタリア語 · 日本語 · 韓国語 · ポルトガル語（ブラジル） · ロシア語 · ウクライナ語 · ベトナム語 · 中国語（簡体字）

両方に対応しています。マニフェスト（コマンドのタイトル、設定名、説明）と、 拡張機能の実行中に表示されるすべての項目（通知、 ステータスバー、クイックピック、プロンプト）です。拡張機能は VS Code の 表示言語に従うため、エディターで現在設定されている言語に一致します。拡張機能独自の 設定はありません。

プライバシーとセキュリティ

• ネットワークアクセスはありません。 拡張機能がデータをどこかに送信することはありません。telemetryEnabled 設定は、確認できるローカルの出力チャンネル（Paths-LE Telemetry）にイベントを書き込むだけです。
• 正規化解決はオプトインで、事前に警告します。 シンボリックリンクやワークスペース相対パスを解決すると、結果ドキュメントに絶対ファイルシステムパスが含まれる場合があります。拡張機能は初回使用前に警告します。必要でない限り、両方の resolution.* 設定をオフのままにしてください。
• MCP サーバーも同じ方針を守ります。 コンテンツを引数として受け取り、データを返します。ファイルシステムへのアクセス、ネットワーク呼び出し、テレメトリーはありません。エージェントにはすでにファイル読み取りツールがあるため、サーバー内で重複させても機能が増えず、パストラバーサルのリスクが生じるだけです。サーバーがいずれかに到達できるものをインポートした場合、check:mcp-bundle はビルドを失敗させます。
• エラー通知では、ホームディレクトリと認証情報らしき文字列が伏せられます。
• 評価プロンプトは最大2回です。 3回目の正常な使用時に、拡張機能は評価していただけるか一度だけ尋ねます。後でを選ぶか、プロンプトを閉じた場合は、20回目にもう一度だけ尋ねます。再度表示しないを選ぶと終了します。notificationsLevel をご自身で important または silent に設定すると、プロンプトは無効になります。回数は VS Code の拡張機能ストレージに保存され、データがどこかに送信されることはありません。評価するを選ぶと、インストール元のマーケットプレース（VS Code Marketplace または Open VSX）がブラウザーで開きます。

ドキュメント

パフォーマンス

Apple M5 Pro、RAM 24 GB、Node 24.3.0 で、ウォームアップ後に7回実行した中央値です。入力はリポジトリに含めず、scripts/benchmark.ts で生成するため、上記のサイズは実際に測定した値と完全に一致します。bun run benchmark で再現できます。

これらの値はマシン固有であり、CI では検証されません。ビルドのゲートにベンチマークを使っても、ランナーがどれだけビジーだったかが分かるだけです。

テスト

38ファイルにわたる537件のテストケースに加え、実際の VS Code 拡張機能ホストで実行する統合テストスイートと、ビルドした .vsix をクリーンなプロファイルにインストールするエンドツーエンドテストがあります。

実際の実行結果である coverage/coverage-summary.json と coverage/test-results.json から、scripts/coverage-readme.js によって生成されます。このセクションに差異があると CI は失敗します。bun run test:coverage で再現できます。ケース数は vitest が出力する値です。

LE ファミリーのその他のツール

あらゆるモデルが直面する作業に対応する、単機能ツールが16個あります。それぞれに Rust CLI と MCP サーバーが付属します。詳細はこちら：letools.dev

取り出す

• String-LE — コードベース内のすべての文字列を抽出し、人が読めるようにします
• Numbers-LE — コードベース内のすべてのハードコードされた数値を抽出し、人が確認できるようにします
• Units-LE — 単位付きの数量をすべて抽出して正規化し、曖昧なものは名前を示して対象外にします
• Dates-LE — すべての日付とタイムスタンプ、およびそれぞれが解決される正確な時点を抽出します
• IDs-LE — UUID、ULID、NanoID、ObjectId、Snowflakeをすべて抽出し、内部に含まれる時刻をデコードします
• IPs-LE — IPアドレス、CIDRブロック、MACアドレスをすべて抽出し、正規化してスコープ別に分類します
• URLs-LE — コードベース内のすべてのURLを、プロトコルと正確な位置情報とともに抽出します
• Paths-LE — コードベース内のすべてのファイルパスを抽出し、現在も何かを指しているかどうかを示します
• Colors-LE — コードベース内のすべての色を抽出し、パレットにない色を示します

チェックする

• Regex-LE — コードベース内のすべての正規表現を検出し、壊滅的なバックトラッキングを引き起こす可能性があるものを報告します
• Versions-LE — リポジトリ内のマニフェスト間で、同じ依存関係のバージョン制約が異なる箇所を検出します
• i18n-LE — プロジェクトで使用している i18n ライブラリを特定し、そのライブラリのルールに基づいてカタログを監査します
• Scrape-LE — スクレイパーを書く前にページをスクレイピングできるか確認し、判定できない場合はその旨を示します

保護する

• Secrets-LE — コードベース内のハードコードされた認証情報を検出し、レポートに表示することはありません
• EnvSync-LE — ディレクトリツリー内の dotenv ファイルを比較し、どのファイルにどのキーがないかを示します
• Unicode-LE — 意味を隠す Unicode を検出します。双方向制御文字、不可視文字、ホモグリフ、混在スクリプトが対象です

それぞれが独立しています。共有クレートも、公開されたコアもありません。2つのツールが同じ答えにたどり着くとすれば、それはその答えが2度正しかったからです。

お問い合わせ — nolindnaidoo.com · GitHub · LinkedIn

nolindnaidoo によるその他のプロジェクト

Rust — pixelcoords と pixelactions は一連のループを構成します。pixelcoords が 場所 に答え、pixelactions がそこで 操作 します。それぞれ独自のツールと独自の方針を持ち、LE ファミリーには属しません。

• pixelcoords — 画面を固定し、領域を指定して、ピクセル単位で正確な座標と切り抜きを取得します pixelcoords.dev · crates.io · docs.rs
• pixelactions — 人が検証した座標を受け取り、操作を実行して、反映されたことを確認します pixelactions.dev · crates.io · docs.rs

ライセンス

MIT © nolindnaidoo