Tmux Session Manager

Installation

Zplugin

zplugin light "RobertAudi/tsm"

zplug

zplug "RobertAudi/tsm"

zgen

zgen load RobertAudi/tsm

Antigen

antigen bundle RobertAudi/tsm

As a plugin

$ source "tsm.plugin.zsh"

Manually

For a "stable" version:

• Put dist/bin/tsm in a directory in your $PATH
• Put dist/functions/_tsm in a directory in your $FPATH (optional)

For the latest version:

• Run make
• Put build/tsm in a directory in your $PATH
• Put share/zsh/_tsm in a directory in your $FPATH (optional)

Requirements

• tmux (Tested versions: 2.3)
• zsh (Tested versions: 5.2, 5.3)
• 256 colors support
• *nix (Tested OS: macOS Sierra 10.12)

Usage

$ tsm <command> [args...]

Configuration

• $TSM_HOME (default: $XDG_DATA_HOME/tsm)
• $TSM_SESSIONS_DIR (default: $TSM_HOME/sessions)
• $TSM_BACKUPS_DIR (default: $TSM_HOME/backups)
• $TSM_DEFAULT_SESSION_FILE (default: $TSM_HOME/default-session.txt)
• $TSM_BACKUPS_COUNT (default: 20)

Note: If $XDG_DATA_HOME is not set and the $TSM_HOME environment variable was not customized, $HOME/.local/share will be used as fallback.

Commands

• list
• show
• save
• restore
• resume
• quit
• backup
• cleanup
• help
• version
• edit
• remove
• copy
• duplicate
• rename
• migrate
• env

TODO

• Man pages
• Configuration file
• ASCII Art logo

Credits

• tmux-session by Mislav Marohnić (@mislav) was used as a starting point for this project.
• Lots of inspiration from zplug.

License

MIT