Session Kit – Claude Code 與 Codex 工作階段的終端機儀表板

這是什麼 – Session Kit 是一個小型的本機命令列工具，可讓您檢視、整理並在多個 Claude Code 或 Codex AI 編碼工作階段之間切換。它可在 Linux (systemd) 和 macOS 14+ 上執行，且在終端機或 SSH 斷線後仍能繼續運作。

為何開發此工具 – 作者經常同時執行多個 AI 輔助編碼工作階段。讓每個工作階段保持運作很容易，但要記住哪個工作階段正在等待輸入、哪個仍在執行中，或是哪個已經完成卻很困難。Session Kit 提供了一個單一的彩色清單，其中每個工作階段都有一個固定的編號，您可以輸入該編號以返回該工作階段。

主要功能

• 統一選擇器 – 一個畫面顯示所有 Claude Code 和 Codex 工作階段，並包含編號、名稱、供應商、帳戶、模型、狀態和最後活動等欄位。
• 狀態提示 – 工作階段會被標記為 question、needs you、working、idle 或 pending，讓您能輕鬆找出需要注意的工作階段。
• 基於編號的跳轉 – 按下工作階段的編號（或按 Enter 選擇第一個），工具就會將您附加至該即時工作階段。
• 承受斷線 – 即使您關閉終端機或失去 SSH 連線，工作階段仍會在主機上繼續執行。
• 各工作階段獨立帳戶 – 每個工作階段可以使用不同的供應商帳戶/訂閱；帳戶是工作階段的屬性，而非終端機的屬性。
• 已關閉工作階段的還原 – 當您關閉工作階段時，完整的對話內容會被儲存，並可在稍後重新開啟。
• 委派工作隔離 – 機器端發起的工作階段會在專用分支上取得自己的 Git 工作樹，防止兩個工作者編輯相同的檔案。
• 安全模型 – UI（選擇器）絕不會被視為即時工作階段的證明。在進行任何變更之前，Session Kit 會重新驗證確切的供應商程序 UUID 和世代；如果驗證失敗，則會拒絕該動作。
• 無遙測 – 所有資料都保留在主機上；沒有遠端服務、分析或更新探標。

運作方式（高階概念）

1. 您在執行 AI 工作的機器（具備 systemd 的 Linux 或 macOS 14+）上安裝 Session Kit。它依賴於 shpool 工作階段管理員。
2. 執行 kit 會啟動選擇器 UI。
3. 選擇工作階段（透過編號或 Enter）會重新附加至底層由 shpool 管理且正在執行 Claude Code 或 Codex 的 shell。
4. 當您關閉終端機時，shpool 程序會讓 AI 工作階段保持運作；稍後重新連線時會顯示相同的工作階段編號。
5. 所有動作（開啟、關閉、移動）都受到短期的證明保護，確保即時的供應商程序與儲存的身分相符。

安裝 – README 提供了兩種方式：

• AI 助理捷徑 – 提供給 AI 一組命令區塊，以下載最新發布的資產、驗證 SHA-256 總和檢查碼、執行 ./install.sh --check（唯讀的預先檢查），然後執行 ./install.sh，接著執行 session-kit doctor 和 session-kit services enable。
• 手動腳本 – 一段簡短的 Python 程式碼會查詢 GitHub 發布 API，下載 tarball 和總和檢查碼檔案、驗證它們、解壓縮並執行安裝腳本。

典型工作流程

# start the picker
kit

# open a new session (defaults to Claude Code)
sp new claude

# open a Codex session
sp new codex

# see which sessions need a reply
kit   # then press 'a'

# close a session by number
k 3   # from the picker

它不做什麼

• 它不是終端機多工器（非 tmux 的替代品）。
• 它不追蹤 Token 成本，也不提供程式碼變更的 diff。
• 它不是安全沙箱；它只保護您避免對錯誤的工作階段執行動作。

文件與協助 – 存放庫包含一個 docs/ 資料夾，其中提供了針對性的指南：

• install.md – 所有安裝路徑與 shpool 詳細資訊。
• usage.md – 如 sp new、sp close、sp account enroll 等命令。
• configuration.md – 顏色、選擇器行為、看門狗設定。
• picker-navigation.md – 按鍵綁定與滑鼠動作。
• security-and-data.md – 隱私模型與選用的歷史記錄儲存。

成熟度 – 公開測試版 v0.4.3。核心選擇器、身分驗證以及 Claude Code/Codex 整合已穩定；專案更新迅速（三週內發布了 13 個版本）。沒有正式的支援，但作者會回應問題並推送安全性修復。

---

Session Kit 是一個真正的開源公用程式，用於管理多個 AI 編碼工作階段，專為大量使用 Claude Code 或 Codex 且需要可靠方式來追蹤它們的開發人員所設計。