craftzdog/tmux-claude-session-manager

解決的問題

本專案提供了一種在不同專案之間管理多個並行 Claude Code 會話的方法。它消除了手動追蹤哪些 AI 代理仍在工作、哪些處於空閒狀態，或它們位於哪些 tmux 會話中的需求，讓使用者能從單一介面快速切換。

工作原理

• 會話追蹤：使用 claude agents --json 作為真實資料來源，識別正在執行的代理及其目前狀態（工作中、等待中或空閒）。
• 進程對應：透過將進程 ID（PID）對應至 TTY，再對應至 tmux 窗格，將每個 Claude 進程與其對應的 tmux 窗格配對。
• 導航：由 fzf 驅動的中央選擇器使用 capture-pane 提供每個代理螢幕的即時預覽。使用者可從選擇器中跳轉至特定代理、為目前目錄啟動新會話，或直接在選擇器中終止已完成的代理。
• 整合：作為 tmux 插件整合，利用 display-popup 提供無縫的覆蓋體驗。

適用對象

在多個目錄中執行多個 AI 代理的 Claude Code 使用者，希望在 tmux 內透過集中方式監控與切換代理。

特色亮點

• 即時狀態監控：無需開啟會話即可立即查看代理是否處於 working、waiting 或空閒狀態。
• 集中式選擇器：單一彈出介面，用於列出、過濾並跳轉至任何執行中的 Claude 代理。
• 即時預覽：在選擇器中即時擷取代理目前輸出的螢幕畫面。
• 智慧跳轉：自動切換回會話啟動的原始視窗，並在彈出視窗中恢復代理。
• 快速啟動器：透過單一快捷鍵快速啟動或重新連接目前目錄的 Claude 會話。