ccmm

日本語 | English

ccmm (Claude Code Memory Manager) は、Anthropic Claude Code の設定ファイル CLAUDE.md を
複数プロジェクト間で再利用／共有するための CLI ツールです。

npm install -g ccmm

または

npx ccmm

要件

• Node.js 18+
• Git
• GitHub CLI (gh) * 原則必須
• 環境変数 GITHUB_TOKEN * 必要に応じて

事前にCLAUDE-mdリポジトリを作成し、Githubにプッシュしておく。（プライベートリポジトリで構いません）

CLAUDE-mdリポジトリは以下のような構成。

CLAUDE-md/
├── react.md
├── typescript.md
├── nextjs.md
├── vue.md
├── python.md
├── nodejs.md
└── common.md

参考: サンプル

CLAUDE-mdリポジトリを用意した上で、

cd YOUR_PROJECT/
ccmm init

1. 参照したい CLAUDE-md リポジトリ（例: myorg/CLAUDE-md）を選択
2. 自動で CLAUDE.md 末尾に 1 行が追加されます

+ @~/.ccmm/projects/<hash>/merged-preset-HEAD.md

この行は変更しないでください。また、この行より下に追記を行わないでください。

ccmm config add myorg/CLAUDE-md     # 新しいプリセットリポジトリを追加
ccmm config remove myorg/CLAUDE-md  # プリセットリポジトリを削除

ccmm config list                    # 設定済みのプリセットリポジトリ一覧を表示

ccmm config set-default myorg/CLAUDE-md    # デフォルトリポジトリを設定
ccmm config get-default                     # 現在のデフォルトリポジトリを表示

デフォルトリポジトリを設定すると、ccmm init時に自動的にそのリポジトリが選択されるにゃん。

ccmm sync

• 選択したプリセット（例: react.md, typescript.md）を $HOME/.ccmm/presets/... にダウンロード
• 自動でmerged-preset-HEAD.md を再生成し、Claude Code が読むように設定

ccmm edit react.md     # エディタでプリセットファイルを開く
ccmm edit              # 引数なしで実行すると選択UIが表示

既存のプリセットファイルを直接エディタで編集できます。引数なしで実行すると、対話的にプリセットファイルを選択できます。

ccmm push react.md     # 変更をGitHub PRとして送信
ccmm push              # 引数なしで実行すると選択UIが表示

git add CLAUDE.md      # 追記をステージ
ccmm extract          # 変更行をプリセットに振り分け

CLAUDE.mdに直接書いた内容を、適切なプリセットファイルに移動させることができます。

ccmm lock <commitSHA>
git commit -am "chore: lock CLAUDE presets @<SHA>"

• import 行が merged-preset-<SHA>.md に置き換わります

ccmm sync              # lock 付きプロジェクトなら自動で固定版を読む

解除したいときは：

ccmm unlock            # HEAD バージョンに戻す

Claude Code を起動して、/memoryコマンドを実行すると、読み込んでいるファイルのツリーが確認できます。

npm rm -g ccmm
rm -rf ~/.ccmm        # キャッシュごと削除（任意）

Happy Claude Coding 🚀