Running
Claude is working. The card glows, so you can leave it alone.
A tmux sidebar for every Claude Code session
Run five Claude Code sessions at once and always know which one needs you. Free and open source for macOS.
curl -fsSL https://hivemux.dev/install.sh | bash
More screens
Everything from the sidebar
- Claude Code
- tmux 3.3+
- macOS
- Ghostty recommended
- MIT license
- v0.1.40
One glance
Every Claude, in one of three states
hivemux reads Claude Code's own hook events and shows each session as a card with its task name and how long it has been in that state.
Waiting for you
Claude needs approval or an answer. The card pulses amber and macOS notifies you.
Done
The task finished. A green badge waits on the status line until you look.
Bee office
Your Claude sessions, as bees at work
Open a small office where every Claude Code session is a bee. Turn, tilt and zoom it, or switch to a flat 2D plan. Click a bee to jump to its session.
hivemux officeTypes at its desk
While Claude works, its bee types away. Subagents stand by as small helper bees.
Runs to the boss room
When Claude needs you, its bee lines up at the question window with why. Click it and answer right there.
Makes honey
A finished task is a jar of honey for the comb. The Honey tab ranks bees by day, week and month.
Goes home at night
Clock out every Claude, one project or just one; the bees walk home. Clock in and each resumes the same conversation.
It comes to the front when it needs you
The waiting bee pops out with the task name, why it waits and for how long. Answer right there with the terminal's own choices, or jump to that tmux pane.
Bee office →Built for running many sessions at once
One board for every session
A colored box per project and a card per Claude, across every tmux session, with why each one waits. Widen it for two or three columns.
Notifications that matter
A macOS notification when a task needs input or finishes, except the one you are already looking at.
Jump with one key
Option+1..9 goes to a session. Option+0 goes to the one that has waited longest.
Pickup board
Like a food-court order board: numbered badges on the status line for every task that needs you or just finished.
Survives reboots
tmux-resurrect restores the layout and hivemux runs claude --resume in each pane.
Open what Claude mentions
Option+O opens file paths from the pane in VS Code, Cursor or Zed, even over Remote-SSH.
How it works
No daemon and no cloud. hivemux is shell and Python scripts that use the hooks Claude Code already has and the options tmux already has.
- 01
Claude Code hooks
Each session reports when it starts work, asks for input or stops.
- 02
tmux pane options
The state is stored on the pane itself, as
@claude_state. - 03
Sidebar, status line, office
Every window draws the board and pickup badges from it, and the bee office reads the same state.
Install in one line
The installer adds clearly marked blocks to your tmux and shell config, and hivemux uninstall removes exactly those.
# curl curl -fsSL https://hivemux.dev/install.sh | bash # or Homebrew brew install esteban-eg-kim/tap/hivemux hivemux setupFull install guide →
Requirements
- macOS (Linux likely works, untested)
- tmux 3.3 or later
- jq, git, python3
- Claude Code, logged in
- Ghostty recommended, any terminal works
Questions
What is hivemux?
hivemux is a tmux sidebar that shows every Claude Code session — running, waiting for you, or done — and lets you jump to the one that needs you.
Is hivemux free?
Yes. hivemux is open source under the MIT license.
Does it send my code or prompts anywhere?
No. hivemux has no server and no telemetry. It runs on your Mac and reads Claude Code hook events and tmux state. Its only network requests are downloading hivemux and two tmux plugins (tmux-resurrect, tmux-continuum) from GitHub at install, checking the latest Claude Code version when you update Claude, and ssh to Macs you connect to yourself.
Does it work on Linux?
It likely works but is untested. Notifications and the bee office window are built for macOS.
Can I keep my own tmux config?
Yes. hivemux adds marked blocks to your config and leaves the rest alone. hivemux uninstall removes exactly those blocks.
Where do I report a bug or ask a question?
Open an issue at github.com/esteban-eg-kim/hivemux/issues, email hello@hivemux.dev, or reach the maintainer on X or Threads (@xkorfun).
Can I check on sessions from my phone or another Mac?
Use Remote Control in the Claude app on your phone, and hivemux connect to attach to another Mac's tmux over ssh and see its sessions in the same sidebar.
