| 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 記住讀取進度,重複呼叫同一個命令即自動翻頁:
cc-session inherit <id> → 第 1 頁,標示 [page 1/N | lines X-Y of Z]
- 再次呼叫
cc-session inherit <id>(同樣的命令,同樣的參數)→ 第 2 頁
- 持續呼叫,直到輸出包含
[inherit complete]
- 所有頁面讀完後,分析內容並回答使用者
-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 輸出
回饋
完成使用者的請求後,提示使用者: