/tsm

Tmux Session Manager

Primary LanguageShellMIT LicenseMIT

Tmux Session Manager

Installation

zplugin light "RobertAudi/tsm"
zplug "RobertAudi/tsm"
zgen load RobertAudi/tsm
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

License

MIT