Assertion Memory

Assertion — コードベースのための第二の脳

Claude Code、OpenAI Codex、Cursorに、プロジェクト全体での戦略と、あなたの判断の理由を記憶するメモリを提供します。常に最新の状態を保ち、覆した判断を再び持ち出すのではなく、その内容を置き換えます。作業中にそのコンテキストを自動的に呼び出し、プロジェクトごとに共有されるツリーに保存します。読み取りはホスト型 MCP エンドポイント経由で実行されます（ローカルサーバーは不要です）。キャプチャとコンテキスト注入は小さなフックが処理します。3つのエージェントすべてで同じコードベースを使用します（ロジックのコピーは1つです）。提供元：Assertion AI。

メモリに保存されるのは判断とその理由であり、会話の記録やソースコードではありません。 メモリに保存される内容 →

インストールしてから、ブラウザーで一度サインインしてください。コピーするキーはありません。システムの python3 が必要です（標準ライブラリのフック用）。ほかに依存関係はありません。

各ツールのトラブルシューティング付きステップバイステップガイド：assertion-ai.com/install。

インストール — Claude Code

ステップバイステップガイド：assertion-ai.com/install/claude-code。

すでにインストール済みですか？ 現在のコピーをそのまま使ってください。このリポジトリからインストールした場合（assertion@assertion-ai）、Claude Code のコミュニティカタログからも（assertion@claude-community）インストールしないでください。2つインストールするとフックも2セットになり、毎回のターンが二重にキャプチャされます。/assertion:upgrade を実行すると、現在使っているコピーが更新されます。

# 1) in Claude Code:
/plugin marketplace add Assertion-AI/assertion
/plugin install assertion@assertion-ai
/reload-plugins

/reload-plugins を実行すると、再起動せずに現在のセッションでプラグインが有効になります。あるいは、Claude Code の起動前にターミナルからインストールすれば、この操作は不要です： claude plugin marketplace add Assertion-AI/assertion && claude plugin install assertion@assertion-ai

2) サインイン：

/assertion:login

ブラウザーで Assertion Studio が開きます。Connectをクリックしてください（初めての場合は、まずそのページで登録してください）。 同じセッション内でメモリが有効になります。メモリツールとキャプチャの両方にサインイン状態が反映され、再起動もキーのコピーも不要です。続いて recall <topic> を試してください。サインインするまでは、各セッションの開始時にメモリがオフであることを示す1行の通知が表示されます。

ブラウザーのないマシン（SSH、サーバーなど）では、/assertion:login code を実行すると短いコードが表示されるので、別のデバイスから確認してください。/assertion:logout を実行すると、このコンピューターからサインアウトし、メモリがオフになります。

要件： システムの python3 が必要です（標準ライブラリのフック2つ用）。ほかに依存関係はありません。メモリツールは HTTP 経由で接続します。

代わりにキーを使う場合（CI、または共有マシン）：ASSERTION_API_KEY も引き続き使用でき、サインインより優先されます。シェルで export するのではなく、~/.claude/settings.json に {"env": {"ASSERTION_API_KEY": "<key>"}} として設定してください。これにより、Claude Code の起動方法にかかわらずプラグインにキーが渡されます。

アップグレード： /assertion:upgrade を実行してから、/reload-plugins を実行してください。再起動は不要です。

スペース： /assertion:space を実行すると、メモリスペースの一覧と、このセッションで使用中のスペースが表示されます。/assertion:space <name> を実行すると、このセッションのみ切り替わります（元に戻すには /assertion:space personal を実行してください）。

インストール — OpenAI Codex

ステップバイステップガイド：assertion-ai.com/install/codex。

# 1) install the plugin
codex plugin marketplace add Assertion-AI/assertion
codex plugin add assertion@assertion-ai

# 2) sign in in your browser (no key to copy)
python3 "$(ls -d ~/.codex/plugins/cache/*/assertion/*/scripts | sort -V | tail -1)/assertion.py" login --client codex

または、Codex を開いてから「sign in to Assertion」と指示してください（プラグインの assertion-login スキルが同じサインイン処理を実行します。「sign out of Assertion」と指示すると assertion-logout が実行されます）。どちらの方法でも、キーはフック用に保存され、メモリツール用として ~/.codex/config.toml に書き込まれます。

3. Codex を対話形式で使用します（ターミナルで codex を実行するか、VS Code の Codex パネルを使います。codex exec は使用しないでください）。初回実行時、プロンプトが表示されたら3つのフックすべてで Trust をオンにします（初回のみ）。

これで、CLI と VS Code の両方で、キャプチャと注入が同じ共有ツリーを対象に動作します。Codex の詳細（recall/expand の設定、開発者向けオーバーライド）：plugin/codex/README.md。

インストール — Cursor

手順ガイド：assertion-ai.com/install/cursor。

Cursor にはプラグインマーケットプレイスがないため、1 回限りのスクリプトでインストールし、hooks.json と mcp.json を自動設定します。

git clone https://github.com/Assertion-AI/assertion
cd assertion/plugin/cursor && python3 install_cursor.py   # signs you in in the browser

その後、Cursor を完全に終了してから再起動してください。インストーラーは既存の Cursor 設定にマージし（他のフックや MCP サーバーには手を加えません）、変更する設定をバックアップし、デフォルトで本番環境と共有の default ワークスペースを使用します。Cursor では、/assertion-login で再度サインインし、/assertion-space でメモリスペースを一覧表示または切り替え、/upgrade でクローンを更新できます。オプション（--key、--workspace、--server、--uninstall）と手動での代替手順については、plugin/cursor/README.md を参照してください。

含まれる機能

• MCP ツール — https://memory.assertion-ai.com を通じて、エージェント内からメモリを検索、整理できます。
  • recall — 現在の作業に関連する過去の作業を検索します
  • expand — 項目を開き、その詳細を確認します
  • evidence — 主張を裏付ける詳細を確認します
  • conflicts — 記録内で食い違っている箇所を明らかにします
  • resolve — 矛盾を解決し、メモリの一貫性を保ちます
  • superseded — 判断の変更によって置き換えられた内容を確認します
  • unsupersede — 置き換えられた内容を復元します
• Stop フック — 完了したターンをそれぞれツリーに取り込みます。
• SessionStart フック — プロジェクトの作業セットをコンテキストに挿入します。

どちらのフックもフェイルオープンです。バックエンドに接続できない場合でも、セッションがブロックされることはありません。

オプション：Claude Code のステータス行にメモリスペースを表示する

ターミナルの下部に常時表示される 📁 <space> インジケーターです。即座に表示され、ローカルで、セッションごとの状態が正確に反映されます。~/.claude/settings.json に設定します。

"statusLine": {
  "type": "command",
  "command": "python3 ~/.claude/plugins/cache/assertion-ai/assertion/scripts/statusline_space.py"
}

（すでにステータスラインコマンドを使用している場合は、その後にこの設定をつなげてください。）

ライセンス

このリポジトリ内のプラグインは、Apache License 2.0 の下でライセンスされています。NOTICE を参照してください。

このライセンスの対象は、このクライアントコードのみです。接続先のホスト型 Assertion サービスには利用規約が適用され、データにはプライバシーに関するお知らせが適用されます。「Assertion」は Assertion AI, Inc. の商標です。