Pathrule

English · Español · Français · Deutsch · 日本語 · Italiano · Türkçe · Português (Brasil)

AI は忘れます。Pathrule は覚えています。

コーディングエージェントのためのオープンソースのナレッジレイヤーです。Pathrule は、プロジェクトで得た知見を、コード内のパスに紐づくメモリー、ルール、スキルとして保持し、Claude Code、Codex、Cursor、GitHub Copilot、Windsurf に、作業を始める前に目の前のタスクに必要な情報だけを渡します。

PathruleBench、2,000 件：連鎖あたりのコストを55％削減 · 入力トークンを2.7倍削減 · メモリープローブの97％に合格 · 数値を見る

ウェブサイト · ドキュメント · クイックスタート · ベンチマーク · 使うほど賢く · 変更履歴

_{同じ依頼、同じエージェント。右側では、エージェントがコードを書き始める前に、Pathrule's hook が apps/web/dashboard に登録された3つのメモを渡しています。}

対応環境： Claude Code · Codex · Cursor · GitHub Copilot · Windsurf · あらゆる MCP クライアント

クイックスタート

macOS、Linux、Windows で Node.js 22.14.0 以降が必要です。

npm i -g @pathrule/cli
pathrule setup --local    # no account: knowledge stays on this machine
pathrule doctor           # see what each agent receives

エージェントを再起動してください。次のセッションから、エージェントはこれから変更するパスのメモを取得し、作業中に新しいメモを書き込みます。

その他の導入方法	コマンド	適した用途
VS Code 拡張機能	code --install-extension Pathrule.pathrule-vscode	コードのそばにナレッジを配置します。Marketplace と Open VSX で入手できます。
Claude Code / Codex プラグイン	/plugin marketplace add pathrule/pathrule · codex plugin marketplace add pathrule/pathrule	エージェント内からインストールします。セットアップでは、変更を加える前に計画が表示されます。
Cursor プラグイン	Cursor Marketplace → Pathrule	Cursor 内で同じフック、MCP、スキルを利用できます。
Gemini CLI / OpenCode プラグイン	gemini extensions install https://github.com/pathrule/gemini-cli-extension · opencode plugin @pathrule/opencode --global	Gemini CLI と OpenCode で同じセットアップを利用できます。
任意の MCP クライアント	npx -y @pathrule/mcp	プラグインシステムのないエージェントに適しています。公式 MCP Registry に掲載されています。
ローカルコンソール	pathrule ui	127.0.0.1 でナレッジを閲覧、編集できます。アカウントは不要です。
リモート MCP	claude mcp add --transport http pathrule https://cloud.pathrule.io/mcp	何もインストールせずに試せます。フックもローカルモードもありません。
ソースから	pnpm install && pnpm cli:bundle	Pathrule の開発に適しています。docs/quickstart.md をご覧ください。

一度説明すれば済みます

コーディングエージェントは、セッションのたびに何も知らない状態から始まります。そのため、同じ修正を何日も、エージェントを変えて何度も伝えることになります。

日	エージェント	入力した内容
月	Claude Code	「fetch ではなく、うちの api client を使って」	1回目
火	Claude Code	「もう一度：fetch ではなく api client で」	2回目
水	Codex	「api client を使っています。」	3回目
木	Cursor	「昨日も伝えました。api client です。」	4回目
金	Claude Code	「API CLIENT。FETCH ではありません。」	5回目

5つのセッション、3つのエージェント、何も覚えていません。Pathrule なら、一度伝えるだけです。

1. 一度だけ修正します。いつもどおりの方法で対応してください。
2. Pathrule が記録します。対象のコードのそば、つまり毎回セッションごとに読み込むファイルの一行ではなく、features/ のメモとして保存します。
3. 次のセッションから、どのエージェントにも共有されます。どのエージェントを開いても同じです。

必要な情報だけ

ワークスペースには何百ものメモが集まります。features/orders を編集するエージェントに必要なのは、そのうち4つです。

ナレッジはパス、スコープ、関連性に基づいて選ばれ、プロンプトごとの予算に収まるよう調整されます。適用必須のルールは、容量の都合で削られることはありません。収まらなかった情報はタイトル別に一覧表示されるため、エージェントは必要に応じて取得できます。プロンプトに関数名や型名が含まれる場合、フックはその定義があるファイルと行番号もエージェントに示します（JS/TS、Python、Go）。

3種類のナレッジ

種類	内容	features/ での例
メモリー	決定事項、注意点、インシデントを簡潔な Markdown で記録します。	「api client を使います。認証と再試行に対応しています。」
ルール	アドバイスより優先され、エージェントが従わなければならない制約です。	「データの読み込みには React Query を使います。」
スキル	エージェントが実行できる、再利用可能な手順やチェックリストです。	「完了とする前にチェックを実行します。」

3つの導入方法

チャネル	エージェントに届くタイミング	コスト
パススコープ付きルールファイル	Claude Code はセッション開始時に、Pathrule 独自の .claude/rules/pathrule/ を読み込みます。各ファイルの適用範囲はそれぞれのパスに限定されます。CLAUDE.md と AGENTS.md はそのままです。	クライアントによってキャッシュされます。
フック	エージェントが動作する前、セッション開始時、各プロンプト時、ファイルツールの実行時に送られます。新規または変更されたコンテキストのみが再送信されます。	プロンプトごとに予算が割り当てられます。
MCP get_context	エージェントが要求したときに、要求に必要な深さで取得します。	すべての MCP クライアントで利用できます。

CLAUDE.md だけではだめなのはなぜですか？

CLAUDE.md ファイルは各ステップで全体が読み込まれるため、チームがメモを追加するたびに、すべてのセッションのコストが増えます。Pathrule は、パスとタスクに必要な内容だけを各プロンプトに送信します。 PathruleBench では、同じエージェント、同じプロンプト、同じ非公開チェックを使って、チームのナレッジを500件から2,000件まで増やした場合の違いを測定しました。

ナレッジが500件から2,000件に増えると、CLAUDE.md を使った一連の実行のコストは89～98%増加します。Pathrule では増減が−1%～+10%に収まります。ナレッジベースは増やせますが、請求額は増えません。

_{Python、Go、TypeScriptで claude-sonnet-5-5 を使った Claude Code。2,000件の場合、各条件で9回の一連の実行（各言語で3回）。合否はすべて実行可能なテストで判定し、モデルによる判定はありません。Pathrule 条件では、このリポジトリのオープンソース CLI をローカルモードで使用：Cloud もモデルも使用しません。}

すべての条件、一連の実行とチェック、および自分で実行する方法 → pathrule/benchmark

使うほど賢くなります。

初日から、アカウントもネットワークもモデルも必要ありません。その後はすべて、このリポジトリであなたとエージェントがすでに行ったことを基盤に構築されます。

いつ	Pathrule が行うこと	実行場所
0日目 基盤	フックとローカル MCP サーバーがエージェントに組み込まれます。あなたが書いた内容は、フックと Claude Code のパス単位のルールを通じて、予算内でパスごとに届けられます。あなた自身の CLAUDE.md と AGENTS.md はそのまま残ります。	オープンソース、このマシン
1週目 記憶	プロンプトで伝えた決定（「今後は……」「……と決めました」）が、あなた自身の言葉で保存されます。失敗したコマンドから得た教訓は、一度だけ保存されます。それぞれのメモは関連するコードの隣に記録され、新規または変更されたコンテキストだけが再び送信されます。	オープンソース、このマシン
1か月目 あなたの習慣	あなたが伝えた好みは、自分専用のローカルファイルに保存されます。何気なく一度だけ伝えた内容は保留され、別のセッションでもう一度伝えると、すべてのエージェントに届きます。ずっと有効にすると指定した内容は、すぐに適用されます。プロジェクトのルールは個人のルールより常に優先されます。	オープンソース、このマシン
3か月目 大規模運用	メモが何千件あっても、セッションのサイズは変わりません。ルートのルールファイルは約6k文字に収まり、残りはプロンプトごとに届きます。コードの場所を示す文には (as of writing) が付けられるため、チームメイトがファイルを移動しても、エージェントはコードに従います。編集によって、より新しい決定で置き換えられた値が書き込まれると、その編集時にフックが該当する決定を引用します。	オープンソース、このマシン
必要に応じて チーム	すべてのマシンとメンバーで同じナレッジを利用できます。Cloud ワークスペースでは、Pathrule のフレーズルールで見つからなかったプロンプトをモデルが読み取り、あなたが残すつもりだった文を、あなた自身の言葉のまま保持します。費用は AI Credits から支払われます。	Pathrule Cloud、オプトイン

_{あなたのマシン上でモデルが動作することはありません。Team より前の機能はすべてオープンソースの CLI で、上記のベンチマークで測定されたものと同じ経路です。}

エージェントを切り替えても、ナレッジはそのまま。

エージェント	動作前の処理	指示ファイル	MCP
Claude Code	フック（プロンプトフックを含む）	Pathrule 独自の .claude/rules/pathrule/	ローカルまたはリモート
Codex	フック（プロンプトフックを含む）	—	ローカルまたはリモート
Cursor	—	—	ローカル
GitHub Copilot	—	—	ローカル
Windsurf	—	—	ローカル
任意の MCP クライアント	—	—	ローカルまたはリモート

ルールファイルを増やすだけではありません

	ルールファイル	Pathrule
作成	手作業で書き、手作業で最新の状態に保つ	あなたとエージェントの作業に応じて成長
届く範囲	ファイルごとに1つのツール	接続されたすべてのエージェント
提供方法	毎回のセッションですべてを提供	パスとタスクに必要なものだけを提供
変更	誰かが編集したとき	バージョン管理され、新しいナレッジが古いものに置き換わる

CLAUDE.md と AGENTS.md はそのまま使えます。Pathrule がこれらを編集することはありません。単一のファイルでは対応できない部分を補い、パスとタスクごとに残りの情報を届けます。

このリポジトリの内容

これは Pathrule のオープンソース基盤です。アカウントもネットワークサービスも不要で動作します。ストア、検索とランキング、MCP サーバー、フック、学習ループ、CLI が含まれています。

部分	含まれるか	ライセンス
基盤：プロトコル、エージェント IR、ローカルナレッジストア、ホスト、MCP サーバー、CLI、Pathrule Cloud クライアント、エージェント連携、ローカルコンソール、VS Code 拡張機能	はい	Apache-2.0
Pathrule Cloud：チームワークスペース、同期、ウェブコンソール、リモート MCP、Cloud モデルティア	いいえ	プロプライエタリ

11 個のパッケージ

protocol · agent-ir · core · integrations · mcp · host · ui · local-console · cloud · cli · vscode

pnpm install
pnpm typecheck      # every package
pnpm test           # every package's tests
pnpm build          # each package's npm build

コードはあなたのものです

• ソースコードが自動的にアップロードされることはありません。
• ローカルモードではアカウントもモデルの実行も不要で、オープン CLI はテレメトリーを一切送信しません。
• エージェントは独自のモデルプロバイダーを使います。Pathrule はモデルでも、エージェントでも、IDE でもありません。
• Pathrule Cloud はオプトイン方式です。サインインすると、ナレッジが保存され、プロンプトを使ってランキングされます。また、そのモデルティアは、長期的に残すべき決定を見つけるためにプロンプトを読み取る場合があります。

コミュニティ

コントリビューター

コントリビューション（DCO サインオフ） · 行動規範 · 脆弱性の報告 · サポートを受ける · 商標ポリシー

ライセンス

Apache-2.0。LICENSE と NOTICE をご覧ください。Pathrule の名称とロゴは Apache-2.0 ライセンスの対象ではありません。

pathrule.io · ドキュメント · Pathrule Cloud