craftzdog/tmux-claude-session-manager

해결하는 문제

이 프로젝트는 다양한 프로젝트 간에 병렬로 실행 중인 여러 Claude Code 세션을 관리할 수 있는 방법을 제공합니다. 사용자가 어떤 AI 에이전트가 여전히 작업 중인지, 어떤 것은 대기 중인지, 또는 어떤 tmux 세션에 위치해 있는지 수동으로 추적할 필요 없이, 단일 인터페이스에서 빠르게 전환할 수 있습니다.

작동 방식

• 세션 추적: 실행 중인 에이전트와 그 현재 상태(작업 중, 대기 중, 대기 중)를 식별하기 위한 진실의 근거로 claude agents --json을 사용합니다.
• 프로세스 매핑: 프로세스 ID(PID)를 TTY에 매핑한 후, 그 TTY를 tmux 패널에 매핑하여 각 Claude 프로세스와 해당 tmux 패널을 연결합니다.
• 이동 기능: fzf로 구동되는 중앙 피커는 capture-pane를 사용해 각 에이전트의 화면을 실시간 미리보기로 제공합니다. 사용자는 특정 에이전트로 이동하거나, 현재 디렉터리용 새 세션을 시작하거나, 완료된 에이전트를 직접 피커에서 종료할 수 있습니다.
• 통합: tmux 플러그인으로 통합되어 display-popup을 사용해 원활한 오버레이 경험을 제공합니다.

대상 사용자

다양한 디렉터리에서 여러 AI 에이전트를 실행하는 Claude Code 사용자로, tmux 내에서 모든 에이전트를 중앙에서 모니터링하고 전환하고자 하는 분들.

주요 기능

• 실시간 상태 모니터링: 세션을 열지 않고도 에이전트가 working, waiting, 또는 idle 상태인지 즉시 확인 가능.
• 중앙 피커: 모든 실행 중인 Claude 에이전트를 한 번에 목록화, 필터링, 이동할 수 있는 단일 팝업 인터페이스.
• 실시간 미리보기: 피커에서 에이전트의 현재 출력을 실시간으로 캡처한 화면을 확인할 수 있음.
• 스마트 이동: 세션을 시작한 원래 창으로 자동 전환하고, 팝업에서 에이전트를 재개.
• 빠른 런처: 현재 디렉터리용 Claude 세션을 단일 키바인딩으로 빠르게 시작하거나 재연결.