tsm/README.md

40 lines
983 B
Markdown
Raw Normal View History

2023-09-05 13:36:33 -05:00
# Tmux session manager (tsm)
## Install
There are pre-built binaries available in [Releases](https://github.com/daylinmorgan/tsm/releases/) including a [nightly](https://github.com/daylinmorgan/tsm/releases/tag/nightly) release.
w/`eget`:
```sh
eget daylinmorgan/tsm
eget daylinmorgan/tsm --pre-release # for nightly build
```
w/`nimble`:
```sh
nimble install https://github.com/daylinmorgan/tsm
```
## Usage
To configure `tsm` export the environment variable `TSM_DIRS`, with a colon-delimited set of parent directories to find projects.
For example in your rc file:
```sh
export TSM_DIRS="$HOME/projects/personal:$HOME/projects/work"
```
To make full use of `tsm` you should also add a new key binding to your `tmux.conf`.
2023-10-02 12:18:43 -05:00
For example you can bind the f key to show a popup with `tsm`:
2023-09-05 13:36:33 -05:00
```sh
2023-10-02 12:18:43 -05:00
bind f display-popup \
2023-09-05 13:36:33 -05:00
-h 60% -w 60% \
-E "tsm"
```
## Prior Art
- [ThePrimeagen](https://github.com/ThePrimeagen/.dotfiles/blob/master/bin/.local/scripts/tmux-sessionizer)