rux

A bare bones tmux session manager written in Rust.

Commands

• rux connect <name> — attach to a defined session
• rux list — list configured tmux sessions

Configuration

rux is configured via a config.toml file located at $XDG_CONFIG_HOME/rux/config.toml

Schema

[[session]]
name = "rux"
path = "~/projects/rux"

[[session.window]]
name = "editor"
path = "~/dir/path"
command = "nvim ."

[[session.window.pane]]
path = "~/other_dir/path"
command = "cargo test"

• All fields are optional except session.name.
• If a window has no pane entries, it defaults to a single pane inheriting the window's path and command.
• If panes are specified, the window-level command is ignored.

See config.toml for a full example.

Roadmap

• Cache session list with state-while-revalidate
• Support for built-in fzf-tmux picker
• Shell completions for bash, zsh, and fish
• rux save for saving current tmux session to rux.toml
• rux last for switching to the previous tmux session
• rux preview <name> for displaying session info to pipe into fuzzy-finders
• [default_session] for configuring for global startup command across sessions