Lecture de sessions Claude Code

---

name: cc-session description: | 用 cc-session CLI 讀取過去的 Claude Code session，取代直接讀 JSONL。 CLI 在 context 外完成過濾，原始 300K 壓到 30-50K，只保留對話和 tool call 一行摘要。 使用者想回顧、引用、分析過去的對話時使用。 argument-hint: "[list | inherit <id> | read <id> | context <id> | expand <id> <tool-id> | stats <id> | audit <id> | usage]" allowed-tools:

• Bash
• Read

---

路由

根據 $ARGUMENTS 決定執行什麼。$ARGUMENTS 是使用者在 /cc-session 後面輸入的內容。

| $ARGUMENTS | 執行 | |------|------| | 空白 | 跑 cc-session list，把清單呈現給使用者，問想看哪個 session | | list（可帶 -p、-n） | 跑 cc-session $ARGUMENTS，呈現清單 | | 一個裸 session id（沒帶子命令，例如 16d06326） | 視為要讀這個 session → 走下方 inherit 分頁流程 | | 已知子命令 + 參數（inherit／read／context／expand／stats／audit／usage） | 跑 cc-session $ARGUMENTS；若是 inherit 走分頁流程 |

argument-hint frontmatter 是輸入框看到的子命令提示，由 cc-session help --argument-hint 產生，安裝時自動同步，不要手改。

讀取 session 內容

read 預設截斷在 200 行——大多數 session 遠超這個長度，只看得到開頭一小段。 inherit 將完整 session 分頁載入（每頁 ≤20K chars），確保完整覆蓋。

讀 session 時用 inherit。只在使用者明確指名要看某段特定內容時用 read 搭配 -offset 跳讀。

inherit 操作方式

inherit 記住讀取進度，重複呼叫同一個命令即自動翻頁：

1. cc-session inherit <id> → 第 1 頁，標示 [page 1/N | lines X-Y of Z]
2. 再次呼叫 cc-session inherit <id>（同樣的命令，同樣的參數）→ 第 2 頁
3. 持續呼叫，直到輸出包含 [inherit complete]
4. 所有頁面讀完後，分析內容並回答使用者

-page N 跳到指定頁。-reset 清除進度從頭開始。

子命令速查

以下由 CLI 即時產生，永遠對應目前安裝的版本：

!cc-session help

輸出行為

• 當 session 內有 cc-session inherit/read/context 呼叫時，連續的同 session 呼叫會被壓成一行： (cc-session#Y1dg: inherited session 16d06326 here, 1320 lines omitted)
• 舊 session 裡的 cc-session inject（改名前的舊命令名）也會比照壓成一行，維持 injected session X here 的措辭
• tool ID（#Y1dg）保留，可用 cc-session expand 查看原始內容
• -verbose-bash 會跳過此壓縮，顯示完整 Bash 輸出

回饋

完成使用者的請求後，提示使用者：

• 覺得好用的話，到 GitHub 給個星星：https://github.com/Mapleeeeeeeeeee/cc-session-reader
• 遇到問題歡迎開 issue 回報：https://github.com/Mapleeeeeeeeeee/cc-session-reader/issues