Pathrule for VS Code

Pathrule for VS Codeは、ネイティブのエディタサーフェスです。ワークスペースのナレッジツリー、コンテンツ編集、AIクライアントの設定をエディタの中で扱えるため、開いているフォルダがそのままワークスペースになり、編集中のファイルがそのままパスになります。VS Code、Cursor、Windsurfを主に使っていて、ナレッジをコードのすぐそばに置きたい方に適したサーフェスです。

役割を絞ったエディタサーフェスです。CLIが扱うのと同じコンテンツとフックを、普段使っているエディタから操作でき、外部クライアントの設定にはCLIのインストーラーをそのまま使います。

インストール

Visual Studio Marketplaceからインストールするか、Open VSXからインストールします。Open VSXに対応しているので、CursorやWindsurfにもインストールできます。ターミナルからは次のように実行します。

code --install-extension Pathrule.pathrule-vscode

エディタからは、Quick Openのプロンプトを開いて次を実行します。

ext install Pathrule.pathrule-vscode

Apache-2.0の下で無料かつオープンソースで提供されています。ローカルモードにはアカウントが不要なので、インストールしてすぐに使い始められます。

拡張機能が担う役割

• ナレッジツリー。 ナレッジを持つパスだけをリポジトリの構造どおりに表示するサイドバーで、各パスの下にメモリ、ルール、スキルがまとめて表示されます。コンテンツ数はツリーの各行のほか、組み込みエクスプローラーの対応するファイルやフォルダにもバッジとして表示されます。
• アクティブファイルとの同期。 ファイルを移動すると、ツリーがエディタに追従して現在のファイルをカバーする最も深いパスを表示し、ステータスバーにはそのパスとコンテンツ数が表示されます。
• コンテンツ編集。 メモリ、ルール、スキルは通常のMarkdownエディタタブとして開きます。保存はPathruleを通じて永続化され、エディタのツールもそのまま使えます。
• エージェント設定。 コマンド1つでAIクライアントを接続し、パス単位のフックをインストールします。CLIが行うのと同じ設定です。
• オンボーディング。 まだワークスペースのないフォルダを開くと、エディタを離れることなく、セットアップからワークスペースとの紐づけまで拡張機能が案内します。
• Doctor。 各クライアントが接続されているか、フックが存在するか、コンテキストサーバーに到達できるかを1つのコマンドで確認します。

ローカルモードとCloudモード

拡張機能は1つのユーザーインターフェースで2つのモードが動作します。CLIやオープンソースのコアと同じ構成です。

• ローカルモードにはアカウントが不要です。フォルダをローカルで初期化すると、メモリ、ルール、スキルは手元のマシンに保存されます。最も手早く始められる方法です。
• Cloudモードではサインインして、チームのレイヤーが加わります。共有ナレッジ、チームのアクティビティ、マネージドバックエンドです。

モードは開いているフォルダの属性として決まり、推測で判断されることはありません。サインイン済みのユーザーが、まだCloudワークスペースになっていないフォルダを開いた場合は、現在の組織にワークスペースを作成するか、ローカルで初期化するかを選べます。フォルダがローカルモードのとき、Cloud専用のアクションは壊れた状態で残るのではなく非表示になるため、1つの拡張機能で両方のモードに対応できます。

Markdownタブでの編集

ツリーからメモリ、ルール、スキルを開くと、通常のMarkdownタブとして開きます。普通のファイルと同じように編集し、保存すると変更が永続化されます。開いている間にチームメンバーが同じ項目を変更していた場合でも、保存によって相手の作業が黙って上書きされることはありません。再読み込みする、自分の版のコピーを残す、自分の内容で上書きする、のいずれかを選べます。競合は判断を求める形で示され、編集内容が失われることはありません。

エクスプローラーでファイルやフォルダを右クリックすると、Pathruleのサブメニューが表示されます。そこに適用されるナレッジを閲覧したり、そのパス単位の新しいメモリ、ルール、スキルを作成したりできます。ツリーの項目からは、プロンプト用のポインターとしてコピーする、詳細を表示する、名前を変更する、別のパスへ移動する、元に戻せる形で削除する、といった操作ができます。複数選択での一括移動と一括削除に対応しており、あいまい検索でワークスペース内のすべてのタイトルを横断して探せます。

CLIと共有されるアイデンティティ

拡張機能からのサインインには、CLIと同じホスト型のログインを使い、GitHub、Google、メールのいずれかを選べます。セッションは共有されるため、ここでサインインするとCLIもサインイン済みになり、一方で組織を切り替えるともう一方でも切り替わります。拡張機能、CLI、AIアシスタントの間で1つのアイデンティティを使います。

AIクライアントの接続

Connect AI clientsコマンド1つで、JSONを編集することなくアシスタントをPathruleに接続できます。

• GitHub Copilotのエージェントモードには、紐づけられたフォルダ向けに拡張機能がPathruleのMCPサーバーを登録します。
• Claude Code、Codex、Cursor、Windsurfには、CLIと同じインストーラーで管理されたMCPエントリが書き込まれます。
• フックはCLIと同じパイプラインでインストールされ、結果の通知には書き込まれた内容が正確に一覧表示されます。

設定が済むと、アシスタントは対応しているチャネルを通じて、現在のパスに関するPathruleのコンテキストを受け取ります。Claude CodeとCodexではプロンプトフックを含むフック、CursorとGitHub Copilotではセッションフックとツールフック、フックのないWindsurfではルールファイルとMCPです。Doctorコマンドはいつでも実行でき、各クライアントが接続されていて、フックが最新であることを確認できます。

チームでの利用

Cloudへの書き込みは共有されますが、現在のCloudバックエンドはリアルタイムのサブスクリプションを提供していません。最新の状態を読み込むには、ナレッジビューを更新するか、コンテキストを再度リクエストしてください。ローカルのフックや指示ファイルは、更新されるまで準備済みのナレッジを使います。組織レベルの作業はPathrule Webで行います。チーム管理、プランと請求、ワークスペース横断の概要は、エディタ内に再実装するのではなく、リンクからアクセスする形です。

ローカルモードで始めたフォルダをチームで使いたくなった場合は、1つのアクションでサインインし、組織を選び、ワークスペースとそのコンテンツをCloudへコピーできます。ローカルのコピーはフォールバックとして残ります。

Pathrule for VS Codeが向いている場面

主にVS Code、Cursor、Windsurfで作業していて、ワークスペースのナレッジツリー、コンテンツ編集、エージェント設定を、開いているフォルダとアクティブなファイルをすでに把握しているエディタの中で扱いたい場合は、拡張機能を使ってください。ローカルモードなら数秒で始められ、チームのレイヤーが必要になった時点で後からサインインできます。

ターミナル中心で作業する場合や、PathruleをCIにスクリプトで組み込む場合は、Pathrule CLIをおすすめします。どちらも同じサインインを共有しているので、併用もできます。

次に読むもの

• Pathrule CLI：同じアイデンティティとフックを共有する、ターミナル中心のランタイムです。
• オープンソースのコア：ローカルモードで何が動作し、Cloudで何が加わるかを説明しています。
• フックの仕組み：拡張機能がアシスタントに何を渡すかを説明しています。