git-dashboard — 在終端機掌握 Claude Code 的開發全局 🧠

🏗️ 為什麼開發這個？

在使用 Claude Code 或 AI Agent 進行開發時，編碼節奏會被極度壓縮。Agent 會在短時間內橫跨多個 Repo 改動檔案、切換 Branch、自動產生 Commit。

當你回過神來，往往會發現自己陷入了「資訊過載」：不確定哪個 Repo 剛被 Push、哪個 Branch 還有殘留的 Uncommitted Changes。當你同時開啟 5 個以上的 Repo 時，你需要的不是另一個功能複雜的 Git GUI，而是一個 Read-only 的全景視圖，讓你在 AI 瘋狂輸出時，依然能保有對全局的掌控力。

---

🛠️ 技術實踐與選擇

• 單檔架構：這是一個非常清亮簡單的工具，不是一個框架。單檔 dashboard.py 意味著你可以直接跑起來，不用管 package structure，對一個 TUI App 來說完全可控。
• Textual + Rich：選用支援 CSS-like layout 的 TUI 框架，寫起來像前端但跑在 Terminal上，你可以快速的切換Claude Code和dashboard。

• 原生 Git CLI 呼叫：不依賴 GitPython，直接透過 subprocess 呼叫 git 指令最可靠，並加上 10 秒 Timeout 防止進程 Hang 住。
• 純唯讀設計 (Read-only)：刻意不做任何 Git Write 操作。Dashboard 的職責是「呈現資訊」而非「操作」，這消除了 AI 自動化過程中的誤操作風險，讓 Code 更簡潔。

---

✨ 專為 Claude Code 打造的亮點

1. Commit-to-Cost 關聯分析 💰

這是最有趣的 Feature。工具會讀取 ~/.claude/projects/ 下的 JSONL Session 檔，算出每個專案的 Token 消耗與費用，並將 Session 與 Git Commit 做時間序列比對。

你可以直觀地看到：「這一個 Feature 的 Commit，背後花了 $0.12 的 AI 資源」。

2. 文件導航 (PRD/DECISION) 📑

AI 產出的長文件通常充斥大量 Markdown。我們內建了 Section Navigation，按 n / p 即可在 ## 標題間快速跳轉，大幅提升閱讀 AI 決策紀錄的效率。

3. 全局 Repo 監控 🖥️

左側為專案列表，右側提供 7 個 Tab（Git Status, Commit Log, Branch Graph 等）。支援 f 鍵將常用 Repo 釘選（Featured），即便你有 20 個 Repo 也能快速定位。

---

💡 開發心得

在使用 AI Assistant 開發時，我們很容易進入一種**「只看 Diff，不看全局」**的隧道視野。

寫這個工具的過程讓我意識到：AI 加速了寫 Code 的速度，但人類需要工具來加速「理解現狀」的速度。 Read-only 的限制反而是最重要的設計決策，因為它迫使 Dashboard 專注在「呈現資訊」這件事上，幫助開發者在 AI 時代保持清醒。

---