Ark0N/Codeman

Manage Claude Code & Opencode in Tmux Sessions in a modern WebUI

解決的問題

Codeman 提供了一個集中式的自託管儀表板，用於在不同裝置上管理多個 AI 編程代理（如 Claude Code、OpenCode、Codex 和 Gemini）。它消除了手動管理獨立終端機會話的需要，允許使用者在停機期間或離開電腦時保持代理的生產力。

工作原理

Codeman 在持久的 tmux 會話中啟動 AI CLI 工具，並使用 Server-Sent Events (SSE) 將終端機輸出串流到基於 Web 的儀表板。它使用 PTY (pseudo-terminal) 來確保完整的 TUI 在瀏覽器中正確渲染。該系統包含用於閒置檢測和速率限制重置後自動恢復的 respawn 控制器，以及用於安全、無密碼行動裝置存取的專用 QR Code 身份驗證系統。

適用對象

使用 AI 編程代理並希望有一種持久、行動裝置友好的方式遠端監控和控制它們的開發人員，或是需要 AI 驅動開發共享工作空間的團隊。

亮點

  • 多 CLI 支援：在單一儀表板中執行 Claude Code、OpenCode、Codex 或 Gemini。
  • 行動裝置優化 UI：具有本地回顯、滑動導航和 QR Code 登入的觸控優化終端機。
  • 自主運行：具備閒置檢測、訂閱限制自動恢復以及代理排程 cron 任務等功能。
  • 即時視覺化：可拖動的浮動視窗，顯示子代理和代理團隊的即時活動與工具呼叫。
  • 持久性：基於 tmux 的會話確保在網路中斷或重啟期間工作不會遺失。