CALM

CALM（Concurrent, autonomous, loosely-coupled minds）は、Claude Codeのセッション間で、議論の文脈・決定事項・作業状況を永続化するプラグインです。

何が解決されるのか

Claude Codeはセッションごとに記憶がリセットされます。短いタスクなら問題ありませんが、長期プロジェクトでは「前に何を決めたか」「なぜその設計にしたか」「どこまで作業が進んでいるか」がセッションをまたぐと失われます。

CALMは、こうした文脈をSQLiteデータベースに保存し、新しいセッションでAIが自動的に過去の記録を参照できるようにします。同じ説明を繰り返す必要がなくなり、議論の積み重ねがそのまま次のセッションに引き継がれます。

主な機能

• トピック管理 — 議論の主題ごとに情報を整理します
• 決定事項の記録 — 合意した内容を理由とともに保存します
• 議論ログ — 議論の経緯や検討過程を保存します
• アクティビティ管理 — 作業タスクの進捗をステータスで追跡します
• 資材管理 — セッション中に生成された分析結果・ドラフト等をタグ付き独立エンティティとして永続化します
• リレーション — トピック・アクティビティ間の関連をグラフ構造で管理します
• タグシステム — トピック・決定・ログ・アクティビティを横断的にタグで分類します。タグにnotesを付けて作業開始時にAIへ自動注入できます
• 振る舞い（habits） — check-in時にAIへ毎回注入される運用ルールを管理します
• ハイブリッド検索 — キーワード検索（FTS5）とベクトル検索を組み合わせて関連情報を見つけます

インストール

前提条件

• uv がインストールされていること
• Claude Code v2.0.12以上
• Python 3.12+（SQLite拡張ロード対応ビルドが必要）
  • pyenvのデフォルトビルドは --enable-loadable-sqlite-extensions が無効のため非対応
  • Homebrew Python (brew install python@3.12) を推奨

インストール手順

# マーケットプレイスを追加
claude plugin marketplace add isizono/calm

# プラグインをインストール
claude plugin install calm

インストール後、Claude Code内で以下を実行すると使い方の案内が表示されます。

/man

MCPツール

カテゴリ	ツール	説明
トピック	add_topic, get_topics	議論トピックの作成・新しい順の取得
議論ログ	add_logs, get_logs	議論の経緯や検討過程の一括記録・取得
決定事項	add_decisions, get_decisions, pull_precedents	合意内容の記録・取得、設計判断前の近傍トピック判例の網羅確認
アクティビティ	add_activity, get_activities, update_activity	作業タスクの作成・取得・状態更新
check-in	check_in	アクティビティにcheck-inし、tag notes・資材・関連decisionsを集約取得
資材	add_material, update_material, get_material, export_material	セッション中の成果物をタグ付き独立エンティティとして保存・更新・取得・md出力
リレーション	add_relation, remove_relation, get_map	エンティティ間の関連の追加・削除・グラフ探索
前提の揺らぎ管理	resolve_destabilization, suggest_destabilized_candidates	軸変更によりdestabilizeされたdecisionの解消・候補提示
振る舞い	add_habit, get_habits, update_habit	check-in時に注入される運用ルールの登録・取得・更新
タグ	search_tags, update_tag, analyze_tags	タグの検索、notes・エイリアス・退役状態等の更新、タグ共起分析
ピン	add_pin, remove_pin	エンティティ間のpin（強調的な関連付け）の追加・削除
取り消し	retract	決定事項・ログ・資材の論理削除
検索・横断参照	search, get_by_ids, get_timeline	キーワード横断検索、詳細情報の一括取得、時系列表示
シグナル・計測	report_signal, get_signals, update_signal, detect_reask_candidates	cc-memory自身への故障報告・矛盾検出・聞き返し候補検出等の運用計測
Ask（人間への判断委譲）	add_ask, get_asks, answer_ask, triage_ask, withdraw_ask	離席中・セッション跨ぎの判断待ち問いの起票・取得・回答・振り分け・取り下げ
Relay（セッション間メッセージング）	relay_post, relay_publish, relay_subscribe, relay_receive, relay_status	セッション間でのメッセージ投函・labels配布・購読・受信・配送状況確認
その他	get_config, roll_dice	設定値の取得、ダイスロール

スキル

スキル	説明
/man	CALMの使い方をAIが説明します
/activity-start	新しいアクティビティを開始します
/activity-pause	進行中のアクティビティを完了にせず中断します
/activity-finish	アクティビティを完了にします
/check-in	アクティビティにcheck-inして関連情報を集約取得します
/decision-record	ユーザーとの合意事項をdecisionとして記録するようガイドします
/recording	議論の経緯や成果物をログ・資材として記録するようガイドします
/remember	「覚えて」等の依頼を受けて、情報の保存先を判定します
/forget	現状と矛盾・陳腐化した過去の記録を撤回します
/tag-notes	タグのnotesを確認・更新します
/tag-cleanup	タグの共起分析を実行し、整理提案をユーザーに提示します
/sync-memory	セッション終了前にtranscriptを解析し、トピック・決定事項・ログ・アクティビティを一括で記録・更新します
/digest	直近の記録を期間横断で俯瞰するダイジェストを生成します
/postmortem	completedアクティビティを振り返り、教訓を永続化します
/audit	過去の決定事項の矛盾・陳腐化を検証し、知識を正しい場所に記録し直します
/recompose-context	アクティビティ・トピック等の関連情報を統合整理し、anchor対応表を作ります
/setup-anchor	合意事項の検証先（anchor）を対話的に確定・更新します
/scribe	CALMの記録からドキュメントを生成します
/db-recovery	DBデータの異常減少を検知した際に、スナップショットから復旧します
/restart	CALMのローカルMCPサーバー・embeddingサーバーを再起動します
/ask-distill	繰り返し起票されている同型のaskをまとめてメタaskを起票します
/memory-export	記録を他インスタンスへ渡すexportバンドルを作成します
/memory-import	他インスタンスのexportバンドルを衝突裁定を経て取り込みます

設定

.mcp.jsonのenvフィールドで以下の環境変数を設定すると、デフォルト値をオーバーライドできます。未設定の項目はデフォルト値で動作するため、ゼロコンフィグで使用可能です。

環境変数名	デフォルト	説明
CALM_DB_PATH	~/.claude/.claude-code-memory/discussion.db	データベースファイルのパス
CALM_HEARTBEAT_TIMEOUT	20	ホットアクティビティ判定の閾値（分）
CALM_IN_PROGRESS_LIMIT	3	アクティブコンテキストのin_progress表示件数
CALM_PENDING_LIMIT	2	アクティブコンテキストのpending表示件数
CALM_RECENCY_DECAY_RATE	0.0014	検索の時間減衰率
CALM_SYNC_DISABLE_RETROSPECTIVE	false	/sync-memoryのふりかえりセクションを非表示にする

環境変数は CALM_ 接頭辞に統一されている。旧名（CCM_ / CC_MEMORY_）も当面はフォールバックとして読まれるが、新名が設定されていればそちらが優先される。

リモートサーバー（claude.aiから接続）

claude.ai（Web版）からcc-memoryに接続するためのリモートサーバー構成。Cloudflare TunnelでHTTPS公開し、GitHub OAuthで認証する。

1. cloudflaredのインストール

brew install cloudflared

2. GitHub OAuth App作成

1. GitHub → Settings → Developer settings → OAuth Apps → New OAuth App
2. 以下を設定:
   • Application name: cc-memory（任意）
   • Homepage URL: CF Tunnelの公開URL（例: https://cc-memory.example.com）
   • Authorization callback URL: <公開URL>/auth/callback
3. Client IDとClient Secretを控える

3. 環境変数の設定

export GITHUB_CLIENT_ID="your-client-id"
export GITHUB_CLIENT_SECRET="your-client-secret"
export CALM_BASE_URL="https://cc-memory.example.com"
export CALM_ALLOWED_USERS="your-github-username"  # カンマ区切りで複数指定可
# export CALM_REMOTE_PORT="8001"  # デフォルト: 8001

CALM_ALLOWED_USERSに含まれないGitHubユーザーはOAuth認証後にアクセスが拒否される。

4. Cloudflare Tunnelのセットアップ

# 初回のみ: Cloudflareにログイン（ブラウザが開く）
cloudflared login

# トンネル作成
cloudflared tunnel create cc-memory
cloudflared tunnel route dns cc-memory cc-memory.example.com

# config.ymlに以下を追加
# tunnel: <tunnel-id>
# credentials-file: ~/.cloudflared/<tunnel-id>.json
# ingress:
#   - hostname: cc-memory.example.com
#     service: http://localhost:8001
#   - service: http_status:404

5. 起動

# リモートサーバー起動
uv run python -m src.remote

# 別ターミナルでCF Tunnel起動
cloudflared tunnel run cc-memory

6. claude.aiから接続

claude.ai → Settings → Integrations → Add Integration からリモートサーバーのURLを追加する。

ライセンス

MIT