Cogmemai Mcp

CogmemAi：Aiを正しい方向に保つ、安全で永続的なメモリ

重要なことを記憶し、設定したルールに反する動作を実行前に阻止し、Aiの実行内容を依頼内容と照らし合わせて確認します。アシスタント、エージェント、ロボット、車両、コードに対応します。

暴走したAiの事例はどれも同じです。Aiが行動を起こし、その判断と被害のあいだに何もありませんでした。CogmemAiは、その間に立つ存在です。あらゆるAiシステムに、セッション、デバイス、ユーザー、チームをまたいで記憶を保持する、持ち運び可能なメモリレイヤーを提供します。Aiが保存し忘れても自律的に知識を記録し、保存したルールを動作の実行前に適用し、完了した作業を意図と照らし合わせて確認します。長期メモリの最も難しいベンチマークであるLongMemEvalで精度95.10％を達成し、この分野で公表されている最高スコアを記録しています。 LoCoMoでは91％で、人間の成績（87.9％）を上回っています。量子耐性暗号化を採用。Claude Code、Cursor、Windsurf、Cline、Continue、およびMCP互換のあらゆるツールで動作します。エディター、モデル、マシンを切り替えても、知識とルールはそのまま維持されます。テストでひとつのスコアを出すだけではありません。現在利用できる、最も包括的で最も安全なAiメモリシステムです。

v3の新機能

ドキュメント：ローカルモードのキーに関する説明を統一（v3.32.4）

READMEでは、ある箇所ではローカルモードにキーは不要と説明し、ほかの3箇所では必要と説明していました。キーは必要です。無料のキーでインストールを登録しますが、ローカルモードでは保存したデータがマシンの外に出ることはありません。環境変数の表を修正し、README全体からダッシュ記号も取り除きました。コードの変更はありません。

Aiを正しい方向に保つ、安全なメモリ（v3.32.3）

コードの変更はありません。このパッケージは、GuardとReviewの目的を明確に示すようになりました。使用するAiが、暴走したAiとしてニュースの見出しを飾るような存在になってはなりません。保存したルールは、シェルコマンド、メッセージ、購入、変更のいずれであっても、動作の実行前に適用されます。また、完了した作業は依頼内容と照らし合わせて確認されます。Guard、Rule Packs、Intentをご覧ください。

想起結果の文字数上限（v3.32.0）

長いメモリは保存する価値がありますが、一度に10件読み込むとコストがかさみます。ツールの結果はすべて会話に残り、後続のターンごとに再び読み込まれるためです。recall_memoriesに、省略可能なmax_charsを追加しました。文字数上限を指定すると、評価の高いメモリは完全な形で返され、それ以外は400文字の抜粋で返されます。抜粋にはid、type、subject、scoreが保持され、それぞれにtruncatedと実際の文字数が付記されます。情報が隠されることはありません。同じクエリでrecall_memoriesを再度呼び出し、expand_ids: [..]を指定すれば、どのメモリも全文を読めます。また、すべての結果を取得するにはmax_chars: 0を指定します。独自の設定で文字数上限をデフォルトにするには、サーバーのenvにCOGMEMAI_RECALL_MAX_CHARS（たとえば8000）を設定してください。呼び出し時にmax_charsを指定した場合は、そちらが常に優先されます。実際の作業日を想定した12回の検索で再生テストを行ったところ、上限を8000にすると想起結果の出力を42％削減できました。上限を設定しなければ、結果はこれまでとまったく同じです。保存時の応答も簡潔になりました。save_memoryに含まれる関連メモリへのポインターは、id付きの300文字のプレビューになりました。統合を提案できるほど類似度が高い場合は、引き続き全文が返されます。

キーを貼り付けずにサインインし、ツールにアノテーションを付与（v3.31.2）

ホスト型エンドポイント https://hifriendbot.com/mcp/ が OAuth 2.1 に対応しました。OAuth 2.1 をサポートする MCP クライアント（claude.ai、Claude Desktop、Cursor など）は、エンドポイントの 401 応答から認可サーバーを検出して自身を登録し、CogmemAi の同意ページに移動してサインインすると、PKCE を使用したトークンを取得します。API キーもこれまでどおり使用できます。すべてのツールに MCP アノテーション（title、readOnlyHint、destructiveHint、idempotentHint）が付与されたため、クライアントはツールにラベルを付け、確認を求めるかどうかを判断できます。

移行：クラウド移行プレイブック（v3.31.0）

npx cogmemai-mcp migrate assess --target aws（または azure、gcp）を実行すると、リポジトリを読み取り、1 回の実行で移行計画を作成します。計画には、インベントリ（言語、フレームワーク、データストア、クラウド SDK、Infrastructure as Code、コンテナ、CI、スケジュールされたジョブ、環境変数名、外部ホスト、シークレットらしきファイルが含まれます。名前と件数のみを対象とし、ファイルの内容は取得せず、シークレットの値がマシンの外に出ることもありません）、プロジェクトの意図として記述される移行スコープ文書（移行対象、現状維持の対象、NEVER および MUST の不変条件、各フェーズの完了条件、対象外項目）、コンポーネント表、フェーズ、優先順位付きリスク一覧、コスト要因、未解決の質問を含む MIGRATION.md が含まれます。計画とリスクはメモリーとして保存され、migrate パック（インベントリを最初に作成する、一度に 1 つのワークロードを移行する、まず現状のまま移行してからモダナイズする、ロールバックをリハーサルする、件数とチェックサムでデータを検証する、一括同期ではドライランなしで削除しない、シークレットは再発行し、エクスポートしない、切り替え時は単一の書き込み元にする、廃止の 30 日前から移行元を読み取り専用にする、という 16 個のプロセスルール）と、移行先クラウドのパックがインストールされます。その後、各フェーズの終了時に cogmemai-mcp migrate gate "<phase>" を実行すると、スコープに照らして作業内容（コミット、変更ファイル、メモ、計画された手順）がレビューされ、カバレッジが 80 以上で違反がなければ合格となります。移行の記録を残せるよう、すべてのゲート結果が保存されます。さらに、各クラウド固有の CLI 形式で記述された 3 つの新しいクラウドパックが付属します。aws（20 個のルール）、azure（18 個）、gcp（17 個）には、root 権限やプリミティブロールを使わない、長期間有効なキーを使わない、管理用ポートやデータベースをインターネットに公開しない、バケットを公開しない、暗号化・バックアップ・削除保護を設定する、検知制御と監査ログを無効にしない、組織ポリシーと SCP を最低基準とする、承認済みリージョンとデータ所在地要件を守る、最初のワークロードの前に予算を設定する、すべてにタグを付ける、といったルールが含まれます。cogmemai-mcp migrate inventory を実行するとインベントリのみが出力され、--dry-run では送信内容を確認でき、--no-rules ではパックの適用をスキップし、--force では既存の意図を置き換えます。評価は、アカウントの日次上限内で MSGR ゲートウェイを通じて実行されます。

ルールパック：1 つのコマンドでセキュリティポリシーを適用（v3.30.0）

npx cogmemai-mcp rules install devsecops を実行すると、シークレット、Infrastructure as Code、最小権限、ネットワークへの公開、CI/CD ゲート、変更管理、コンテナと Kubernetes、データの取り扱い、ログ記録とインシデント対応に加え、インフラ上の AI エージェントが従うべきルールを網羅した、すぐに使える 40 個のルールがインストールされます。各ルールは通常のルールメモリーです。シェルパターンによってコマンドが実行前に停止され（terraform destroy、--acl public-read、curl | bash、kubectl delete namespace、export に貼り付けられたキーなど）、平文のルールは判定機能 guard_check とターン終了時のレビューで使われるため、シェルパターンに一致しなくても「本番環境のダンプを自分のノート PC にコピーする」は拒否されます。プロジェクトに意図文書がない場合は --intent を追加すると、プラットフォームとセキュリティに関する意図文書が作成されます。--global を付けるとすべてのプロジェクトにパックが適用され、--dry-run を付けるとインストールされる内容を確認できます。再インストール時には、すでに存在するルールはスキップされます。また、rules show devsecops を実行すると、適用を確定する前にパック全体を確認できます。適用後は、他のメモリーと同様にルールを編集できます。40 個すべてのルール、意図文書、およびエージェントが停止される様子を収めた 90 秒の動画は、hifriendbot.com/devsecops でご覧いただけます。

レビューは Git の外でも機能します（v3.29.0）

ターン終了時のレビューでは、git diff を読み取るために Git リポジトリが必要でした。ホームディレクトリから作業するフォルダーの多くはリポジトリではなく、コーディングをしない人のプロジェクトの多くも同様です。v3.29.0 では、代わりにこのセッションの編集イベントを読み取ります（PostToolUse フックはすでにすべての Edit と Write を記録しています）。そこから同じ形式の差分を作成し、追加されたテキストに秘密情報がないか確認し、編集されたファイルについて記憶している注意点を呼び出して、意図チェックを実行します。複数のプロジェクトを1つのフォルダーから作業している場合も、プロジェクトごとに判定します。たとえば、~/NullJury 内の編集は、NullJury に意図があればそれに照らしてレビューされ、メモにはそのプロジェクト ID が接頭辞として付けられます。リポジトリ内では何も変わりません。

コードだけでなく、あらゆるものをガードしてレビュー（v3.28.0）

これまでは、コーディングツールが提供するフックを使っていたため、ガードではシェルコマンドを判定し、意図レビューではコードの差分を判定していました。v3.28.0 では、2つのツールと2つの REST エンドポイントによって、どちらもあらゆる AI に対応します。

• guard_check：「これを実行してもよいですか？」実行しようとしているあらゆるアクション（送信前のメッセージ、購入、変更、コマンド）を、この人が AI に守るよう求めたルールと、プロジェクトの意図にある NEVER および MUST の行に照らして判定します。すべてのティアでリテラルチェックを実行し、有料ティアでは判定チェックも実行します。該当するルールとともに、許可、確認、拒否を返し、フェイルオープンで動作します。
• review_work：「依頼されたことを実行しましたか？」実行した内容の説明、出力、メッセージ、トランスクリプトを渡すと、意図ドキュメント、またはインラインで渡された意図に照らしてレビューされます。コードレビューと同じ平易な英語の結果を返します。要約、該当箇所、未対応箇所、違反、カバレッジが含まれます。

サポートアシスタント、コンパニオン、ロボットのタスクプランナー、コーディングエージェントは、あらゆるモデルの動作を形作る1つのメモリーを共有するようになります。記憶し、適用し、レビューします。同じ呼び出しは SDK（guardCheck / reviewWork、guard_check / review_work）でも、work フィールドを指定した REST の POST /cogmemai/guard-check と POST /cogmemai/intent-check でも利用できます。

CogmemAi の意図：コードではなく、意図を読む（v3.26.0）

リポジトリ内にある仕様ファイルは、リポジトリごと、ツールごとに異なり、次第に古くなります。v3.26.0 では、代わりにプロジェクトごとの平易な英語の意図ドキュメントを導入します。このドキュメントはあなたとともにあり、プロジェクトの目的、常に守るべきこと、決定事項とその理由、対象外のことを記します。set_intent で作成し、get_intent で読み取ります。すべてのセッションでルールの直後に読み込まれ、置き換えるたびにバージョン管理され、CogmemAi と通信するすべてのツールに引き継がれます。

さらに、仕様ファイルではできない2つのことを行います。Invariants の文は、ルールメモリーと同じ強制可能なパターンにコンパイルされるため、意図に NEVER run \pkill -u www lsphp` と記載すれば、ネットワーク呼び出しなしで、実行前にそのコマンドを拒否します。また、各ターンの終了時に、CogmemAi サーバー上のドキュメントに照らして変更を判定し、コードを読まない人にもわかる平易な英語で報告します。何が変わったか、意図でカバーされているか、意図と矛盾する点は何か、意図にまだ記載されていないことは何かを伝えます。意図でカバーされている変更については、通知しません。COGMEMAI_INTENT_VERBOSE=1を設定すると、判定が行われるターンごとに要約が表示されます。すべてのチェックは~/.cogmemai/intent-log.jsonl` に記録されるため、精度を推測ではなく測定できます。

判定チェックは有料ティアで実行されます。無料ティアでも、強制適用される不変条件と、すべての決定論的なレビューを利用できます。以下の意図をご覧ください。

CogmemAi ガード：メモリが Ai の同じ間違いを防ぐようになりました（v3.24.0）

アドバイスするだけのメモリは、プレッシャーがかかると Ai に無視されてしまいます。v3.24.0 では、プロジェクトが記憶していることを強制力のあるルールに変えるガードを追加しました。

PreToolUse フックが、すべてのシェルコマンドを実行前に判定します。組み込みの 6 つのルールは、無人で実行する正当な使い道がない操作を対象としています。パイプライン経由で crontab 全体を書き換えること、稼働中のデータベースに破壊的な SQL を実行すること、一時ファイルやビルド用のパス以外で再帰的に削除すること、共有ブランチに強制プッシュすること、ダウンロードしたファイルをシェルにパイプすること、名前を指定して共有サーバーワーカーを強制終了することです。同じルールは、ssh host "..."、bash -c "..."、シェルに渡されるヒアドキュメントの中にコマンドが含まれている場合にも適用されます。それらのペイロードは、記述どおりにリモート側で実行されるためです。

さらに、メモリレイヤーにしかできない機能があります。save_rule で保存したルールメモリは、強制適用できるパターンになります。ルールに NEVER run \pkill -u www lsphp`と書くと、次のセッションでは、そのコマンドが SSH 経由の場合も拒否され、そのルール自体の文言が理由として示されます。コードを編集する必要はありません。ルールにGUARD: の行を追加すると指定したパターンを適用でき、GUARD: off` を追加するとルールを助言にとどめられます。

Stop フックは、各ターンの終了時に実際に変更された内容を確認します。トラッキング対象のソースコードへの認証情報の貼り付け、リリースファイル間で一致しないバージョン文字列、削除されたファイル、大規模な行削除、複数の場所で定義された関数、変更したファイルに関する記憶済みの注意事項を確認します。結果を報告するだけで、編集はしません。

すべての判定は、秘密情報を伏せたうえでローカルに記録されるため、精度を推測ではなく測定できます。拒否時には、通常は「自分で実行する」といった、意図された次の手順が示されます。ガードはエラー時に処理を許可し、実際の取り消しは引き続き git で行います。詳しくは下記のガードをご覧ください。

v3.25.0 では Claude Code 以外にも対応します。guard shell-install は、BASH_ENV を通じてマシン上のすべての bash -c と zsh -c にフックを設定するため、Cursor、Codex、Gemini CLI、通常のスクリプトでも、同じガード、記憶済みのルール、ログが使われます。

ファイアウォールによるブロックを明確に報告（v3.20.0）

CogmemAi バックエンドへのリクエストが、上流のファイアウォール、CDN、またはプロキシによって遮断されると、レスポンスは JSON ではなく HTML になります。以前のバージョンでは、これを JSON として解析しようとして分かりにくい Unexpected token '<' エラーを投げ、その後、遮断された同じペイロードをひそかに再試行していました。v3.20.0 は HTML レスポンスを検出し、可能な場合は遮断したレイヤー（NinjaFirewall、Cloudflare、ModSecurity）を特定して、明確で対処可能なエラーを表示します。本文が HTML の再試行可能な 4xx レスポンスによって、再試行ループが発生することもなくなりました。メモリへの書き込みがひそかに失われる可能性のある種類のインシデントが、明確に報告されるようになりました。

自律型メモリ：メモリを保存するかどうかを Ai が決める必要はもうありません（v3.15）

あらゆるメモリシステムには、同じ隠れた失敗要因があります。**保存するかどうかを Ai が選ぶ必要があり、プレッシャーがかかると保存しないのです。**システムプロンプトに指示を組み込むことはできます。促すこともできます。しかし、Ai がコーディングタスクに没頭していると、保存を忘れ、2 時間前に行った決定がコンテキストの圧縮時に消えてしまいます。

CogmemAi v3.15 では、その決定を Ai の手から完全に離しました。コーディングセッションはインフラストラクチャレベルで記録され、決定、ファイルの変更、バグ修正、デプロイが、プロンプトを一切使わずにメモリに保存されます。セッションの終了時には、インテリジェンス処理によって情報が整理されたメモリにまとめられます。適切なタイプ、適切な重要度スコア、適切なスコープが設定されます。この処理が行われることを、Ai が認識することはありません。

その結果、集中的なコーディングを行った 1 日で、質の高いメモリが 3 件ではなく 15～20 件作成されます。次のセッションはシームレスに続けられます。Ai は、すでに決めたアーキテクチャ上の選択を蒸し返すことがなくなります。Ai に覚えるよう、何度も言うのはやめましょう。Ai は自動で覚えます。

プロアクティブなメモリ想起（v3.12）

CogmemAi は、発言する前に考えるようになりました。AI アシスタントがアクション、アプローチ、推奨事項を提案する前に、CogmemAi はあらゆるトピックについて、毎回自動的にメモリを確認します。

• preflight ツール：提案の前に毎回呼び出すことを想定した、高速で軽量な想起機能です。アシスタントは発言する前に、トピックについてすでに把握していることを確認します。「アプローチ X を試してみましょう」→ まず、X をすでに試したか、却下したか、完了したかを確認します。200 ミリ秒未満、コストはほぼゼロです。
• 過去のコンテキストの提示：メモリが保存されるたびに、CogmemAi はすべてのトピック、人、会社、技術的なアプローチ、機能などを対象に、関連する過去のメモリを自動的に検索し、応答に提示します。アシスタントが重複した提案をすることはありません。
• スマートな想起フック：Claude Code では、CogmemAi がユーザーのメッセージをすべて読み取り、アシスタントが応答する前に関連するメモリを自動的に挿入します。手動で想起する必要はなく、アシスタントが考え始める前にコンテキストが届きます。
• 強化された想起エンジン：高次元の意味理解、バランスの取れた再ランク付け、キーワードを拡張した検索、より確実に検索できるデュアルパスのメモリ保存、初期結果の信頼度が低い場合に自動で検索範囲を拡張する適応型検索を備えています。

その結果、AI アシスタントは、すでに試したこと、すでに連絡した人、すでに却下したアプローチを提案しなくなります。ツールが把握しておくべきことを、あなたの頭で補う必要はもうありません。

Wisdom Engine：原則の自動抽出（v3.10）

CogmemAi は、メモリ間のパターンを自動的に検出し、事実に基づく原則を抽出するようになりました。スキルが AI の振る舞い方（「常に Zustand を使用する」）を指示するのに対し、原則はプロジェクトについての事実（「このコードベースでは、サービス境界で入力の検証を行わない」）を伝えます。原則は、関連するメモリが 5 件以上集まったクラスターから抽出され、信頼度に基づいて評価されたうえで、すべてのセッションに挿入されます。extract_principles を使って手動で実行することも、自動実行に任せることもできます。

リモート MCP：インストール不要（v3.9）

CogmemAi はストリーミング可能な HTTP トランスポートに対応しました。何もインストールせずに、あらゆる MCP クライアントから接続できます。npm、設定ファイル、Node.js は不要です。API キーを使ってクライアントを https://hifriendbot.com/mcp/ に接続するだけで、すぐに永続メモリを利用できます。35 個のツール、同じ Intelligence Engine、ベンチマークでトップクラスの精度をそのままに、セットアップの手間はゼロです。

量子耐性暗号化（v3.7）

CogmemAi は初の量子耐性 AI メモリシステムです。クラウドモードとローカルモードの両方で、すべてのメモリは保存時に量子耐性暗号化によって暗号化されます。今日の脅威からも、明日の量子コンピューターからもデータを保護します。暗号化は自動で行われ、設定は不要で、デフォルトで有効です。セットアップの必要はありません。

ストレージモードを選択（v3.6）

CogmemAi は 3 つの方法で動作します。ワークフローに合ったものを選んでください。

	クラウド（デフォルト）	ローカル	ハイブリッド
おすすめの用途	高度なインテリジェンス、チームコラボレーション、デバイス間でのデータ移行	設定不要ですぐに開始、オフライン専用の環境	ローカルの速度とクラウドの高性能機能を両立、旅行中やネットワークが不安定な環境
セットアップ	npx cogmemai-mcp setup（クラウドを選択）	npx cogmemai-mcp setup（ローカルを選択）	npx cogmemai-mcp setup（ハイブリッドを選択）
API キーが必要	はい（無料）	はい（無料）。ライセンスキーのようなもので、データはローカルに保存されます	はい（無料）
検索	セマンティック検索（意味による検索）	全文検索（FTS5）	セマンティック検索（ローカルへのフォールバック付き）
インテリジェンスエンジン	フル機能、自動リンク、矛盾検出、メモリ減衰、自動スキル、クエリ合成	FTS5 検索＋CRUD。データはお使いのマシンに保存されます	フル機能。オフライン時も利用可能
チームコラボレーション	はい	いいえ	はい
デバイス間同期	自動	いいえ。データはお使いのマシンに保存されます	ローカルキャッシュを使って自動同期
オフライン対応	インターネット接続が必要	完全オフライン	オフライン時はローカルにフォールバック
暗号化	量子耐性（サーバー）	量子耐性（ローカル）	量子耐性（両方）

おすすめの利用体験はクラウドモードです。 フル機能のインテリジェンスエンジン、意味からメモリを見つけるセマンティック検索、自動リンクによるナレッジグラフ、矛盾検出、自己改善型の想起、自動スキル、クエリ合成、チームコラボレーションを利用できます。CogmemAi を単なるデータベース以上のものにしている機能がすべて揃っています。

ローカルモードでは、データをお使いのマシンに保存します。 登録には無料の API キーが必要ですが（ソフトウェアのライセンスキーのようなものです）、すべてのデータはローカルに保存されます。全文検索（FTS5）により、質の高い想起を実現します。初期セットアップ後はオフラインで動作します。セマンティック検索とフル機能のインテリジェンスエンジンを使いたくなったら、1 つのコマンドでクラウドにアップグレードできます。

ハイブリッドモードは、旅行する開発者やネットワークが不安定な環境で作業する開発者向けです。 ローカルとクラウドの両方に同時に保存します。クラウドが利用できる場合はクラウドから読み込み、オフライン時はローカルにフォールバックします。未同期のメモリは、接続が復旧すると自動的にクラウドへ送信されます。

インテリジェンスエンジン＋自動スキル（v3.5）

CogmemAi は使うたびに賢くなります。インテリジェンスエンジンは、重要な情報を学習し、関連する知識を自動的に結び付け、すべてのメモリから回答を合成する自己改善型のメモリシステムです。自動スキルはさらに機能を広げます。CogmemAi は記憶するだけでなく、どう振る舞うべきかを学習します。

自動スキル（クローズドループ学習）

• 行動スキル：CogmemAi は、修正、好み、パターンを自動的に行動指針へとまとめます。これは、何を知っているべきかだけでなく、AI アシスタントがどのように作業するべきかを示します
• クローズドループ学習：アシスタントを一度修正すると、CogmemAi がそのパターンを検出します。十分な証拠が蓄積されると、同じ間違いが二度と起きないようにするスキルを生成します
• 信頼度の追跡：各スキルには信頼度スコアがあり、うまく機能すると上昇し、機能しないと低下します。信頼度の低いスキルは自動的に廃止されます
• 自己評価：スキルは新たな証拠に照らして定期的に自己評価し、習慣の変化に合わせて適応、強化、または廃止されます

インテリジェンスエンジン：LongMemEval で 95.10％、LoCoMo で 91％

CogmemAi は、最も難易度の高い長期記憶ベンチマークである LongMemEval で**精度 95.10％を記録し、公開済みのスコアでトップに立っています。また、LoCoMo では検索ヒット率 100％で精度 91％**を記録し、人間の成績（87.9％）を上回っています。2 つのベンチマークで、どちらもトップ層のスコアを達成しています。必要なときに、CogmemAi が適切な記憶を見つけます。

• 精密な再ランク付け：想起のたびに 2 段階目の再ランカーが候補を精査し、精度を高めます。初期ランキングのシグナルとのバランスを取りながら、最も関連性の高い記憶を最初に提示します
• 自己改善する想起：一貫して役立つ記憶は、時間とともに順位が上がります。使われない記憶は自然に薄れていきます。セッションを重ねるごとに、想起の品質が自動的に向上します
• 信頼度を考慮した想起：検証済みとしてマークされた事実は未検証の事実より優先されます。また、修正内容を保存すると、置き換えられた記憶は無効になるため、修正後の認識が元の認識と競合することはありません
• 自動リンク付きナレッジグラフ：記憶を保存すると、関連する記憶が自動的に接続されます。知識は平坦なリストではなく、関係性のネットワークとして蓄積されます
• 矛盾の検出：想起された記憶同士が矛盾する場合、CogmemAi がその矛盾を知らせるため、古くなった情報が問題を引き起こす前に気づけます
• コンテキストを考慮したランキング：取り組んでいる作業（デバッグ、計画、レビューなど）を CogmemAi に伝えると、適切な種類の記憶が優先されます。デバッグ中なら、バグ報告やパターンが最初に表示されます。計画中なら、アーキテクチャ上の決定が優先されます
• クエリの統合：質問すると、単なる一致項目のリストではなく、関連するすべての記憶をもとに統合された一貫性のある回答が得られます。すべてを読んだチームメイトに尋ねるようなものです
• プロジェクト横断インテリジェンス：3 つ以上のプロジェクトにまたがって現れるパターンは、自動的にグローバルスコープに昇格します。ベストプラクティスが、手作業なしでどこでも活用できます
• プロアクティブなインサイト：セッションの開始時に、質問する前に知っておくべきことを CogmemAi が伝えます。古くなった重要な記憶、統合が必要な重複項目、昇格の準備ができたパターンなどを知らせます

v3 のその他の機能

• 記憶の健全性スコア：実行可能な要因を示す 0〜100 のスコア
• セッションの再開：セッションの要約が自動生成されるため、中断したところから正確に再開できます
• 自己調整型の記憶：実際の使用状況に応じて重要度が調整され、古くなった記憶は自動的にアーカイブされます
• README の自動取り込み：新しいプロジェクトでは、README からすぐに情報を取り込めます
• スマート想起：話題を切り替えると、関連する記憶が自動的に表示されます
• 自動学習：CogmemAi はセッションから自動的に学習します
• タスク追跡：ステータスと優先度を設定できる永続的なタスク
• 修正内容の学習：同じ間違いを繰り返さないよう、アシスタントに学習させられます
• セッションリマインダー：次のセッションの開始時に表示されるリマインダー
• 必須ルール：「X を絶対に行わない」「Y を必ず行う」といった絶対要件を定義できます。すべてのスコアリングと減衰を回避し、毎回のセッションで表示されます
• 自律的な記憶：AI が保存を行わない場合でも、作業内容を記録します
• 41 種類のツール：あらゆる AI システムに対応した、最も包括的な記憶ツールキット。あらゆる AI が呼び出せるガードおよびレビュー用の呼び出しも含まれます

クイックスタート

オプション 1：リモート（インストール不要）

npm もセットアップも設定ファイルも不要で、直接接続できます。API キーを使って、リモートエンドポイントを MCP クライアントに追加するだけです。

エンドポイント： https://hifriendbot.com/mcp/ 認証： Bearer トークン（お使いの cm_ API キー）

無料の API キーは hifriendbot.com/developer で取得できます。

Streamable HTTP トランスポートに対応したあらゆる MCP クライアント（Claude Desktop、Cursor など）で動作します。

オプション 2：ローカルインストール

npx cogmemai-mcp setup

セットアップウィザードでは、3 つの選択肢を順に案内します。クラウド（推奨、Ai の機能をすべて利用）、ローカル（データをお使いのマシン内に保持）、またはハイブリッド（両方）です。モードを選び、必要に応じて API キーを入力すれば、60 秒以内に準備完了です。

まだ API キーをお持ちでない場合は、hifriendbot.com/developer で無料のキーを取得できます。ローカルモードを含め、どのモードでも無料のキーが必要です。ローカルモードではライセンスキーのように機能し、データがお使いのマシンから外部に送信されることはありません。

問題点

新しいセッションを開始するたびに、コンテキストが失われます。技術スタック、アーキテクチャ上の決定、コーディングの好みを何度も説明し直すことになります。Claude Code のようなツールに組み込まれたメモリは、検索機能も構造も知能もない単なるフラットファイルです。

CogmemAi は、Ai アシスタントに本格的なメモリシステムを提供します。

• セマンティック検索：キーワードではなく意味に基づいて、関連するメモリを見つけます
• Ai による抽出：会話から記憶する価値のある事実を自動的に特定します
• スマートな重複排除：重複したメモリや矛盾するメモリを自動的に検出します
• プライバシー制御：保存前に API キー、トークン、シークレットを自動検出します
• ドキュメント取り込み：README やドキュメントを読み込ませて、プロジェクトのコンテキストをすぐに構築できます
• プロジェクトごとの管理：特定のリポジトリに紐づくメモリに加え、どこでも引き継がれる全体設定にも対応します
• スマートコンテキスト：現在の作業との関連性が最も高くなるよう、インテリジェントに順位付けします
• 自律的なメモリ記録：Ai が保存を呼び出し忘れた場合でも、知識を保存します。決定事項、ファイルの変更、修正内容を、プロンプトなしでメモリに記録します
• コンパクションからの復旧：Claude Code のコンテキストコンパクション後も自動的に対応します
• トークン効率：会話を肥大化させない、コンパクトなコンテキスト読み込みを実現します
• セットアップ不要：データベース、Docker、Python、ベクトルストアは必要ありません

クラウドモードを推奨する理由

CogmemAi には 3 つのストレージモードがありますが、その真価を発揮するのはクラウドです。インテリジェンスエンジン、セマンティック検索、自動リンク機能を備えたナレッジグラフ、矛盾の検出、自己改善型の想起、自動スキル、クエリ合成は、サーバー側で実行されます。クラウドモードでは、MCP サーバーはローカルデータベースも RAM の問題もメンテナンスも一切不要な、シンプルな HTTP クライアントです。すべてのメモリは保存時に暗号化されるため、データはローカルストレージと同等に安全であり、さらにデバイス間の持ち運びやすさとチーム機能も利用できます。

メモリはどこでも引き継がれます。 Claude Code で作成したメモリは、Cursor、Windsurf、Cline など、MCP 互換のあらゆるツールですぐに利用できます。Opus、Sonnet、Haiku、またはエディターが対応する任意のモデルに切り替えても、メモリはそのまま保持されます。新しいノートパソコンや新しい OS を使うことになっても、ログインすればプロジェクトの知識がすべて揃っています。ローカルの SQLite ファイルは、マシンとともに失われます。クラウドメモリは永続的です。

プライバシーに関する主張は迷信です。 一部のメモリツールは、「ローカルファースト」をプライバシー上の利点として宣伝しています。しかし、その先に何が起きるかを考えてみてください。Ai が読み取るメモリはすべて、プロンプトの一部としてモデルプロバイダー（Anthropic、OpenAI、Google）に送信されます。どこに保存されているかにかかわらず、推論時にはデータがマシンの外部に送信されます。ローカルの SQLite ファイルはメモリを保護するのではなく、検索を難しくし、アクセスを遅くし、共有を不可能にするだけです。CogmemAi は保存時に暗号化し、HTTPS 経由で送信するとともに、ローカルストレージでは実現できないインテリジェンスを提供します。

チームと共同作業。 チームメイト間でプロジェクトの知識を共有できるのは、クラウドメモリだけです。ある開発者がアーキテクチャ上の決定を保存したり、バグ修正を記録したりすると、チームメンバー全員の Ai アシスタントがすぐにその情報を把握できます。同期も、マージコンフリクトも、古くなったローカルデータベースもありません。開発者が 2 人でも 20 人でも、全員のアシスタントが同じ最新のコンテキストを持ちます。ローカルのみのメモリソリューションでは、これは実現できません。

コンテキスト圧縮からの復元

AI アシスタントがコンテキストを圧縮すると、会話履歴が短縮され、コンテキストが失われます。CogmemAi はこれを自動的に処理します。圧縮の前にコンテキストを保持し、その後シームレスに復元します。説明し直したり、手動でプロンプトを入力したりする必要はありません。

npx cogmemai-mcp setup コマンドですべてが自動的に設定されます。

スキル

CogmemAi には、メモリ管理のベストプラクティス、保存するタイミング、重要度の評価、メモリの種類、セッションのワークフローを Claude に教える Claude スキルが含まれています。

Claude Code:

/skill install https://github.com/hifriendbot/cogmemai-mcp/tree/main/skill/cogmemai-memory

Claude.ai: Settings > Skills で skill/cogmemai-memory フォルダーをアップロードします。

CLI コマンド

npx cogmemai-mcp setup          # Interactive setup wizard
npx cogmemai-mcp setup <key>    # Setup with API key
npx cogmemai-mcp verify         # Test connection and show usage
npx cogmemai-mcp --version      # Show installed version
npx cogmemai-mcp help           # Show all commands
npx cogmemai-mcp guard status   # Cached rules for this project and verdict counts
npx cogmemai-mcp guard sync     # Refresh remembered rules from CogmemAi
npx cogmemai-mcp guard test "<command>"   # Judge a command without running it
npx cogmemai-mcp guard log [n]  # Show the last n verdicts
npx cogmemai-mcp guard install  # Add the guard hooks to an existing setup
npx cogmemai-mcp guard shell-install   # Guard bash -c / zsh -c from any tool, not just Claude Code
npx cogmemai-mcp guard shell-remove    # Undo shell-install
npx cogmemai-mcp rules list            # Rule packs you can install (v3.30+)
npx cogmemai-mcp rules show devsecops  # Read a pack before installing it
npx cogmemai-mcp rules install devsecops [--global] [--intent] [--dry-run]

ガード

CogmemAi Guard は 2 つの Claude Code フックで構成され、setup（既存のセットアップでは guard install）によってインストールされます。どちらもフェイルオープンで動作します。エラーや解析できない入力があっても、コマンドは変更されずに実行されます。どちらも言語モデルを呼び出しません。

コマンドの実行前（Bash の PreToolUse）に、ガードは組み込みの 6 つのルールと、このプロジェクトが記憶しているルールに照らしてコマンドを判定します。拒否は、何かを起こさせないという意味ではなく、無人で実行することを拒むという意味です。拒否する場合は必ず、意図的に実行する方法を示します。

組み込みルール	理由
パイプラインから crontab 全体を書き換える	スケジュール済みジョブを気付かれずに破壊します
稼働中のデータベースクライアントに DELETE、DROP、TRUNCATE、UPDATE を送信する	対象を限定した DELETE であっても、安全である証明にはなりません
一時ファイル、ビルド、依存関係のパス以外で再帰的に削除する	定義上、復元できません
main、master、prod への強制プッシュ	リモートにしか存在しないコミットを上書きします
ダウンロードしたスクリプトをシェルにパイプする	誰も読んでいないコードを実行します
名前を指定して共有サーバーのワーカーを pkill または killall する	共有ホストで処理中のすべてのリクエストを中断します

ルールを適用する前に、引用符で囲まれた文字列とヒアドキュメントの本文は取り除かれます。そのため、危険なコマンドをメモファイルに書くことと、実行することは同じではありません。ssh host "..."、bash -c "..."、シェルに渡されるヒアドキュメントのペイロードは、直接入力されたものとして判定されます。

メモリに保存されたルール。 ルールメモリ（save_rule、またはタイプが rule のメモリ）はパターンにコンパイルされ、セッション開始時にローカルにキャッシュされるため、事前チェックにネットワークは必要ありません。情報源は 2 つあります。

• GUARD: <regex> という行は、そのまま大文字と小文字を区別せずに使用されます。GUARD: off にすると、そのルールは助言のみになります。
• 同じ文の中で NEVER、DO NOT、または MUST NOT に続くバッククォートで囲まれたコマンドで、コマンドの形式（コマンド名に 1 つ以上の引数が続き、プレースホルダーがないもの）になっているものです。NEVER run \pkill -u www lsphp`` で十分です。

記憶されたルールが適用されると、理由にはそのルールが引用され、ルール名が示されます。対処方法として、コマンドを自分で実行するか、delete_rule でルールを削除するよう案内されます。

ターンの終了後（Stop）、ガードは作業ツリーを確認します。追跡対象のソースに追加された可能性のあるシークレット、リリースファイル間で一致しないバージョン文字列、削除されたファイル、大量の行削除、新たに複数の場所で定義された関数、プロジェクト名や変更されたファイルに言及する記憶済みの注意事項が対象です。問題のないターンでは、何も出力しないのが正しい動作です。

ログ。 何も表示されない許可も含め、すべての判定は ~/.cogmemai/guard-verdicts.jsonl に追記されます（COGMEMAI_GUARD_LOG で変更できます）。ログには判定、ルール、コマンドの秘匿化されたコピー、セッション、作業ディレクトリが記録されます。guard status で概要を確認できます。 Claude Code だけでなく、あらゆるツールに対応します（v3.25.0）。 Cursor、Codex、Gemini CLI、Cline、通常のスクリプトは、いずれも最終的に bash -c "<command>" を実行します。非対話型の bash は、何かを実行する前に BASH_ENV で指定されたファイルを読み込み、BASH_EXECUTION_STRING にはコマンド全体が格納されます。cogmemai-mcp guard shell-install はそのファイルを書き込み、BASH_ENV からそのファイルを参照するように設定します。そのため、このようなシェルはすべて同じエンジン、同じルールキャッシュ、同じログを使ってコマンドを判定し、拒否された場合はステータス 2 で終了し、その理由を標準エラーに出力します。zsh は ZSH_EXECUTION_STRING を通じて対応しています。1 つのプロセスでスキップするには COGMEMAI_GUARD_OFF=1 を設定します。インストールを元に戻すには guard shell-remove を実行します。対象外：sh が dash であるシステムでの sh -c、およびスクリプトファイルの本体（判定されるのは -c の文字列のみです）。

サンドボックスではありません。 git、バックアップ、レビューの代わりでもありません。permissions.allow に Bash を一律に指定すると、「確認」の判定が機能しなくなるため、ガードは確認を求めずに拒否します。

その他すべての AI 向け（v3.28.0）。 コーディングツールが確認を求めるにはフックを使います。それ以外は、1 回の呼び出しで確認できます。guard_check ツール（または POST /cogmemai/guard-check、SDK の guardCheck）に、提案するアクションを平易な言葉、または正確なコマンドやメッセージで渡し、任意で kind（command、action、message、other）と context を指定すると、該当するルールとともに allow、ask、deny のいずれかが返されます。判定は 2 段階です。すべてのプランで、アクション内にそのまま含まれるルール引用箇所を照合するリテラル判定を行い、有料プランではさらに、すべてのルールメモリとプロジェクトの意図における NEVER および MUST の行に対して判定を行います。より厳しい判定が優先され、エラー時はフェイルオープンとなります。つまり、エラーは judged: false が付いた許可として扱われます。メッセージを送信しようとしているサポートアシスタント、支出しようとしているエージェント、移動しようとしているロボットも、すべて一度保存した同じ言葉で判定されます。

ルールパック

ルールパックは、まとめてインストールするように作成されたルールのセットです。最初のパックである devsecops には、クラウドインフラストラクチャで AI エージェントを運用するチーム向けのルールが 40 件あります。対象となるのは、シークレット（コミット、出力、コマンドラインへの記載を禁止し、漏えい時にはローテーションする）、Infrastructure as Code（CI から計画、レビュー、適用し、コンソールでの変更、破棄、ステートの直接操作を禁止する）、最小権限（管理者権限やワイルドカードポリシー、長期間有効なキーを禁止し、エージェントには専用のスコープ付き ID を割り当てる）、意図せず公開されることの防止（バケット、スナップショット、セキュリティグループ）、マージをブロックする CI/CD ゲート、変更管理（レビュー済みプルリクエスト、日付入りバックアップとロールバック、変更凍結期間）、サプライチェーン（パイプ経由のインストーラーを禁止し、バージョンを固定する）、コンテナと Kubernetes（特権モード、cluster-admin、本番環境に対する破壊的な kubectl を禁止する）、データ（暗号化し、ノート PC やエージェントにコピーせず、破壊的な SQL はマイグレーション経由でのみ実行する）、ロギング（集中管理し、変更不可とし、無効化せず、シークレットを含めない）、インシデント対応（早期に宣言し、封じ込めてから証拠を保全し、非難しない事後検証を行い、規制上の報告期限を守る）、そしてエージェント自体に関するルールです。エージェントは作業前に guard_check を実行し、作業後に review_work を実行し、自分の作業を自分で承認またはマージしてはなりません。

シェルの形式があるルールには明示的な GUARD: パターンが付いているため、実行前ガードがモデルを呼び出すことなく適用します。文章のみで適用されるルールには GUARD: off が付いているため、推測は行われません。npx cogmemai-mcp rules install devsecops でインストールし、まず rules show devsecops で内容を確認してください。すべてのプロジェクトに適用するには --global を指定し、プロジェクトに意図が設定されていない場合は --intent を追加して、対応する意図ドキュメント（目的、9 つの不変条件、対象外、完了の定義）もインストールします。このパックは出発点です。インストール後は、ほかのメモリーと同じようにルールを編集、削除、追加できます。

現在、5 つのパックが提供されています。devsecops（40 件）、aws（20 件）、azure（18 件）、gcp（17 件）、migrate（16 件）です。cogmemai-mcp rules list で一覧を確認できます。クラウドの各パックは、各プロバイダー固有の CLI 形式（aws iam create-access-key、az role assignment create --role Owner、gcloud projects add-iam-policy-binding --role roles/owner、すべての接続元に公開されたセキュリティグループ、NSG、ファイアウォールのルール、公開バケット、公開データベース、監査ログの無効化、予算とバックアップの削除）を適用し、migrate パックはワークロードの移行プロセスを適用します。移行先クラウドのパックと migrate を手動でインストールするか、migrate assess に任せてください。

移行

cogmemai-mcp migrate assess --target aws|azure|gcp [--path DIR] [--out FILE] [--model ID] [--force] [--no-rules] [--dry-run] はリポジトリのインベントリを作成し、移行スコープをプロジェクトの意図として書き込み、計画、リスク、コスト要因をメモリーとして保存し、MIGRATION.md を作成して、migrate パックと移行先クラウドのパックをインストールします。cogmemai-mcp migrate gate "<phase>" [--notes "..."] [--since REF] はスコープに照らしてフェーズをレビューし、カバレッジが 80 以上で違反がなければ合格とします。migrate status は記録されている評価、ゲート、リスクを一覧表示します。インベントリで送信されるのは名前と件数のみです（依存関係名、環境変数名、ホスト名、シークレットと思われるファイルのファイル名）。ファイルの内容や値は送信されません。評価とゲートは判定を伴う呼び出しであり、有料プランで実行されます。インベントリとパックはすべてのプランで利用できます。

インテント

CogmemAi インテント（v3.26.0）は、プロジェクトごとに1つの平易な英語のドキュメントです。リポジトリではなく、CogmemAi が保持します。コードを開くことのない読者向けに書かれた、オーナーにとっての信頼できる唯一の情報源です。

作成するには、set_intent ツールを使います（またはアシスタントに下書きを依頼し、内容を承認します）。次の4つのセクションが適しています。

# my-shop

## Purpose
A checkout for a small shop. Customers pay by card and get an email receipt.

## Invariants
- NEVER charge a card before the address is validated.
- NEVER run `pkill -u www lsphp` on the shared host.
- Every email goes through the queue, never sent inline.

## Decisions
- Tax is computed after discounts because the accountant said so.

## Out of scope
- Subscriptions.

すべてのセッションで、必須ルールの直後、切り詰め位置より前に読み込まれるため、アシスタントが常に参照できます。get_intent は全文を返し、cogmemai-mcp guard intent はキャッシュされたコピーを出力します。内容を置き換えるたびに、以前のテキストがバージョンとして保存されます。

不変条件は強制されます。 Invariants、Rules、Must、Never、Always のような見出しの下にある文は、ルールメモリーと同じ方法でコンパイルされます。NEVER または MUST NOT の後にバッククォートで囲まれたコマンドがあると、PreToolUse ガードが拒否するパターンになり、GUARD: <regex> の行も機能します。この処理ではネットワークを使いません。キャッシュはセッション開始時と guard sync によって更新されます。

すべてのターンがチェックされます。 Stop 時に、そのターンの差分（未ステージ、ステージ済み、新規ファイルの先頭部分。フックの予算内で判定できるよう、最大16,000文字）が CogmemAi サーバーに送信され、そこでインテントに照らして判定されます。そのため、フック自体がモデルを呼び出すことはありません。結果は、人が読める数行で返されます。

CogmemAi Guard reviewed this turn:
  - Intent check: Charges the card as soon as the form is submitted.
  - Conflicts with your intent ("NEVER charge a card before the address is validated."): The charge now happens before validation.
  - Not in your intent yet: Stores the card number for later. Say "add that to the intent" to record it, or ask for it to be reverted.

インテントですでにカバーされている変更については、何も表示されません。判定されたすべてのターンで1行の要約を表示するには、COGMEMAI_INTENT_VERBOSE=1 を設定します。レビューによってブロックされたり編集されたりすることはありません。結果を報告し、判断するのはあなたです。

スコアボード（v3.27.0）。 すべてのチェックは、プロジェクト名、差分のサイズ、所要時間、見つかった競合とギャップの数、実際に表示された行とともに、~/.cogmemai/intent-log.jsonl に追記されます。次の3つのコマンドで、機能そのものを評価できます。

cogmemai-mcp guard intent-status            availability, latency, how often it spoke, precision, closed loops
cogmemai-mcp guard intent-log [n]           the last n notes, numbered, with their grades
cogmemai-mcp guard intent-grade [#] right|wrong [why]   grade a note (default: the latest)

適合率（正しい判定数を採点対象数で割った値）が、レビューに価値があるかどうかを決める指標です。目標は10件中9件です。「クローズドループ」とは、ギャップの指摘から1時間以内に同じプロジェクトのインテントが更新されることです。これは、オーナーが「それをインテントに追加して」と伝え、機能が役割を果たしたことを意味します。

差分以外のあらゆる作業にも対応（v3.28.0）。 review_work ツール（または work フィールドを指定した POST /cogmemai/intent-check、SDK の reviewWork）を使うと、説明、出力、メッセージ、または会話全体をインテントに照らしてレビューできます。結果の形式は同じで、summary、covered、uncovered、violations、coverage が含まれます。プロジェクトに保存済みのドキュメントがない場合は、intent をインラインで指定できます。アシスタントが1つの会話を判定したり、ロボットが1つのタスクをチェックしたりする場合に使います。

Git の外でも利用可能（v3.29.0）。 フォルダーがリポジトリではない場合、レビューは git diff の代わりにセッションの編集イベントログを読み取るため、どの cwd からでも機能します。また、それ自体がプロジェクトであるサブフォルダー内の編集は、そのプロジェクトのインテントに照らして判定されます。

ティア。 判定チェックは有料ティアで実行されます。各チェックがモデルへのリクエストだからです。無料ティアでは、不変条件の強制、コンテキストの挿入、すべての決定論的なレビューを利用できます。ローカルのみのストレージモードにはインテントドキュメントがありません。判定にはサーバーが必要なためです。

手動セットアップ

npx cogmemai-mcp setup を使わずに手動で設定する場合：

オプションA、プロジェクトごと（プロジェクトのルートに .mcp.json を追加）：

{
  "mcpServers": {
    "cogmemai": {
      "command": "cogmemai-mcp",
      "env": {
        "COGMEMAI_API_KEY": "cm_your_api_key_here"
      }
    }
  }
}

ローカルモードの場合（登録には無料の API キーが必要です。データはローカルに保存されます）：

{
  "mcpServers": {
    "cogmemai": {
      "command": "cogmemai-mcp",
      "env": {
        "COGMEMAI_MODE": "local",
        "COGMEMAI_API_KEY": "cm_your_api_key_here"
      }
    }
  }
}

オプションB、グローバル（すべてのプロジェクトで利用可能）：

# Cloud (default)
claude mcp add cogmemai cogmemai-mcp -e COGMEMAI_API_KEY=cm_your_api_key_here --scope user

# Local (free API key required, data stays local)
claude mcp add cogmemai cogmemai-mcp -e COGMEMAI_API_KEY=cm_your_api_key_here -e COGMEMAI_MODE=local --scope user

# Hybrid (both)
claude mcp add cogmemai cogmemai-mcp -e COGMEMAI_API_KEY=cm_your_api_key_here -e COGMEMAI_MODE=hybrid --scope user

対応ツール

Claude Code（推奨）

自動セットアップ：

npx cogmemai-mcp setup

Cursor

~/.cursor/mcp.json に追加します：

{
  "mcpServers": {
    "cogmemai": {
      "command": "npx",
      "args": ["-y", "cogmemai-mcp"],
      "env": { "COGMEMAI_API_KEY": "cm_your_api_key_here" }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json に追加します：

{
  "mcpServers": {
    "cogmemai": {
      "command": "npx",
      "args": ["-y", "cogmemai-mcp"],
      "env": { "COGMEMAI_API_KEY": "cm_your_api_key_here" }
    }
  }
}

Cline（VS Code）

VS Code の「Settings」>「Cline」>「MCP Servers」を開き、次を追加します：

{
  "cogmemai": {
    "command": "npx",
    "args": ["-y", "cogmemai-mcp"],
    "env": { "COGMEMAI_API_KEY": "cm_your_api_key_here" }
  }
}

Continue

~/.continue/config.yaml に追加します：

mcpServers:
  - name: cogmemai
    command: npx
    args: ["-y", "cogmemai-mcp"]
    env:
      COGMEMAI_API_KEY: cm_your_api_key_here

CogmemUI

CogmemUI は、CogmemAi のメモリ機能を内蔵した、無料のマルチモデル AI ワークスペースです。Settings > API Keys で CogmemAi API キーを追加すると、すぐにメモリを利用できます。CogmemUI は、Settings > MCP Servers から MCP 互換のツールサーバーへの接続にも対応しています。エンドポイントを追加してツールを自動検出し、チャットで使用できます。

hifriendbot.com/developer で無料の API キーを取得できます。

ツール

CogmemAi は、AI アシスタントが自動的に使用する 41 個のツールを提供します。

ツール	説明
preflight	先回りした想起。 提案を行う前に、以前のコンテキストをすばやく確認します
save_memory	事実を明示的に保存します（アーキテクチャ上の決定、好みなど）
recall_memories	自然言語を使ってメモリを検索します（セマンティック検索）
extract_memories	AI が会話のやり取りから事実を自動的に抽出します
get_project_context	セッション開始時に主要なメモリを読み込みます（スマートランキング、ヘルススコア、セッション再生付き）
list_memories	フィルターを使ってメモリを閲覧します（ページネーション対応、未分類フィルター付き）
update_memory	内容、重要度、スコープ、タイプ、カテゴリ、対象、タグを更新します
delete_memory	メモリを完全に削除します
bulk_delete	一度に最大 100 件のメモリを削除します
bulk_update	一度に最大 50 件のメモリを更新します（内容、タイプ、カテゴリ、タグなど）
get_usage	使用状況の統計とプラン情報を確認します
export_memories	バックアップや移行用に、すべてのメモリを JSON 形式でエクスポートします
import_memories	JSON 配列からメモリを一括インポートします
ingest_document	ドキュメント（README、API ドキュメント）を取り込み、メモリを自動抽出します
save_session_summary	このセッションで達成した内容の要約を保存します
list_tags	メモリ全体で使用されているタグをすべて表示します
link_memories	名前付きの関係を使って、関連するメモリを結び付けます
get_memory_links	メモリを取り巻くナレッジグラフを調べます
get_memory_versions	メモリの編集履歴を表示します
get_analytics	自己調整型の分析情報を備えたメモリの健全性ダッシュボードです（プロジェクトで絞り込み可能）
promote_memory	プロジェクトのメモリをグローバルスコープに昇格させます
consolidate_memories	AI を使って、関連するメモリを包括的な要約に統合します
save_task	ステータスと優先度を追跡できる、永続的なタスクを作成します
get_tasks	現在のプロジェクトのタスクを取得し、中断したところから再開します
update_task	作業中にタスクのステータス、優先度、説明を変更します
save_correction	同じ間違いを繰り返さないよう、「誤った方法 → 正しい方法」のパターンを保存します
set_reminder	次のセッション開始時に表示されるリマインダーを設定します
get_stale_memories	確認または整理が必要な、古くなっている可能性のあるメモリを見つけます
get_file_changes	前回のセッション以降に変更されたファイルを確認します
feedback_memory	想起したメモリが役立ったか、無関係だったかを通知し、今後の想起を改善します
generate_skills	修正内容や好みからスキルの生成を開始するか、ドライランで候補をプレビューします
save_rule	すべてのセッションで表示され、すべてのスコアリングと減衰を回避する必須ルールを保存します
list_rules	現在のプロジェクトおよび／またはグローバルの必須ルールをすべて一覧表示します
delete_rule	ID を指定して必須ルールを削除します
get_intent	プロジェクトの Intent ドキュメント（オーナーが記述した、信頼できる情報源）を読み込みます
set_intent	プロジェクトの Intent ドキュメントを作成または置き換えます（バージョン管理され、ガードによって不変条件が適用されます）
guard_check	行動する前に確認します。記憶されたルールと Intent に照らし、提案された操作を許可、確認、または拒否します
review_work	完了した作業（説明、出力、メッセージ、文字起こし）を Intent に照らしてレビューします
extract_principles	Wisdom Engine を起動して、メモリのクラスター全体から事実のパターンを検出します

SDK

CogmemAi API を使って独自のインテグレーションを構築できます。

• JavaScript/TypeScript： npm install cogmemai-sdk、npm · GitHub
• Python： pip install cogmemai、PyPI · GitHub

メモリの種類

メモリは、整理と検索をより効果的に行えるよう分類されています。

• identity：自分が誰か、役割、チーム
• preference：コーディングスタイル、ツールの選択、規約
• architecture：システム設計、技術スタック、ファイル構成
• decision：Y ではなく X を選んだ理由
• bug：既知の問題、修正方法、回避策
• dependency：バージョン制約、パッケージに関するメモ
• pattern：再利用可能なパターン、規約
• context：プロジェクト全般のコンテキスト
• task：ステータスと優先度を追跡できる永続的なタスク
• correction：誤ったアプローチ → 正しいアプローチのパターン
• reminder：次回のセッション向けの通知。自動的に期限切れになります
• rule：すべてのセッションで提示され、すべてのスコアリングと減衰を回避する必須の指示

スコープ

• プロジェクトメモリ：特定のリポジトリに関するアーキテクチャ、決定、バグ。リポジトリから自動検出されます。
• グローバルメモリ：コーディングの好み、アイデンティティ、ツールの選択。すべてのプロジェクトで利用できます。

料金

	Free	Personal	Pro	Team（1席あたり）	Enterprise
料金	$0	$3.99/mo	$9.99/mo	$49.99/mo	$99.99/mo
メモリ	500	1,000	2,000	10,000	50,000
抽出回数/月	500	500	2,000	5,000	20,000
保存回数/月	1,000	2,000	5,000	20,000	100,000
プロジェクト	5	10	20	50	200
判定付き guard_check と review_work		はい	はい	はい	はい

現在のプランと上限については、hifriendbot.com/pricingをご覧ください。シェルガード、ルールパック、移行インベントリは、無料プランを含むすべてのティアで利用できます。まずは無料で始めましょう。必要に応じてアップグレードできます。または、クレジットカード不要で、オンチェーンの USDC による操作ごとの支払いも可能です。

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

• 🛡️ 保存データを量子耐性暗号化で保護。 クラウドモードとローカルモードの両方で、すべてのメモリを量子耐性暗号で暗号化します。現在の脅威と将来の量子コンピューターの両方から保護します。
• ソースコードがマシンの外に出ることはありません。 抽出された事実（短い文）のみを保存し、生のコードは保存しません。
• API キーはサーバー側で暗号学的にハッシュ化（不可逆）されます。
• すべての通信に HTTPS を使用します。
• お客様のデータでモデルをトレーニングすることは一切ありません。
• ダッシュボードまたは MCP ツールから、すべてのデータを即座に削除できます。
• ユーザー間でデータを共有することはありません。

プライバシーポリシー全文をお読みください。

環境変数

変数	必須	説明
COGMEMAI_API_KEY	はい	API キー（cm_ で始まります）。すべてのモードで必須です。ローカルモードではライセンスキーとして機能し、データはマシン上に保持されます。
COGMEMAI_MODE	いいえ	ストレージモード：cloud（デフォルト）、local（データはマシン上に保持）、または hybrid
COGMEMAI_LOCAL_DB	いいえ	ローカルデータベースのパス（デフォルト：~/.cogmemai/local.db）。ローカルモードとハイブリッドモードで使用します。
COGMEMAI_API_URL	いいえ	カスタム API URL（デフォルト：hifriendbot.com）
COGMEMAI_ENCRYPTION_KEY	いいえ	ローカルモード用のカスタム暗号化パスフレーズ。設定されていない場合は、キーが自動生成されます。
COGMEMAI_LOCAL_ENCRYPTION	いいえ	ローカル暗号化を無効にするには off を設定します（推奨されません）。

サポート

• 問題の報告：GitHub Issues
• ドキュメント：hifriendbot.com/developer

ライセンス

MIT、LICENSEを参照

---

HiFriendbotが開発。より良い友人、より良い思い出、より良い AI。🛡️ 量子耐性。