# 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
## 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
```bash
cargo install tuimux
```
From this repository:
```bash
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:
- `q`, `Esc`, or `Ctrl-C`