cogmem

cogmem

自己改善し、検証可能な、AI コーディングエージェント向けメモリレイヤーです。

自己改善し、検証可能な、AI コーディングエージェント向けメモリレイヤーです。

cogmem はセッションをまたいで作業方法を学習し、エージェントの精度と自律性を時間とともに高めます。間違いの繰り返しを止め、各プロジェクトの最新モデルを維持し、適切なタイミングで適切な教訓を提示します。すべてのメモリは暗号学的に署名され、改ざんが検知可能なため、エージェントを誘導する前に、汚染または改変されたメモリを検出して拒否できます。

WritersLogic が開発 — ローカル優先の想起機能を備え、メモリと本人確認キーはお使いのマシン上に保持されます（プライバシーを参照）。

インストール

PyPI から

pip install cogmem            # CLI + MCP server + verifiable-memory tools
pip install 'cogmem[recall]'  # add local semantic recall (fastembed)
cogmem init                   # wire the Claude Code hooks + build the index

pip install cogmem を実行すると、cogmem CLI と MCP サーバー（cogmem mcp、または必要に応じて uvx cogmem mcp）が利用できます。検証可能なメモリツールにはコアのインストールだけで十分です。ローカルのセマンティック想起機能を使うには [recall] エクストラを追加し、次に cogmem init を実行して、学習ループ全体（SessionStart／UserPromptSubmit／Stop フックとインデックス）を Claude Code に組み込みます。cogmem init はべき等なので、いつでも再実行できます。

クローンインストーラー（ウォームデーモン付きの一括セットアップ）

クローンインストーラーは pip install と cogmem init で行うすべてのセットアップに加え、ウォーム想起デーモン（launchd／systemd）を管理対象サービスとして設定します。

git clone https://github.com/writerslogic/cogmem.git
cd cogmem
./install.sh

または、1 行で実行します。

curl -fsSL https://raw.githubusercontent.com/writerslogic/cogmem/main/install.sh | bash

install.sh はべき等なので、いつでも再実行してその場でアップグレードできます。コードを ~/.claude/cogmem に配置し、依存関係を含む自己完結型の仮想環境、 PATH 上の cogmem CLI、Claude Code フック、およびウォーム想起デーモン （macOS では launchd エージェント、Linux では systemd --user サービス）をセットアップします。Python 3.12 以降が必要です。セマンティック想起はローカルモデル（fastembed、外部 API 不要）で動作します。これらの手順を省略するには --no-daemon または --no-hooks を指定します。別の場所にインストールするには COGMEM_HOME を設定してください。CLI、エンジン、フックはすべて実行時にこの値を解決するため、 既定以外の場所にインストールした場合も、メモリと本人確認情報は完全に自己完結した状態に保たれます。

カスタムインストール

別のディレクトリにインストールする

COGMEM_HOME を設定すると、既定の ~/.claude/cogmem 以外の場所に cogmem を 配置できます。

COGMEM_HOME=/opt/cogmem ./install.sh

または、1 行のコマンドを使います。

curl -fsSL https://raw.githubusercontent.com/writerslogic/cogmem/main/install.sh | COGMEM_HOME=/opt/cogmem bash

インストーラーはコードをコピーし、仮想環境を作成して、CLI を ~/.local/bin/cogmem（または COGMEM_BIN が指定する場所）にシンボリックリンクします。

CLI のパス

cogmem CLI のシンボリックリンクを配置する場所を指定するには、COGMEM_BIN を設定します。

COGMEM_BIN=$HOME/.cargo/bin COGMEM_HOME=/opt/cogmem ./install.sh

COGMEM_BIN が PATH に含まれていない場合、インストーラーは警告を表示します。$COGMEM_HOME/cogmem から cogmem を直接実行することもできます。

データディレクトリと ID キーの解決方法

実行時に、CLI とエンジンは環境変数から COGMEM_HOME を読み取ります。設定されていない場合は、~/.claude/cogmem を使用します。すべての実行時データは vault/ サブディレクトリに保存されます。

ID キーは初回実行時（cogmem status または任意のエンジン操作時）に生成され、$COGMEM_HOME/vault/identity/agent.key に保存されます。対応する did:key は Ed25519 公開鍵から導出されます。cogmem を新しい COGMEM_HOME に移動または再インストールすると、vault/ ディレクトリを移行しない限り、新しい ID が作成されます。

デフォルト以外のインストール先での MCP クライアント

標準の MCP クライアント設定は、cogmem CLI が実行時に環境変数を解決するため、COGMEM_HOME の値にかかわらず使用できます。

{
  "mcpServers": {
    "cogmem": { "command": "cogmem", "args": ["mcp"] }
  }
}

CLI が PATH に含まれていない場合は、フルパスを使用します。

{
  "mcpServers": {
    "cogmem": { "command": "/opt/cogmem/cogmem", "args": ["mcp"] }
  }
}

または、シェルラッパーで COGMEM_HOME をプレフィックスとして指定します。

{
  "mcpServers": {
    "cogmem": { "command": "env", "args": ["COGMEM_HOME=/opt/cogmem", "cogmem", "mcp"] }
  }
}

クイックスタート

cogmem status           # health check, metrics, agent DID
cogmem doctor           # end-to-end learning-loop health (daemon, API key, trust, backlog)
cogmem recall "..."     # surface relevant past lessons for a task
cogmem note "..."       # record a decision or finding mid-task
cogmem verify           # verify every memory's credential + the transparency log
cogmem receipt <id>     # inclusion proof that a memory is committed in the signed log
cogmem statement <id>   # COSE_Sign1 SCITT signed statement (verifiable by HMS too)
cogmem trust            # show the trusted agent identity (warns on a key mismatch)
cogmem trust --rotate   # re-anchor trust after an intentional key change
cogmem review list      # approve always-load rules
cogmem mcp              # run the MCP server (stdio) for any MCP client

MCP 統合

cogmem を MCP サーバーとして実行し、MCP 互換クライアントを接続します。

{
  "mcpServers": {
    "cogmem": { "command": "cogmem", "args": ["mcp"] }
  }
}

8 つのツール（recall、note、status、verify、receipt、tree_head、progress、review_pending）に加え、読み取り専用のリソース（ライブユーザーモデルとプロジェクトごとの状態）が公開されます。

Claude Code 統合

install.sh は cogmem を Claude Code に自動的に組み込みます（~/.claude/settings.json に冪等にマージされます）。手動での呼び出しは不要です。5 つのフックがメモリのループをバックグラウンドで実行します。

すべてのフックは厳密にフェイルオープンです。エラー、タイムアウト、またはデーモンの未起動時には何も挿入せず、プロンプトをブロックすることもありません。スクリプトは ~/.claude/cogmem/hooks/ にあります。設定を更新するには、install.sh（または ./install.sh --no-daemon）を再実行してください。

cogmem verify              # check all memories and the log head
cogmem receipt <memory-id> # prove a memory is in the signed log
cogmem revoke <memory-id>  # revoke a memory (Bitstring Status List)
cogmem status-list         # emit the signed revocation status-list credential

# examples/c2pa-agent-credential/ is a real signed C2PA manifest
# whose agent identity validates in c2patool
./examples/c2pa-agent-credential/verify.sh

cogmem は公開されている標準に基づいて構築されており、完全に準拠する部分と、形状や暗号方式には互換性があるものの、プロファイルへの完全準拠には至らない「スタイル」の部分を明確に区別しています。実際の Ed25519 署名を実際の正規化されたバイト構造に対して行っており、模擬的な要素は一切ありません。

SCITT への完全準拠に向けて。 新たな暗号技術を導入せずに、範囲を限定した 3 つの手順で対応します。（1）ステートメントのペイロードから iss／sub／コンテンツタイプを COSE 保護ヘッダーの CWT_Claims に移します。（2）包含証明を、ステートメントの非保護ヘッダー内に COSE Receipts（draft-ietf-cose-merkle-tree-proofs）として出力します。（3）外部の証人を、発行エージェントとは別個の必須 Transparency-Service ロールにします。手順 1～2 は再エンコードです。手順 3 がアーキテクチャ上の変更です。単一主体のログは互換性のある形式ではありますが、意味のある透明性を実現するものではないためです。

プライバシー

cogmem は設計上、ローカル優先です。メモリー、埋め込み表現、ID キーはお使いのマシンに保存され、意味検索は完全にローカルで行われます。埋め込みモデルと再ランキングモデル（fastembed）はデバイス上で動作するため、メモリーを検索してもデータがマシンの外部に送信されることはありません。

学習パイプラインはローカルではありません。取得、統合、フィードバック判定、およびプロジェクト／ユーザーモデルの合成では、該当するセッションのトランスクリプトが Anthropic API（ANTHROPIC_API_KEY）に送信されます。これにより、ルールの抽出とスコアリングを行います。完全なオフライン動作が必要な場合は、ローカルモデルによる抽出経路が追加されるまで --no-hooks を指定して実行してください（検索は引き続き利用できます）。つまり、検索はローカルで行い、学習では API を呼び出します。

エージェント来歴スタックの一部

cogmem は、WritersLogic の検証可能なエージェント来歴パイプラインを構成するコンポーネントの 1 つです。このパイプラインでは、エージェントの ID、メモリ、推論、署名付き出力がエンドツーエンドで暗号学的に結び付けられています。

4 つすべてが、1 つの基盤である COSE_Sign1／SCITT 署名付きステートメント（Ed25519）と W3C DID ID を共有しています。詳細は UNIFIED-PROVENANCE.md に記載されています。

セキュリティ

脆弱性を発見した場合は、非公開で報告してください。SECURITY.md をご覧ください。

ライセンス

Apache-2.0 — LICENSE をご覧ください。