t - the smart tmux session manager

tmux is a powerful tool, but dealing with sessions can be painful. This script makes it easy to create and switch tmux sessions:

Prerequisites

tmux
zoxide
fzf (>=0.35.0)
fd (optional)

How to install

1. Install tpm plugin

This script can be installed with the Tmux Plugin Manager (tpm).

Add the following line to your ~/.tmux.conf file:

set -g @plugin 'joshmedeski/t-smart-tmux-session-manager'

2. Add to path

To use the t script from anywhere, select your shell environment and follow the instructions.

Note: you'll need to check the path of your tpm plugins. It may be ~/.tmux/plugins or ~/.config/tmux/plugins depending on where your tmux.conf is located.

bash

Add the following line to ~/.bashrc

# ~/.tmux/plugins
export PATH=$HOME/.tmux/plugins/t-smart-tmux-session-manager/bin:$PATH
# ~/.config/tmux/plugins
export PATH=$HOME/.config/tmux/plugins/t-smart-tmux-session-manager/bin:$PATH

zsh

Add the following line to ~/.zprofile

# ~/.tmux/plugins
export PATH=$HOME/.tmux/plugins/t-smart-tmux-session-manager/bin:$PATH
# ~/.config/tmux/plugins
export PATH=$HOME/.config/tmux/plugins/t-smart-tmux-session-manager/bin:$PATH

fish

Add the following line to ~/.config/fish/config.fish

# ~/.tmux/plugins
fish_add_path $HOME/.tmux/plugins/t-smart-tmux-session-manager/bin
# ~/.config/tmux/plugins
fish_add_path $HOME/.config/tmux/plugins/t-smart-tmux-session-manager/bin

How to use

Run interactive mode
    t
    ctrl-a list tmux sessions and zoxide results (default)
    ctrl-s list only tmux sessions
    ctrl-z list only zoxide results
    ctrl-d list directories

Go to session (matches tmux session, zoxide result, or path)
    t {name}

Open popup (while in tmux)
    <prefix>+T"

Show help
    t -h
    t --help

By default, this plugin is bound to <prefix>+T which triggers a fzf-tmux popup that display zoxide results. Type the result you want and when you hit enter it will create a tmux session and connect to it or, if the sessions already exists, switch to it.

If you are not in tmux, you can simply run t to start the interactive script, or call t {name} to jump directly to a session of your choosing.

Key Bindings

ctrl-a list tmux sessions and zoxide results (default)
ctrl-s list only tmux sessions
ctrl-z list only zoxide results
ctrl-d list directories (or find if fd isn't installed)

You can learn more about how the script works in this video.

Callendor/t-smart-tmux-session-manager