aide-memory

aide-memory

AI コーディングエージェントとチーム向けの、自動記録・自動想起・パススコープ対応メモリです。

ウェブサイト： https://aide-memory.dev

ドキュメント： https://aide-memory.dev/docs

インストール： npm install -g aide-memory && aide-memory init

---

課題

エージェントを使ったコーディングにより、開発者の生産性は大幅に向上しました。しかし、新たな摩擦も生じています。

開発中の機能がシステムの他の部分とどう結び付くか、コードをどのように構成するのが好みか、この領域で従うべきパターンを説明します。エージェントは理解し、一緒に素晴らしい成果を出します。ところが、次のセッションでは何も引き継がれていません。同じことをもう一度説明することになります。

会話中に下された重要な決定が記録されていません。好み、修正、領域に関する知識、ガイドラインなど、価値あるコンテキストが残らず、次のセッションや別のツールに引き継がれません。同じ領域の作業を引き継ぐチームメイトのエージェントにも共有されません。

ルールファイル（CLAUDE.md、.cursorrules）は役立ちますが、実際には限界があります。

• 統一された規約や構成がありません。 チームのガイドライン、個人の好み、領域ごとの決定、技術スタックの事実が、1つのファイルに混在してしまいます。エージェントが作業している領域にほとんど関係がない場合でも、ファイル全体が毎ターン読み込まれます。
• 修正が反映されません。 会話の中でエージェントに教えたことが、自動でルールファイルに反映されることはありません。
• ツール固有です。 Claude Code でエージェントに教えたことは、手動でファイルをコピーしない限り Cursor には引き継がれません。
• スコープを考慮した想起ができません。 ファイル全体がコンテキストに読み込まれるか、何も読み込まれないかのどちらかです。エージェントが開いたファイルに基づいて、関連する情報だけを取得するよう促す手段はありません。

aide-memory はこうしたギャップを埋めます。ルールファイルの上位でも下位でもなく、ルールファイルと併用します。ルールファイルは常時適用される静的な指針に、aide-memory はコードベースとともに成長する動的でスコープ化された知識に使います。

---

仕組み

記録は自動で行われます

aide-memory init でインストールされる6つのフックが、セッションのライフサイクル全体で実行されます。

• UserPromptSubmit：修正（「いいえ、代わりに X を使ってください」など）を検出し、コード領域のスコープに合わせて保存するようエージェントに促します
• Stop：調整可能な間隔で定期的に振り返り（「覚えておく価値のあることはありますか？」）を行い、決定や発見を拾い上げます
• SessionStart：優先度の高い好み、ガイドライン、常時優先されるメモリを読み込み、コンテキストを踏まえてエージェントが開始できるようにします
• PreToolUse：エージェントがファイルを読み取る、または編集する前に、そのパスに関連するメモリがあるか確認し、想起を促します
• PostToolUse：想起された内容を記録し、再読み込みの際に再度促されないようにします
• PreCompact：コンテキストの圧縮前にセッションの追跡情報を消去し、圧縮後の読み取り時に適切に再度想起を促します

スコープに応じて想起します

メモリはグロブスコープ（src/components/dashboard/**、packages/api/**）を使ってコード領域に紐付けられます。エージェントがファイルを開くと、aide-memory は保存されたスコープとパスを照合し、その領域に関連する情報を提示します。

知識は4つのレイヤーで整理されます。

レイヤー	記録する内容	例
preferences	コントリビューターの作業上の好み	"Prefer modular component structure, separate concerns into smaller files"
technical	コードからは明らかでない事実	"Dashboard data fetching uses React Query with stale-while-revalidate"
area_context	コード領域に紐付いた決定	"Settings panel uses progressive disclosure; new sections follow the expand/collapse pattern"
guidelines	チーム全体の原則	"Mock external calls at the network boundary in tests, not at the function boundary"

想起では、まず area_context（最も具体的）、次に technical、preferences、guidelines の順に優先されます。スコープが設定されたメモリは、プロジェクト全体に適用されるメモリより優先されます。

チームで Git 同期

メモリーは .aide/memories/ 配下の JSON ファイルです。コミット、プッシュ、プルします。post-checkout git フックが git pull 後にローカルキャッシュを再構築するため、次回のファイル読み取り時に、チームメイトのエージェントがあなたのコンテキストを取得できます。個人設定（preferences/personal/）は gitignore されています。チームの規約はリポジトリとともに共有されます。

ツール間で共有

Claude Code と Cursor は同じ .aide/memories/ ディレクトリを読み取ります。一方のツールで記録したメモリーは、もう一方でも利用できます。Codex、Copilot、Windsurf には起動時にルールテンプレートが提供されます。ユーザーのフィードバックに基づき、より深い統合が実現する可能性があります。

---

クイックスタート

# 1. Install and initialize
npm install -g aide-memory
aide-memory init

# 2. Restart your editor so the MCP server registers
#    Claude Code: start a fresh session
#    Cursor: Cmd+Q, reopen, enable in Settings > MCP

# 3. Store a memory
aide-memory remember "Dashboard uses skeleton loading, not spinners" \
  --layer area_context --scope "src/components/dashboard/**"

# 4. Recall context for a path
aide-memory recall src/components/dashboard/

# 5. Share with your team
git add .aide/memories/
git commit -m "Capture dashboard conventions"
git push

詳細な手順：https://aide-memory.dev/docs/quick-start

---

含まれるもの

• 7 個の MCP ツール：aide_recall、aide_remember、aide_update、aide_forget、aide_search、aide_memories、aide_import
• 13 個の CLI コマンド：init、recall、remember、update、forget、search、list、stats、recall-log、config、sync、migrate、cleanup
• 6 個のフック：init 時にエディターに組み込まれます
• 4 種類の型付きメモリーレイヤー：設定は個人用と共有用に分けられます
• FTS5 キーワード検索と、Transformers.js または Ollama によるオプションのセマンティック検索

---

調整可能

aide-memory には、調整可能なデフォルト設定が用意されています。

• エージェントにコンテキストの振り返りと保存を促す頻度
• メモリーをファイルごとに表示するか、セッション開始時のみ表示するかを決めるスコープの具体性
• セッション開始時に注入するコンテキストの量
• 有効にするフック（ファイルごとのブロックを無効化する、修正の検出をオフにするなど）
• 個人用と共有用の設定（gitignore するかコミットするかをプロジェクトごとに設定可能）

aide-memory init は、公開設定をすべて .aide/config.json に初期設定します。詳細なリファレンス：https://aide-memory.dev/docs/configuration

---

プライバシー

メモリーの内容はお使いのマシン上に保持されます。どの機能が使われているかを把握するため、匿名化された使用件数（イベントの種類、ハッシュ化されたマシン ID、プラットフォーム、Node のバージョン）がデフォルトで PostHog に送信されます。AIDE_TELEMETRY=off で無効にできます。

---

エディターのサポート

エディター	状態
Claude Code	リファレンスアダプターです。MCP サーバーを登録するため、init の後に新しいセッションを開始してください。
Cursor	フックと MCP が完全に組み込まれています。init の後に Cmd+Q で終了して再度開き、Settings > MCP で aide-memory を ON にしてください。
Windsurf, Codex, Copilot	起動時にルールテンプレートが提供されます。ユーザーのフィードバックに基づき、より深い統合が実現する可能性があります。

エディターごとの詳細：https://aide-memory.dev/docs/supported-editors

---

要件

• Node.js 18 以降
• npm または npx

Docker、外部データベース、API キー、クラウドアカウントは不要です。

---

ライセンス

無料で利用できます。利用条件については LICENSE をご覧ください。

---

ドキュメント

すべてのドキュメント：https://aide-memory.dev

• クイックスタート
• 概念
• 設定
• リファレンス
• フック
• サポート対象エディター
• 比較
• よくある質問