hiroppy/tmux-agent-sidebar

해결하는 문제

여러 tmux 창과 세션을 수동으로 전환하여 AI 코드 에이전트를 모니터링할 필요가 없습니다. tmux 환경 내 어디에서 실행되고 있는지에 관계없이 모든 활성 에이전트를 중앙에서 확인할 수 있습니다.

작동 방식

이 프로젝트는 Claude Code, Codex, OpenCode와 같은 AI 에이전트와 통합되는 tmux 플러그인입니다. 훅과 플러그인을 사용해 프롬프트, 도구 호출, 작업 진행률과 같은 에이전트 메타데이터를 추적하고, 전용 사이드바에 표시합니다. 또한 Git worktree의 라이프사이클을 관리하여 한 번의 키스트로 새 worktree에서 에이전트를 시작하고 종료할 수 있습니다.

대상 사용자

tmux와 AI 코드 에이전트(특히 Claude Code, Codex, OpenCode)를 사용하며, 에이전트 활동을 통합 대시보드로 모니터링하고 작업 공간을 관리하고자 하는 개발자입니다.

주요 기능

• 통합 모니터링: 모든 tmux 세션과 창에서 에이전트를 하나의 사이드바에서 추적합니다.
• 실시간 메타데이터: 프롬프트, 응답 미리보기, 백그라운드 쉘 상태, 하위 에이전트 트리의 실시간 업데이트를 표시합니다.
• uma Worktree 관리: worktree와 관련된 에이전트를 빠르게 생성하고 삭제할 수 있습니다.
• 네이티브 알림: 에이전트가 작업을 완료하거나 오류를 발생시키거나 허가가 필요할 때 데스크톱 알림을 전송합니다.