lazy-tmux

TUI picker

Actions are organized into color-coded modes. Type / to open the command palette, or use the shortcut for a mode directly. While a mode is active the whole frame recolors (red for delete, blue for rename, green for new, cyan for wake/sleep), the list is filtered to the targets that mode can act on, and Esc returns to the resting browse mode.

Claude status dots

For live sessions, windows running claude show a colored status glyph in the State column, so you can tell at a glance which Claude is busy and which one is waiting for you — without switching around. Each state has both a distinct shape and color, so it stays readable in monochrome terminals: ● green = working, ? amber = waiting for your answer to a question or permission, ◌ blue = waiting for input, ○ grey = idle. The glyphs refresh while the picker is open.

Working/idle is detected out of the box. For the precise “waiting for your answer” state, install the Claude Code hooks once: lazy-tmux claude-hooks (merges into ~/.claude/settings.json, preserving your existing hooks; lazy-tmux claude-hooks --uninstall removes them).

KeyAction
TypeFuzzy search sessions and windows.
/Open the command palette: /delete, /rename, /new, /wake, /sleep. Tab completes, Enter runs the highlighted command and enters its color-coded mode.
?Toggle a full keybinding cheat sheet (only when the search box is empty; any key closes it).
<C-j>Move down to the next selectable row.
<C-k>Move up to the previous selectable row.
EnterRestore the selected target — or, inside a mode, perform that mode's action.
EscCancel the active mode and return to browse; in browse mode, close the picker.
<C-c>, <C-q>Cancel and close the picker.
SpaceIn delete mode, mark or unmark the row under the cursor. Marking a session marks all of its windows, so a fully-marked session is deleted as a whole.
<C-d>Enter delete mode with the window under the cursor already marked.
<Alt-d>Enter delete mode with the whole session under the cursor marked.
<C-r>Enter rename mode on the window under the cursor.
<Alt-r>Enter rename mode on the session that owns the window under the cursor.
<C-n>Enter new mode to add a window to the session under the cursor.
<Alt-n>Enter new mode to create a fresh session.
<Alt-w>Enter wake mode (sleeping sessions only): restore a saved session that is not running.
<Alt-s>Enter sleep mode (live sessions only): save a running session's state and close it.

Author: Anton Grishin (alchemmist), anton.ingrish@gmail.com

OpenSource: alchemmist/lazy-tmux

© 2026 lazy-tmux