guillenotfound / 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 tmux sessions.

Prerequisites

• tmux
• zoxide
• fzf

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.

bash

Add the following line to ~/.bashrc

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

zsh

Add the following line to ~/.zprofile

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

fish

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

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

How to use

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.

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)
• 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?