這是什麼

clerk 是一個 CLI 工具，掛載到 Claude Code 的 session 生命週期。每次 session 結束時，自動產生增量摘要，存成 markdown 檔案。累積下來就是一個可搜尋的工作知識庫。

brew install vulcanshen/tap/clerk
clerk install

裝完就不用管了。不需要記任何指令。

解決什麼問題

Claude Code 不會跨 session 記憶。要回顧過去的工作，你只能自己翻 session ID、用 --resume 載入、請 Claude 重新讀一遍完整的 transcript。每次都消耗大量 token。

clerk 在每次 session 結束時只做一次 API 呼叫，產生增量摘要存成 markdown。需要回顧的時候，資料已經整理好了。

能做什麼

週報

clerk report --days 7

讀取過去 7 天的所有摘要，送給 Claude 整理，輸出結構化報告（總結、依日期、依專案三個視角）。

上下文恢復

在 Claude Code 裡打 /clerk-resume，clerk 把過去的摘要和 transcript 路徑回傳給 Claude，重建上下文。

搜尋

在 Claude Code 裡打 /clerk-search，用關鍵字跨專案搜尋過去的工作。

每日摘要

自動產生，依日期和專案整理：

~/.clerk/summary/
├── 20260414/
│   ├── my-api-server.md
│   └── frontend-app.md
└── 20260418/
    └── my-api-server.md

運作流程

Session 結束 → clerk feed（背景執行）→ 讀取 transcript → 呼叫 claude -p → 儲存摘要 + 索引

• 透過 Claude Code 的 SessionStart/SessionEnd hook 觸發
• Cursor tracking — 只處理上次之後的新訊息，省 token
• MCP server 提供 /clerk-resume 和 /clerk-search 整合
• 單一 Go 二進制檔，除了 Claude Code 沒有其他依賴

資料安全

所有輸出都是標準 YAML frontmatter + markdown。沒有專有格式，沒有鎖定。

你的檔案可以用任何文字編輯器、Obsidian、Notion、grep 或自己的腳本處理。把 clerk 和 Claude Code 都移除了，摘要還是你的。

完全在本地執行。不連遠端服務、不需要帳號、資料不會離開你的電腦。

安裝

# Homebrew
brew install vulcanshen/tap/clerk

# 安裝腳本
curl -fsSL https://raw.githubusercontent.com/vulcanshen/clerk/main/install.sh | sh

# 從原始碼
go install github.com/vulcanshen/clerk@latest

執行 clerk install 設定 hook、MCP server 和 skill。

支援 macOS、Linux、Windows。

GitHub：github.com/vulcanshen/clerk