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

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

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
• 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