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

• 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

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

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.

From crates.io

cargo install tuimux

From this repository:

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

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:

• q, Esc, or Ctrl-C