Metadata-Version: 2.4
Name: tmux-clever-history
Version: 1.0.0
Summary: Better tmux history navigation — toggle between N unique entries
License: MIT
License-File: LICENSE
Requires-Python: >=3.10
Description-Content-Type: text/markdown

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