Mux – A tmux overlay for managing Claude Code sessions

Summary

Mux is a tmux overlay for people running several Claude Code sessions. It shows which session needs input and lets the user jump to that pane.

Running Claude Code in many tmux panes makes it easy to miss a blocked session waiting for input; this wastes time during agent-assisted coding.
tmux alone does not show Claude status, working directory, time in state, and a live pane preview in one view.

The core method is simple: read Claude Code's own status files and match them to live panes on the current tmux server.
It opens an fzf floating overlay inside tmux with one row per live Claude session.
Rows show status, tmux session, working directory, and minutes since the status changed.
It sorts rows by state so waiting sessions appear before working, idle, and unknown sessions; within each group, the longest-stuck session appears first.
Enter switches to the selected pane; ctrl-x sends a guarded SIGTERM to kill a Claude session.

The excerpt reports no benchmark, user study, latency, or adoption numbers.
It claims 1-key jump behavior: pressing Enter switches to the selected Claude pane, including panes in other tmux windows.
It refreshes the overlay and timers while open and reports time in state in minutes, with examples such as 2899m waiting and 304m waiting.
It limits the list to live Claude sessions on the current tmux server, so each row can be opened directly.
It exposes 5 subcommands: mux, mux list, mux preview , mux jump , and mux kill .
It requires 3 external tools for normal use: tmux, fzf, and jq, with fzf >= 0.38.