Stats
Links
Categories
Marketplace
claude-code-memory-marketplace
$
npx claudepluginhub isizono/cc-memoryREADME
1 Plugin
claude-code-memory
1·
Claude Codeの記憶を外部DBに保存し、セッション間で知識・決定事項・アクティビティを永続化する
today
isizononpx claudepluginhub isizono/cc-memoryClaude Codeの記憶を外部DBに保存し、セッション間で知識・決定事項・アクティビティを永続化する
isizonoClaude Codeのセッション間で、議論の文脈・決定事項・作業状況を永続化するプラグインです。
Claude Codeはセッションごとに記憶がリセットされます。短いタスクなら問題ありませんが、長期プロジェクトでは「前に何を決めたか」「なぜその設計にしたか」「どこまで作業が進んでいるか」がセッションをまたぐと失われます。
claude-code-memoryは、こうした文脈をSQLiteデータベースに保存し、新しいセッションでAIが自動的に過去の記録を参照できるようにします。同じ説明を繰り返す必要がなくなり、議論の積み重ねがそのまま次のセッションに引き継がれます。
--enable-loadable-sqlite-extensions が無効のため非対応brew install [email protected]) を推奨# マーケットプレイスを追加
claude plugin marketplace add isizono/cc-memory
# プラグインをインストール
claude plugin install claude-code-memory
インストール後、Claude Code内で以下を実行すると使い方の案内が表示されます。
/guide
| カテゴリ | ツール | 説明 |
|---|---|---|
| トピック | add_topic, get_topics | 議論トピックの作成・取得 |
| 議論ログ | add_log, get_logs | 議論の経緯や検討過程の記録・取得 |
| 決定事項 | add_decision, get_decisions | 合意内容の記録・取得 |
| アクティビティ | add_activity, get_activities, update_activity | 作業タスクの作成・取得・状態更新 |
| check-in | check_in | アクティビティにcheck-inし、tag notes・資材・関連decisionsを集約取得 |
| 資材 | add_material, get_material | セッション中の成果物をタグ付き独立エンティティとして保存・取得 |
| リレーション | add_relation, remove_relation, get_map | エンティティ間の関連の追加・削除・グラフ探索 |
| 振る舞い | add_habit, get_habits, update_habit | check-in時に注入される運用ルールの管理 |
| タグ | search_tags, update_tag, analyze_tags | タグの検索・タグ情報の更新・タグ共起分析 |
| 検索 | search, get_by_ids | キーワード横断検索・詳細情報の取得 |
| スキル | 説明 |
|---|---|
/guide | cc-memoryの使い方をAIが説明します |
/sync-memory | セッション終了前にtranscriptを解析し、トピック・決定事項・アクティビティを一括で記録・更新します |
/check-in | アクティビティにcheck-inして関連情報を集約取得します |
/tag-notes | タグのnotesを確認・更新します |
/tag-cleanup | タグの共起分析を実行し、整理提案をユーザーに提示します |
/scribe | cc-memoryの記録からドキュメントを生成します |
/postmortem | completedアクティビティを振り返り、教訓を永続化します |
.mcp.jsonのenvフィールドで以下の環境変数を設定すると、デフォルト値をオーバーライドできます。未設定の項目はデフォルト値で動作するため、ゼロコンフィグで使用可能です。
| 環境変数名 | デフォルト | 説明 |
|---|---|---|
CCM_DB_PATH | ~/.claude/.claude-code-memory/discussion.db | データベースファイルのパス |
CCM_HEARTBEAT_TIMEOUT | 20 | ホットアクティビティ判定の閾値（分） |
CCM_IN_PROGRESS_LIMIT | 3 | アクティブコンテキストのin_progress表示件数 |
CCM_PENDING_LIMIT | 2 | アクティブコンテキストのpending表示件数 |
CCM_RECENCY_DECAY_RATE | 0.0014 | 検索の時間減衰率 |
CCM_SYNC_DISABLE_RETROSPECTIVE | false | /sync-memoryのふりかえりセクションを非表示にする |
claude.ai（Web版）からcc-memoryに接続するためのリモートサーバー構成。Cloudflare TunnelでHTTPS公開し、GitHub OAuthで認証する。
brew install cloudflared
cc-memory（任意）https://cc-memory.example.com）<公開URL>/auth/callbackexport GITHUB_CLIENT_ID="your-client-id"
export GITHUB_CLIENT_SECRET="your-client-secret"
export CC_MEMORY_BASE_URL="https://cc-memory.example.com"
export CC_MEMORY_ALLOWED_USERS="your-github-username" # カンマ区切りで複数指定可
# export CC_MEMORY_REMOTE_PORT="8001" # デフォルト: 8001
CC_MEMORY_ALLOWED_USERSに含まれないGitHubユーザーはOAuth認証後にアクセスが拒否される。
# 初回のみ: 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
# リモートサーバー起動
uv run python -m src.remote
# 別ターミナルでCF Tunnel起動
cloudflared tunnel run cc-memory
claude.ai → Settings → Integrations → Add Integration からリモートサーバーのURLを追加する。
MIT