모든 Claude Code 세션을 한눈에 보는 tmux 사이드바

Claude Code 세션 다섯 개를 동시에 돌려도, 지금 나를 기다리는 작업이 무엇인지 바로 압니다. macOS 용 무료 오픈소스.

curl -fsSL https://hivemux.dev/install.sh | bash

문서 보기GitHub 에서 보기
tmux 안의 hivemux 사이드바. 프로젝트 4개와 Claude Code 세션 5개가 실행 중, 입력 대기, 완료, 쉬는 중 상태로 보입니다
모든 tmux 세션의 모든 Claude 를 사이드바 하나에. 주황색이 나를 기다리는 세션입니다.

화면 더 보기

사이드바에서 하는 일

작업 카드에서 연 hivemux 우클릭 메뉴

한눈에

Claude 세션의 세 가지 상태

hivemux 는 Claude Code 자체 훅 이벤트를 읽어, 세션마다 작업 이름과 그 상태로 머문 시간을 카드로 보여 줍니다.

실행 중

Claude 가 일하는 중입니다. 카드가 빛나니 그냥 두면 됩니다.

입력 대기

승인이나 답이 필요합니다. 카드가 주황색으로 깜박이고 macOS 알림이 옵니다.

완료

작업이 끝났습니다. 확인할 때까지 상태 줄에 초록 배지가 남습니다.

벌 사무실

벌로 보는 Claude 세션

Claude Code 세션 하나하나가 벌이 되는 작은 사무실을 엽니다. 돌리고 기울이고 확대하거나, 위에서 본 2D 평면으로 바꿀 수 있습니다. 벌을 누르면 그 세션으로 갑니다.

hivemux office
web 이 입력을 기다리자 벌이 사장실로 달려갑니다. api 에 답하면 그 벌은 책상으로 돌아갑니다.
작업 중

책상에서 타이핑

Claude 가 일하는 동안 벌은 책상에서 타이핑합니다. 서브에이전트는 작은 도우미 벌로 옆에 섭니다.

입력 대기

사장실 질문 창구

Claude 가 나를 필요로 하면 벌이 질문 창구에 줄을 서고 화면 앞으로 튀어나옵니다.

완료

꿀 만들기

끝난 작업은 벌집에 채우는 꿀 한 병입니다. 꿀 탭에서 오늘·이번 주·이번 달 순위를 봅니다.

퇴근

밤에는 퇴근

퇴근하면 모든 Claude 를 멈추고 벌들은 집으로 갑니다. 출근하면 각자 같은 대화로 돌아옵니다.

사무실 앞으로 튀어나온 벌: api 에서 기다려요, migrate api schema, 1분 12초째 기다리는 중, ⌥1 로 이동 버튼과 나중에 버튼

입력이 필요할 때 앞으로 나오는 벌

기다리는 벌이 작업 이름과 기다린 시간을 들고 앞으로 나옵니다. 한 번 누르면 그 tmux 칸으로 갑니다.

벌 사무실 →

여러 세션을 동시에 돌리는 데 맞춘 기능

모든 세션을 보드 하나에

프로젝트마다 색 상자, Claude 마다 카드. 모든 tmux 세션을 모아 보여 주고, 넓히면 2~3열이 됩니다.

필요한 알림만

작업이 입력을 기다리거나 끝나면 macOS 알림이 옵니다. 지금 보고 있는 작업은 빼고요.

키 하나로 이동

Option+1..9 로 해당 세션, Option+0 으로 가장 오래 기다린 세션으로 갑니다.

픽업 보드

푸드코트 주문 번호판처럼, 나를 기다리거나 막 끝난 작업의 번호 배지가 상태 줄에 뜹니다.

재부팅 후 복구

tmux-resurrect 가 화면 배치를 되살리고, hivemux 가 칸마다 claude --resume 을 실행합니다.

Claude 가 말한 파일 열기

Option+O 로 칸에 나온 파일 경로를 VS Code, Cursor, Zed 에서 엽니다. Remote-SSH 에서도 됩니다.

동작 원리

데몬도 클라우드도 없습니다. hivemux 는 Claude Code 에 이미 있는 훅과 tmux 에 이미 있는 옵션을 쓰는 셸·Python 스크립트입니다.

  1. 01

    Claude Code 훅

    세션마다 작업 시작, 입력 요청, 멈춤을 알립니다.

  2. 02

    tmux 칸 옵션

    상태는 칸 자체에 @claude_state 로 저장됩니다.

  3. 03

    사이드바, 상태 줄, 사무실

    창마다 이 값으로 보드와 픽업 배지를 그리고, 벌 사무실도 같은 상태를 읽습니다.

동작 원리 자세히 →

한 줄 설치

설치기는 tmux 와 셸 설정에 표시된 블록만 추가하고, hivemux uninstall 은 정확히 그 블록만 지웁니다.

# curl
curl -fsSL https://hivemux.dev/install.sh | bash

# 또는 Homebrew
brew install esteban-eg-kim/tap/hivemux
hivemux setup
설치 안내 전체 보기 →

요구 사항

  • macOS (Linux 는 아마 되지만 시험 안 함)
  • tmux 3.3 이상
  • jq, git, python3
  • Claude Code (로그인 상태)
  • Ghostty 권장, 다른 터미널도 됨

자주 묻는 질문

hivemux 는 무엇인가요?

hivemux 는 모든 Claude Code 세션을 실행 중·입력 대기·완료 상태로 보여 주고, 나를 기다리는 세션으로 바로 이동하게 해 주는 tmux 사이드바입니다.

hivemux 는 무료인가요?

네. hivemux 는 MIT 라이선스 오픈소스입니다.

코드나 프롬프트를 외부로 보내나요?

아니요. hivemux 에는 서버도 원격 측정도 없습니다. Mac 에서 Claude Code 훅 이벤트와 tmux 상태만 읽습니다. 네트워크를 쓰는 경우는 설치할 때 GitHub 에서 hivemux 와 tmux 플러그인 두 개(tmux-resurrect, tmux-continuum)를 받는 것, Claude 를 업데이트할 때 최신 Claude Code 버전을 확인하는 것, 직접 연결한 Mac 으로 가는 ssh 뿐입니다.

Linux 에서도 되나요?

아마 되지만 시험하지 않았습니다. 알림과 벌 사무실 창은 macOS 기준으로 만들었습니다.

내 tmux 설정을 그대로 쓸 수 있나요?

네. hivemux 는 설정 파일에 표시된 블록만 추가하고 나머지는 건드리지 않습니다. hivemux uninstall 은 그 블록만 지웁니다.

버그 신고나 질문은 어디로 하나요?

github.com/esteban-eg-kim/hivemux/issues 에 이슈를 남기거나 hello@hivemux.dev 로 메일을 보내 주세요. X 와 Threads(@xkorfun)로도 연락할 수 있습니다.

폰이나 다른 Mac 에서 세션을 볼 수 있나요?

폰에서는 Claude 앱의 Remote Control 을 쓰고, 다른 Mac 에서는 hivemux connect 로 ssh 를 통해 그 Mac 의 tmux 에 붙어 같은 사이드바로 봅니다.

나를 기다리는 Claude 를 바로 아는 법

hivemux 설치