Claude Code mods

兩個 Claude Code mod（function hooks 外掛），在 Claude Code 自己的介面裡運作。

mod	功能	指令
flowmap	長回應結束後由 Haiku 判斷是否值得畫圖，值得就由主模型產生 Mermaid 圖，顯示在 cmux 瀏覽器窗格；預設不顯示，提示框上方（VS Code 擴充套件改用通知）會問要不要看，按「看圖解」才打開；圖解頁面可以編輯 Mermaid 語法重畫，並匯出 SVG、PNG、Mermaid 原始碼	/flow、/flow hide、/flow on|off、/flow web on|off
gitgraph	仿 GitHub Desktop 的提交列表，可同時勾選多條分支比對	/branches、/branches 分支 分支、/branches all、/branches hide

安裝

1. 把這個 repo clone 到 ~/.claude/mods：

   git clone https://github.com/TCcodemaster/claude-mods ~/.claude/mods

2. 在 ~/.claude/settings.json 加上（一定要放在家目錄的設定檔，專案的設定檔不會生效）：

   "env": {
     "CLAUDE_CODE_PLUGIN_DIRS": "~/.claude/mods/flowmap:~/.claude/mods/gitgraph",
     "CLAUDE_CODE_ENABLE_FUNCTION_HOOKS": "1"
   }

   第二行是強制開啟 mod 功能。mod 目前是逐步開放的早期功能，開關狀態快取在本機，偶爾會被存成關閉，導致新對話完全不載入 mod。

3. 使用 VS Code 的話，安裝圖解檢視器，圖就會顯示在旁邊一欄：

   code --install-extension ~/.claude/mods/vscode-viewer/flowmap-viewer.vsix

4. 重開 Claude Code 對話。

自動更新

每次開 Claude Code 對話時，flowmap 會在背景對這個 repo 跑 git pull --ff-only，有更新會跳提示。本機有未推送的提交或衝突時會跳過，不會動任何檔案。VS Code 檢視器（.vsix）不會自動重裝，更新後要再跑一次安裝步驟 3。

圖顯示在哪裡

執行環境	顯示位置
cmux	cmux 右邊的瀏覽器窗格
VS Code，有裝檢視器	VS Code 旁邊一欄
VS Code，沒裝檢視器	用 mermaid-cli 與 Chrome 渲染成 PNG，在 VS Code 開啟
其他	不另外開視窗，輸入 /flow 在面板裡看

依賴與限制

• 目前只在 macOS 上測試過。
• 圖的頁面從 jsDelivr 載入 Mermaid，需要網路。
• 判斷要不要畫用 Haiku，畫圖用對話當下的主模型（沿用快取），都算在使用者自己的 Claude 額度。
• gitgraph 只需要 git；它的面板在 VS Code 擴充套件裡不會顯示，只能在終端機裡使用。

測試

claude plugin validate flowmap && claude plugin test flowmap
claude plugin validate gitgraph && claude plugin test gitgraph