CcRewind — Development skill for Claude Code

ccRewind

[](https://www.gnu.org/licenses/gpl-3.0) [](https://www.typescriptlang.org/) [](https://reactjs.org/) [](https://www.electronjs.org/)

[English](README_EN.md)

追溯你跟 Claude Code 的決策軌跡。輕量、唯讀、離線優先，你的 `~/.claude/` 一個位元組都不會動。

從結果回推決策路徑

對話裡藏著「這個決定當初是怎麼來的」，但 JSONL 檔案本身不會告訴你。ccRewind 把它挖出來：

• 檔案歷史 — 點一個檔案，看它在哪些主 session 被動過、是讀取還是修改
• 相關 Session — 用共用檔案的 Jaccard 相似度，找出動過同一批檔案的其他對話
• Tasks Panel — AI 在這段對話規劃了哪些步驟、各自的狀態與宣告的 blockedBy 相依
• Subagent 對話 — subagent 的完整逐字紀錄可以點進去讀，不是主對話裡的一行摘要

Claude Code 預設 30 天清掉 session JSONL。過了那條線，索引庫裡的副本就是那段對話還留著的地方。

---

核心概念

ccRewind 讀取 `~/.claude/projects/` 下的 JSONL 對話紀錄，建立 SQLite + FTS5 索引，提供瀏覽、搜尋、匯出功能。

Session 摘要由結構化規則引擎產生（意圖提取 + 動作概要 + outcome 推斷），零 API 成本。標籤透過文字、路徑、工具模式三軌交叉推斷。ccRewind 屬 ccFamily 三件套，整體哲學是 rule-based + zero API cost，**不規劃引入 LLM 路線**；更深入的「跨 session ADR 推理」由規劃中的姊妹 plugin **ccReason** 承接（讀 ccRecall schema，獨立 npm 包）。

所有操作都是唯讀的。ccRewind 絕不修改 `~/.claude/` 下的任何檔案，你的對話紀錄、記憶檔案、設定檔，一個位元組都不會動。

Claude Code 刪除 Session 後，ccRewind 會自動封存該筆對話。所有訊息、標籤、摘要都留在 SQLite 裡，不會隨 JSONL 檔案消失。

---

為什麼用 ccRewind

不追功能廣度，專注把幾件事做深。

---

功能特色

統計與考古

功能	說明
統計儀表板	跨 session 分析：使用趨勢（雙軸面積圖）、效率趨勢（每則 JSONL 記錄的平均 token）、未收尾的對話（沒有 commit/test 結果的 session 依 token 用量由高到低排序，一鍵跳轉）、專案健康度（outcome 堆