✓ 01
REQUIRED
Claude Code CLI
沒裝先看 官方指南。本教學不教 Claude Code 安裝。
// INSTALL → DAEMON → MCP → HOOKS → (EXTRACT) · LOCAL ONLY
npm install 只是開始——daemon 還沒開、MCP 還沒接、hooks 還沒設定。 這頁帶你跑完 4 步讓系統活起來，再用第 5 步（可選）讓記憶自己長出來。
每步都是單一 command。中間若出錯不會弄壞前一步——可以放心一步一步試。跑完這四步系統就能用；要讓記憶自己長出來還有第 5 步，在最後面。
裝完你會拿到兩個 CLI 命令：ccmem（daemon 本體）跟 ccmem-mcp（給 Claude Code 呼叫的 MCP server）。
npm install -g @tznthou/ccrecall
為什麼 CLI 叫 ccmem 不叫 ccrecall？因為 npm 上 ccrecall 已經被 spences10/ccrecall（不同的 analytics 工具）用掉了。專案名還是 ccRecall，只有 binary 名字避開衝突。
一行命令把 daemon 註冊成 macOS LaunchAgent：寫 plist 到 ~/Library/LaunchAgents/、建 log 目錄、立刻啟動，之後每次登入也會跑。
ccmem install-daemon
// LINUX / WINDOWS / 試玩 → 改前景跑
ccmem # Ctrl+C 結束
把 ccRecall 的 MCP server 註冊給 Claude Code。--scope user 代表所有專案都能用——不需要每個 repo 重設。
claude mcp add ccrecall --scope user -- ccmem-mcp
Step 3 的 MCP 是「Claude 想查才查」。Hook 是「每次 session 開頭/結尾自動跑」——SessionStart 負責把記憶帶進新對話，SessionEnd 負責確認這次對話有被索引到。一行命令搞定：找 ~/.claude/settings.json、備份原檔、合併（非覆蓋）兩個 hook 註冊。
ccmem install-hooks
⚠ IMPORTANT
裝完要重開 Claude Code session——hook 設定不會 hot-reload。 想看會寫什麼而不真的寫：ccmem install-hooks --dry-run。 要拔掉：ccmem uninstall-hooks（只刪 ccRecall 自己的 entry）。
前四步給你的是索引、開場注入、跟手動 recall_save。到這裡為止，記憶只有你主動存才會有。 要讓它自己累積，在 shell 設定檔加一行——之後每次對話結束，Haiku 會讀完整段，抽出最多 5 筆存進庫裡，一次約 $0.001。
source "$(npm root -g)/@tznthou/ccrecall/scripts/post-session-extract.sh"
之後用 ccrecall-extract 取代 claude，原本的 flag 都通用：
ccrecall-extract # 取代 claude
ccrecall-extract --resume # flag 照舊
alias ccdm='ccrecall-extract' # 嫌長就設 alias
// 需要 jq 跟 curl 在 PATH 上（macOS 都內建）
單次跳過萃取：CCRECALL_SKIP_EXTRACT=1 ccrecall-extract。 daemon 沒開時 wrapper 會自己跳過，不會擋住你開對話。
// 4 STEPS → SYSTEM LIVE · +1 STEP → MEMORIES GROW ON THEIR OWN
三個快速確認點。出問題的話，看完這節大致能定位是哪一環。
CHECK #01
回 {"status":"ok"} 就對了。7749 是預設 port，要改的話在 plist 裡改 CCRECALL_PORT。
CHECK #02
重新開一個 Claude Code session，隨便問：
Claude 應該會主動呼叫 mcp__ccrecall__recall_query 工具搜尋以前的對話。看到它「正在查記憶」就是接上了。
CHECK #03
Daemon 啟動當下會自動跑 runIndexer，把歷史 JSONL 全掃一遍建索引。掃完後 watcher 才開始監看新檔。首次啟動期間查不到東西是正常的——十幾個 session 幾秒、幾百個可能要一兩分鐘。
裝好之後，這幾頁講的是它在背後做什麼、跟另一個工具怎麼分工。
CCRECALL · DETAIL
元件規格、信任契約、index → distill → inject → recall 全流程、存進去實際長什麼樣。
→ ccrecall 詳細頁
SCHEMA · CONTRACT
6 張 baseline 為何要求 cross-PR、其餘依所有權怎麼分、migration 為何每步都能 rollback。
→ architecture 頁
CCFAMILY · OVERVIEW
ccRecall 往前記、ccRewind 往回找——兩個工具解的不是同一個問題。
→ ccfamily 首頁
SUPPORT
GitHub Issue 追蹤 bug、設計討論、feature request。
→ github.com/tznthou/ccRecall/issues