
병렬 Claude Code 세션 관리가 어려워 터미널 매니저를 직접 만들었습니다 (내장 diff 리뷰 기능 포함)
요약
여러 개의 Claude Code 세션을 병렬로 관리하기 위해 직접 개발한 tmux 기반의 가벼운 TUI 도구를 소개합니다. 실시간 상태 확인, diff 리뷰, 세션 간 직접 입력 등 효율적인 에이전트 관리를 위한 핵심 기능을 제공합니다.
핵심 포인트
- 모든 Claude 세션의 실시간 상태(작업 중/대기 중 등)를 한눈에 확인 가능
- 구문 강조가 적용된 diff 리뷰 기능을 통해 변경 사항을 즉시 검토
- 세션에 직접 연결하지 않고도 매니저에서 에이전트에게 답변 가능
- Go 언어 기반의 오픈 소스 도구로 OpenCode, Codex 등과 호환
한 번에 하나의 Claude 세션만 실행한다면 이 도구는 과할 수 있습니다. 하지만 제가 3~4개를 병렬로 실행하기 시작하면서, "다 끝났나? 나한테 뭘 묻고 있나? 실제로 무엇을 변경했나?"를 확인하기 위해 터미널을 전환하며 시간의 절반을 보내게 되었습니다. 처음에는 공식 에이전트 TUI (Terminal User Interface)를 사용해 보았습니다. 괜찮긴 하지만 Claude 전용이며, 커스터마이징이 불가능하고 제가 필요로 하는 많은 기능이 빠져 있었습니다. 그 다음에는 여러 서드파티 매니저/오케스트레이터(orchestrators)들을 써보았습니다. 대부분 지나치게 복잡하고 공격적이거나(버그가 있거나, 할 수 없는 기능이 있거나, 내 컴퓨터의 리소스를 많이 잡아먹음), 유료였습니다. 성능이 좋으면서도 가벼운 도구를 찾지 못해 직접 만들었습니다.
작고 가벼운 tmux 기반의 TUI:
- 모든 세션의 실시간 상태(작업 중 / 대기 중 / 완료 / 종료) 표시: Claude Code의 훅(hook) 이벤트를 가져오므로 정확함
- 프로젝트별 그룹화: 접힌 그룹에서도 상태 요약(status rollup) 표시
- 세션에 직접 연결(attach)하지 않고도 모든 창(pane) 미리보기 가능, 매니저에서 직접 타이핑하여 대기 중인 에이전트에게 답변 가능
- D 키를 눌러 에이전트의 diff(차이점)를 즉시 리뷰: 구문 강조(syntax-highlighted), 범위별(per-scope) 표시, 주석 라인 지원 및 리뷰 내용을 해당 창으로 다시 전송 가능
- 두 번의 키 입력으로 프롬프트와 함께 새 에이전트 생성
무료, 오픈 소스, Go 언어, MIT 라이선스. brew install yoanwai/tap/agent-manager
OpenCode, Codex, Grok과도 호환되며, 설정(config)을 통해 다른 어떤 CLI 에이전트도 연결할 수 있습니다. 따라서 하나의 구독을 사용하든 여러 개를 혼합해서 사용하든 상관없이 적합합니다. 피드백과 기여를 환영하며, 더 많은 계획이 준비되어 있습니다. https://github.com/YoanWai/agent-manager
AI 자동 생성 콘텐츠
본 콘텐츠는 r/ClaudeAI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기