RafayGhafoor / t-smart-tmux-session-manager

t - the smart tmux session manager

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

3. Recommended tmux settings

I recommend you add these settings to your tmux.conf to have a better experience with this script.

bind-key x kill-pane # skip "kill-pane 1? (y/n)" prompt
set -g detach-on-destroy off  # don't exit from tmux when closing a session

4. Customize Prompt (optional)

If your terminal supports Nerd Font symbols, you can customize your prompt.

set -g @t-fzf-prompt '  '

Or you can replace the prompt with anything you'd like.

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-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.

Tasks

• Create tpm plugin
• Merge scripts and reduce logic
• Add docs
• Add help flag with basic documentation (t -h)
• List tmux sessions
• Use argument as directory fallback
• Add extra fd script
• Publish YouTube video on how to install it
• Save zoxide entries selected from t script (with sqlite?)
• Allow user to overwrite options (ex: set -g @t-smart-tmux-session-manager-options "-p --reverse)
• Add Neovim Telescope support?
• Add fzf preview support?
• Create Raycast plugin