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)를 사용하여 터미널 출력을 웹 기반 대시보드로 스트리밍합니다. PTY (pseudo-terminal)를 사용하여 브라우저에서 전체 TUI가 올바르게 렌더링되도록 합니다. 시스템에는 유휴 상태 감지 및 속도 제한 재설정 후 자동 재개를 위한 respawn 컨트롤러와 안전한 비밀번호 없는 모바일 액세스를 위한 전용 QR 코드 인증 시스템이 포함되어 있습니다.

대상 사용자

AI 코딩 에이전트를 사용하며 원격으로 이를 모니터링하고 제어할 수 있는 지속적이고 모바일 친화적인 방법을 원하는 개발자 또는 AI 기반 개발을 위한 공유 워크스페이스가 필요한 팀.

주요 특징

  • 멀티 CLI 지원: Claude Code, OpenCode, Codex 또는 Gemini를 단일 대시보드에서 실행.
  • 모바일 최적화 UI: 로컬 에코, 스와이프 탐색 및 QR 코드 로그인이 포함된 터치 최적화 터미널.
  • 자율 운영: 유휴 상태 감지, 구독 제한에 따른 자동 재개 및 에이전트를 위한 예약된 cron 작업 기능.
  • 실시간 시각화: 서브 에이전트 및 에이전트 팀의 실시간 활동과 도구 호출을 보여주는 드래그 가능한 플로팅 창.
  • 지속성: tmux 기반 세션은 네트워크 끊김이나 재시작 중에도 작업이 손실되지 않도록 보장합니다.