那些熟悉的場景

場景一：週報恐慌

週五下午，主管問你這週做了什麼。你盯著螢幕，努力回想週一到底是在改 API 還是修前端的 bug。打開 git log，翻了 4 個 repo 的 commit 紀錄，花了半小時拼湊出一份自己都覺得不完整的週報。

場景二：上下文遺失

早上打開 Claude Code，才發現昨天忘了加 --resume。昨天的 session 裡有完整的架構討論、除錯過程、還有做到一半的計畫。現在要從一堆 session ID 裡面找回來？算了，重新跟 Claude 說一遍好了。

場景三：多專案混亂

同時在跑三個專案，每個專案每天好幾個 session。今天早上在 API server 做了什麼？auth 的修復是在哪個 session？完全想不起來。

如果你用 Claude Code，這些場景一定不陌生。

裝完就忘，需要時隨傳隨到

brew install vulcanshen/tap/clerk
clerk install

就這兩行。之後 clerk 會在背景默默工作 — 每次 session 結束，自動產生摘要，按日期和專案整理成 markdown 檔案。

完全在本地執行，不連任何遠端服務，資料不會離開你的電腦。你只需要 Claude Code。

功能展示

自動摘要

不用做任何事。session 結束後，clerk 自動讀取對話紀錄，過濾出對話文字，呼叫 claude -p 產生結構化摘要。每天每個專案一份，增量合併。

~/.clerk/
├── summary/
│   ├── 20260414/
│   │   ├── projects-my-api.md
│   │   └── work-frontend.md
│   └── 20260416/
│       ├── projects-my-api.md
│       └── work-frontend.md
├── tags/
│   ├── auth.md
│   ├── vue.md
│   └── refactor.md
└── ...

上下文恢復

忘了 --resume？在 Claude Code 裡打 /clerk-resume，clerk 會把過去的摘要和 transcript 餵給 Claude，幫你重建上下文。不用再翻 session ID。

語意搜尋

在 Claude Code 裡打 /clerk-search，說「auth」。clerk 不是單純字串比對 — 它會用 AI 語意推理，把 jwt、oauth、login 這些相關的 tag 也找出來。

週報產生器

這是最實用的功能：

clerk report --days 7

clerk 讀取過去 7 天的所有摘要，丟給 Claude 整理，輸出結構化報告：

### 總結 (2026-04-14 ~ 2026-04-18)

#### my-api-server
實作 JWT 使用者驗證、新增速率限制 middleware、
修復高併發下的連線池洩漏。

#### frontend-app
從 Vue 2 遷移至 Vue 3，以 Pinia 取代 Vuex，
更新所有單元測試。

---

### 依日期

#### 2026-04-14
- **my-api-server**：建立 JWT 驗證與 refresh token 輪換
- **frontend-app**：啟動 Vue 3 遷移、更新建置設定

#### 2026-04-16
- **my-api-server**：新增速率限制 middleware、修復連線池洩漏
- **frontend-app**：以 Pinia 取代 Vuex，遷移 12 個 store 模組

---

### 依專案

#### my-api-server
- **2026-04-14**：JWT 驗證與 refresh token 輪換
- **2026-04-16**：速率限制 middleware、連線池洩漏修復

#### frontend-app
- **2026-04-14**：Vue 3 遷移啟動、建置設定更新
- **2026-04-16**：Vuex → Pinia 遷移，12 個 store 模組轉換

三個視角：總結看全貌、依日期看每天做了什麼、依專案追進度。

直接存檔貼到你的週報裡：

clerk report --days 7 > weekly-report.md

預設 --days 1 只看當天，適合當 daily standup 的摘要。

想包含還沒結束的 session？加上 --realtime：

clerk report --days 7 --realtime

這會即時處理進行中的 transcript，但注意會消耗額外的 Claude API 額度。不加的話只包含已結束的 session。

Obsidian 整合

如果你用 Obsidian，~/.clerk/ 可以直接當 vault 開。摘要有 YAML frontmatter 的 tags，tag 檔案用標準 markdown link。打開 graph view 就能看到 tag 和摘要之間的關聯網路。

技術細節

• Go + Cobra CLI，單一二進制檔
• 透過 Claude Code 的 SessionStart/SessionEnd hook 觸發
• MCP stdio server 提供 tool 整合
• Cursor tracking — 只處理上次之後的新對話，省 token
• File locking 處理併發寫入
• 支援 macOS、Linux、Windows

安裝方式

# 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。

GitHub：github.com/vulcanshen/clerk

歡迎回饋和建議！