Empirical

empirical-memory

Empirical を活用した、Claude Code、Codex CLI、GitHub Copilot CLI 向けの、ツールやプロジェクトをまたいで使えるメモリーです。

ChatGPT でアイデアを出し、コンテキストをすべて引き継いだまま、コーディングエージェントで続きを進められます。リードや人間関係を、別の CRM ではなく永続的なメモリーとして記録できます。個人、チーム、クライアントの用途に応じて、メモリーを個別のワークスペースに整理できます。セッションやプロジェクトをまたいで以前の決定、好み、慣例を呼び出し、作業中に新たな永続メモリーを保存するため、ほかの場所で共有済みのコンテキストを説明し直す必要はありません。

このマーケットプレイスで提供されるもの

• empirical-memory：必須のコアメモリー Skill と MCP サーバー接続です。
• empirical-work-history：完了した作業の簡潔な要約を提供するオプション機能です。
• empirical-scar-tissue：繰り返し発生する失敗パターンと、その予防方法を提供するオプション機能です。
• empirical-todo：ステータスと次のアクションを含む、プロジェクト別の ToDo を提供するオプション機能です。
• empirical-voice：保存済みの Empirical ライティングボイスを使って文章を作成するオプション機能です（有料の Writing Voice インタビューでボイスを保存する必要があります）。

各機能は独立したマーケットプレイスプラグインです。そのため、コアメモリー接続を変更せずに、オプション機能をインストールまたは削除できます。

パッケージのドキュメント：

• コア Empirical Memory
• 作業履歴
• 失敗の教訓
• ToDo
• ボイス

インストール

Claude Code

claude plugin marketplace add mattgauzza/empirical-memory-plugin
claude plugin install empirical-memory --scope user
claude plugin install empirical-voice@empirical-memory --scope user   # optional, writing voice

Codex CLI

codex marketplace add mattgauzza/empirical-memory-plugin
codex plugin add empirical-memory@empirical-memory

または、/plugins コマンドから参照／インストールできます。

GitHub Copilot CLI

copilot plugin marketplace add mattgauzza/empirical-memory-plugin
copilot plugin marketplace update empirical-memory
copilot plugin install empirical-memory@empirical-memory

または、/plugin install スラッシュコマンドを使用してください。

推奨：最新の empirical CLI をインストールする

MCP ツールは単独でも動作しますが、Skills は empirical CLI が利用可能な場合にそちらを優先します。 CLI を使うと、最も確実な認証方法を利用でき、メモリコマンドを直接実行できるほか、MCP ツールの検出を 追加で行う必要もありません。このプラグインには同梱されていないため、最新バージョンを別途 インストールまたは更新してください。

npm install -g @empirical-gauzza/cli

初回セットアップでは、対話型インストーラーを実行して、CLI と対応するコーディングエージェントを接続します。

empirical install

最新の CLI をインストールまたは更新しても、empirical install を再実行する必要はありません。 ネイティブプラグインだけを更新する場合は empirical plugin install all を使用するか、対話型の利用中に新しいマーケットプレイスプラグインが検出されたときに、CLI から一度だけ更新の提案を受けてください。 empirical plugin check --force を実行すると、すぐに確認できます。

永続的な API キーを使わずに CLI を通常どおり対話型で利用するには、empirical auth login を実行して、 ブラウザーからサインインし、ローカルに OAuth セッションを保存します。自動化や外部ランタイム向けに、 ヘッドレスでの初期セットアップも引き続き利用できます。

プラグインの MCP 接続だけが必要な場合は、CLI のインストールを省略できます。

CLI がすでにインストールされており、ネイティブプラグインのインストールまたは更新だけが必要な場合は、次を使用します。

empirical plugin install codex       # or copilot, claude, or all

--work-history、--scar-tissue、--todo、--voice、または --all-optional を指定して、オプション機能を明示的に追加できます。たとえば、empirical plugin install claude --voice を実行すると、保存済みの Empirical の文体で文章を作成する empirical-voice がインストールされます（有料機能です。事前に文体を保存する必要があります）。 ネイティブのマーケットプレイスコマンドも使用できます：claude plugin install empirical-voice@empirical-memory --scope user。

これによって、MCP／認証に関する一連の質問が実行されたり、グローバルな指示ファイルが変更されたりすることはありません。

empirical install の質問への回答で選択したオプション機能も、同じマーケットプレイス経由でインストールされます。いずれも、生のトランスクリプトやシークレットを記録しません。パーソナライズされた回答は、サーバー側の Empirical ポリシーとして保存され、ネイティブスキル用にローカルへキャッシュされます。グローバルな AGENTS.md、CLAUDE.md、Copilot の指示ファイルに書き込まれることはありません。

モード対応のスキルコンテンツ

skills/empirical-memory/ には、1 つではなく 4 つのファイルがあります。

• SKILL.mcp.md — ユーザーが MCP のみを選択したインストール向けです。MCP ツールを先に紹介し、CLI については補足としてのみ触れます。
• SKILL.cli.md — ユーザーが CLI 直接利用を選択したインストール向けです。自信を持って推奨できる方法として empirical CLI コマンドを先に紹介し、MCP にはフォールバックとしてのみ触れます。
• SKILL.both.md — ユーザーが両方を選択したインストール向けです。利用可能な場合は CLI を優先します（これはレイテンシやスクリプト作成上の好みによるものであり、現在では両方の方法で重複排除と自動リンクが同じように行われるため、安全性によるものではありません）。MCP はフォールバックとして使用します。
• SKILL.md — すべてのホストで、ネイティブのプラグイン機構が実際に読み込むファイルです（Claude Code、Codex CLI、GitHub Copilot CLI はいずれも、プラグインのスキルを文字どおりのファイル名 SKILL.md から解決します。インストール時に同じディレクトリにあるバリアントファイルから選択することをサポートするマニフェストスキーマは、どのホストにもありません）。モードを認識しない利用環境（古い CLI バージョン、Git の直接クローン、CLI がまったくインストールされていないホスト）にとって「両方」が最も安全なデフォルトであるため、SKILL.both.md と同じ内容にしています。

モードの選択を実際に反映するのは empirical CLI です。ネイティブプラグインのインストールまたは更新後、選択された統合モードに一致するバリアントで、そのホスト上のディスクにある SKILL.md を上書きします（メインの empirical_v2 リポジトリにある packages/cli/lib/installers/nativePlugin.js を参照してください）。この上書き処理がない、古い、または失敗した場合でも、すべてのインストールでこのリポジトリの「両方」スキルが機能します。ファイルがない、または壊れている状態にはなりません。

スキルのコンテンツを編集する場合、モードごとの「クエリ方法」や「記録方法」の仕組みについては SKILL.mcp.md、SKILL.cli.md、SKILL.both.md を更新してください。共有ポリシーセクション（作業を始める前に、現在のユーザーポリシーに従う、永続的なコンテキストを保存する、作成したスキルとキット、認証とエラー）は、3 つすべてで手動で一貫性を保ってください。これを強制するビルド処理はありません。SKILL.both.md を編集した後は、2 つのファイルの内容が異ならないよう、SKILL.md にコピーしてください。

cp skills/empirical-memory/SKILL.both.md skills/empirical-memory/SKILL.md

マニフェストのメンテナンス

このリポジトリは、それぞれ独自のマニフェスト形式を持つ 4 つのホストに公開されます。すべて、単一の信頼できる情報源である meta/manifests.json から生成されます。

生成ファイル	ホスト
.claude-plugin/plugin.json、.claude-plugin/marketplace.json	Claude Code
.codex-plugin/plugin.json	Codex CLI
.github/plugin/marketplace.json	GitHub Copilot CLI
.agents/plugins/marketplace.json	一般的な AGENTS.md

さらに、plugins/ 内の各ディレクトリにも .claude-plugin/ と .codex-plugin/ のペアがあります。

これらのファイルを手動で編集しないでください。meta/manifests.json を編集してから、再生成してください。

node scripts/build-manifests.mjs           # write the manifests
node scripts/build-manifests.mjs --check    # verify nothing drifted (CI runs this)
claude plugin validate . --strict           # same validator the plugin directory runs
npm install --no-save yaml && node scripts/check-skills.mjs   # every SKILL.md frontmatter must be valid YAML

バージョンを上げる場合は、1 か所だけ変更します。meta/manifests.json にあるプラグインの version です。マーケットプレイスの metadata.version は、ルートプラグインに合わせて自動的に更新されます。

ホスト固有のフィールドは、それぞれのホストに属します。interface は Codex／Copilot 向けのブロックです。Claude Code は不明なトップレベルフィールドを無視するため、.claude-plugin/ ファイルに interface を記述しても何も起こりません。Claude に対応するフィールドは displayName、description、homepage であり、longDescription、category、capabilities、defaultPrompt に相当するフィールドはありません。この対応関係はジェネレーターに実装されています。

ライセンス

MIT