session

A tmux plugin for managing sessions.

Usage

session can be invoked directly from the shell:

usage: session [-h] [DIR]
A tmux plugin for managing sessions.
positional arguments:
 DIR starting directory (default: ~/projects)
options:
 -h, --help show this help message and exit

Or called from tmux, by specifying a keybind in your config:

bind-key f run-shell "tmux new-window /path/to/session"

As a nix package

Run ad-hoc using nix run:

nix run git+https://codeberg.org/tdback/session

Or add permanently in a NixOS module with flakes:

environment.systemPackages = [ inputs.session.packages.${system}.default ];

Importing

The utility provides simple wrappers for fzf and tmux, and can be imported into other Python scripts:

from session import Fzf
if __name__ == "__main__":
 fzf = Fzf()
 selection = fzf.select(["one", "two", "three"])
 print(selection)

Requirements

session depends on the following external programs:

• fzf
• tmux