✨Features

• Quickly save/restore/delete tmux sessions.
• Manually tweak session config files for better control.
• Manage sessions from the interactive TUI menu:
  • Use the keybindings to trigger actions (Save/Open/Edit/Delete).
  • Fuzzily find sessions (powered by fuzzy-matcher).
  • View the sessions structure in the preview panel.

⚡Requirements

• tmux >= v3.2 (recommended for the display-popup feature).

📦Installation

cargo install tsman

🚀Usage

Save current session

tsman save <session_name> # uses the specified name
tsman save # uses the current name of the session

Open a session

tsman open <session_name>

Edit a session config file

The file is opened for editing in $EDITOR.

tsman edit <session_name> # edit the config file of the specified session
tsman edit # edit the config file of the current session

Delete a session config file

tsman delete <session_name>

Open a menu that contains all saved sessions

tsman menu
tsman menu --preview # open the menu with the preview pane on
tsman menu --ask-for-confirmation # Open a confirmation popup when deleting

⌨️Menu keybindings:

Navigation:

Session actions:

UI Controls:

Confirmation Popup:

Help Popup:

🔧Configuration

You can add keybindings/aliases to your tmux/shell config file for faster usage.

Example config:

~/.tmux.conf:

# open menu in a tmux popup with preview pane and delete confirmation on
# note: requires tmux v3.2+
bind -r f display-popup -E -w 80% -h 80% "tsman menu -p -a"
bind -r C-s run-shell "tsman save"

~/.zshrc:

alias mux-fd="tsman menu -p -a"

If you want to set up a custom location to store session config files set the TSMAN_CONFIG_STORAGE_DIR env variable. You can add the following line to your shell config file to make it persistent:

export TSMAN_CONFIG_STORAGE_DIR="$HOME/mux-sessions"

🗒️Notes

• $EDITOR must be set to use the edit command.
• the session config files are saved by defult in ~/.config/.tsessions/.

🤝Contributing

• Please see CONTRIBUTING.md

🙏Acknowledgements

• tmuxinator
• ThePrimeagen's tmux-sessionizer