StateJar memory

StateJar の連携

AI コーディングエージェントやアシスタントを、会話記録ではなく事実を保存するメモリレイヤーである StateJar に接続するクライアントコードです。

• フィールドごとに値は 1 つで、型に基づいて検証されます。検証に失敗した値は、理由とともに拒否されます。
• 追記専用のバージョン管理：変更のたびに新しいバージョンが作成され、古い値は履歴に残ります。
• 最小限の開示による想起：アシスタントには、質問に必要な情報だけが渡されます。
• 開示のすべてを記録する監査証跡
• 各状態にハンドル（shm_…、正規化された状態の SHA-256）が割り当てられるため、メモリのコピーを検証できます。

対応環境	場所	ステータス
ホスト型 MCP サーバー（HTTP 経由で MCP に対応するすべてのクライアント）	https://statejar.com/mcp	StateJar の次期リリースで利用可能
Claude Code プラグイン	plugins/statejar/、ガイドは claude-code/	マーケットプレイス：このリポジトリ
Codex プラグイン（同じプラグイン）	plugins/statejar/、ガイドは codex/	マーケットプレイス：このリポジトリ
OpenCode プラグイン	opencode/	npm：opencode-statejar
Hermes Agent メモリプロバイダー（memory.provider: statejar）	hermes/statejar/	このリポジトリから hermes plugins install
OpenClaw メモリスロットプラグイン	openclaw/	npm：openclaw-statejar
エージェントスキル（SKILL.md を読み込むすべてのエージェント）	skills/statejar/	エージェントのスキルフォルダーにコピー
CLI：statejar login、および init, add, search, list, forget, export, status	PyPI：statejar	pip install statejar（0.6.0 では login、logout、whoami が利用可能です。残りの 7 つは 0.7.0 で追加されます）

すべての連携で、アカウントに紐づく StateJar 開発者キー（https://statejar.com/api-keys）を使用します。いずれも会話記録は保存しません。送信前にすべての秘密情報を取り除きます。

利用状況。 想起と記録は、稼働中の StateJar REST API https://api.statejar.com を呼び出します。プラグインの StateJar ツールが使用するホスト型 MCP サーバー https://statejar.com/mcp は、StateJar の次期リリースで稼働します。それまではこれらのツールは接続できませんが、想起と記録は通常どおり機能します。

任意の MCP クライアント

https://statejar.com/api-keys で開発者キーを作成し、STATEJAR_API_KEY に設定します。次に：

# Claude Code
claude mcp add --transport http statejar https://statejar.com/mcp --header "Authorization: Bearer $STATEJAR_API_KEY"
# Codex
codex mcp add statejar --url https://statejar.com/mcp --bearer-token-env-var STATEJAR_API_KEY

OpenCode の場合は、opencode.json に記述します：

{
  "mcp": {
    "statejar": {
      "type": "remote",
      "url": "https://statejar.com/mcp",
      "oauth": false,
      "headers": { "Authorization": "Bearer {env:STATEJAR_API_KEY}" }
    }
  }
}

その他のクライアントの場合：ヘッダー Authorization: Bearer <your key> を使って、https://statejar.com/mcp のリモート（HTTP）MCP サーバーに接続します。利用できる 10 個のツールは、remember、search、get、list、update、delete、history、audit、verify、export です。

Claude Code

claude plugin marketplace add KING-OF-FLAME/statejar-integrations
claude plugin install statejar@statejar

claude-code/README.md を参照してください。

Codex

codex plugin marketplace add KING-OF-FLAME/statejar-integrations
codex plugin add statejar@statejar

次に、/hooks でプラグインのフックを信頼してください。codex/README.md を参照してください。

OpenCode

"plugin": ["opencode-statejar"] と StateJar の MCP サーバーを opencode.json に追加します。opencode/README.md を参照してください。

Hermes Agent

hermes plugins install KING-OF-FLAME/statejar-integrations/hermes/statejar --enable
hermes memory setup          # choose statejar

hermes/statejar/README.md を参照してください。

OpenClaw

openclaw plugins install openclaw-statejar
openclaw statejar init       # the memory slot, autoRecall, autoCapture

openclaw/README.md を参照してください。

エージェントスキル

skills/statejar/ をエージェントのスキルフォルダーにコピーします（Claude Code の場合は ~/.claude/skills/）。skills/README.md を参照してください。

Mem0 との比較：StateJar の測定結果

StateJar のメモリ QA セット（会話 100 件、質問 300 件）で、両システムに同じ小規模なローカルモデル（Qwen3-4B-Instruct-2507 Q4、GPU 1 基）を使用したところ、StateJar のメモリは 300 件中 248 件の質問の答えを保持していました。一方、Mem0 のメモリ（出荷時の 2.2.1）は 152 件でした（McNemar p = 1.4e-18）。各システムのメモリから、それぞれ 1 つのプロンプトで生成した回答が正しかったのは、StateJar が 300 件中 218 件、Mem0 が 159 件でした。これは、この条件でのみ実施した 1 つのベンチマークです。手法と注意事項については、https://statejar.com/docs/mem0.html を参照してください。

テスト

python -m pytest tests/
claude plugin validate ./plugins/statejar && claude plugin validate .

ローカルまたはステージング環境の StateJar を対象としたエンドツーエンドテストです（本番環境では絶対に実行しないでください）。実際のクライアントのあるセッションで述べた事実が、新しいセッションで、フック経由と StateJar の MCP ツール経由の両方で呼び出されます。実行のたびに使い捨てアカウントを作成し、削除します。マシン上にモデルがない場合は、スクリプト化された代役（e2e/scripted_model.py）が「OK」と応答するか、StateJar の search を呼び出して、その出力をそのまま繰り返します。codex_e2e.py --model ollama:<name> は実際のローカルモデルを使用します。

python e2e/codex_e2e.py --api http://127.0.0.1:8000/api/v1 --mcp http://127.0.0.1:8000/mcp --out /tmp/codex-e2e
python e2e/claude_code_e2e.py --api http://127.0.0.1:8000/api/v1 --mcp http://127.0.0.1:8000/mcp --out /tmp/cc-e2e
python e2e/opencode_e2e.py --api http://127.0.0.1:8000/api/v1 --mcp http://127.0.0.1:8000/mcp --out /tmp/oc-e2e
python e2e/hermes_e2e.py --api http://127.0.0.1:8000/api/v1 --out /tmp/hermes-e2e
python e2e/openclaw_e2e.py --api http://127.0.0.1:8000/api/v1 --out /tmp/openclaw-e2e     # Node 24.16+
python e2e/openclaw_discovery.py       # what OpenClaw itself loads from the plugin; no model, no StateJar
HERMES_PYTHON=/path/to/hermes/venv/bin/python python -m pytest tests/test_hermes_provider.py   # with Hermes's own loader
python e2e/codex_discovery.py          # what Codex itself loads from the plugin; no model, no StateJar

ライセンス

MIT（LICENSE を参照）。これらのクライアントが接続する StateJar サービスには独自の利用規約があります：https://statejar.com/terms.