tmux-clever-history 1.0.0

Better tmux history navigation — toggle between N unique entries

tmux-clever-history

Keep track of tmux window history and provide navigate them.

Unreviewed AI-generate code. However I use it.

Motivations

Toggle is great. But sometimes you want to toggle between three things. Also... I might like to do something really clever in the future

Alternatives and prior work

tmux has a build in last-window function to select the last window. You can implement something similar with tmux itself.

I found a project called tmux-history-stack, but it was written in bash and didn't have commands to go back two tabs.

Installation

pipx install tmux-clever-history

Add the following to your tmux.conf

set-hook -g after-select-window "run-shell 'tmux-clever-history hook #{last_window_id}'"

Usage

Add this to your tmux.conf

bind-key h run-shell "tmux-clever-history 1" # go to previous item, place current window in hisotry
bind-key H run-shell "tmux-clever-history --unique 1 2" # to to second most recent tab, pace previous item in history

Improvements

If you want to vibe code an improvement in a nice way. Release it as tmux-clever-history-whatever, open an issue on github and tell me what features you added.