tuimux

tuimux is a full-screen Rust TUI for browsing and managing tmux sessions.

It gives you a fast dashboard to:

view sessions and nested windows in a tree
inspect session metadata and live pane output preview
create, attach, rename, and close sessions/windows from keybindings
export and restore session/window layouts

Preview Image

Features

3-panel layout:
- Left: session/window tree (collapsed by default)
- Right: details + live preview
- Bottom: color-coded keybinding help + status
Green-themed Ratatui interface
Resilient refresh behavior (handles empty/no-server cases)
Async preview capture worker so scrolling/navigation stays responsive
Session export/restore to a local JSON backup file

Requirements

Rust toolchain (stable)
tmux installed and available in PATH
Linux/macOS shell environment

Startup Behavior

If you launch tuimux from inside an existing tmux session, it will automatically detach that tmux client and relaunch itself outside tmux before showing the TUI. This prevents accidentally creating nested tmux sessions, so you do not need to manually detach first.

Install

From crates.io

cargo install tuimux

From this repository:

cargo install --git https://github.com/AlextheYounga/tuimux.git tuimux

Keybindings

Navigation:

Up / k: move selection up through visible rows
Down / j: move selection down through visible rows
Left / h: collapse selected session
Right / l: expand selected session
Enter: attach to selected session/window
Space: toggle expand/collapse
/: start filter mode (type to filter sessions/windows, Enter to apply, Esc to clear)
r: refresh sessions

Actions:

a: attach to selected session/window
s: create session
w: create window
n: rename selected session/window
x: close selected session/window (with confirmation)
E: export all sessions/windows to ~/.config/tuimux/tuimux-sessions.json
R: restore sessions/windows from ~/.config/tuimux/tuimux-sessions.json (skips existing sessions)

Quit: