Muxi

Create dynamic shortcuts for your tmux sessions!

Install

sh cargo install muxi

Usage

```sh ❯ muxi Create bookmarks for your tmux sessions on the fly! 🚀

Usage: muxi

Commands: init Register within Tmux and add bindings config See and edit your settings sessions See and manage your muxi sessions completions Generate completions for your shell fzf Spawn a FZF popup to manage your muxi sessions help Print this message or the help of the given subcommand(s)

Options: -h, --help Print help -V, --version Print version ```

Configuration

TOML

You can provide a settings.toml in one of the following locations:

$MUXI_CONFIG_PATH
$XDG_CONFIG_HOME/muxi/
~/.config/muxi/

Or run muxi config edit to open it in your favorite $EDITOR

```toml

Optional: Use tmux to define muxi's table (default: true)

tmux_prefix = true

Optional: Muxi's table binding (default: "g"), will result in `<prefix>g`

muxi_prefix = "g"

Optional: Uppercase letters will set the current session (default: false)

uppercase_overrides = false

Optional bindings to be created on tmux's muxi table (Examples shown)

[bindings]

ge => edit your sessions file (You can pass optional arguments to your editor after "--")

e = { popup = { title = " sessions " }, command = "muxi sessions edit -- +ZenMode" }

gc => edit config

c = { popup = { title = " config " }, command = "muxi config edit" }

gs => session switcher

s = { popup = { title = " muxi " }, command = "muxi sessions switch --interactive" }

gf => FZF integration

f = { command = "muxi fzf" }

gt => session switcher (native tmux menu)

t = { command = "muxi sessions switch --tmux-menu" }

You can bind your own commands too!

`tmux run-shell "tmux switch-client -l"`

M-Space = { command = "tmux switch-client -l" }

[bindings.g] command = "tmux send htop Enter"

[bindings.l]

popup = {

title = "optional title",

width = "60%", (default: 75%)

height = "60%", (default: 75%)

}

popup = { width = "75%", height = "60%" } command = "muxi sessions | less" ```

And start muxi in your tmux.conf:

tmux if "type muxi" { run -b "muxi init" }

Tmux variables

You can alternatively define settings entirely from your tmux config:

```tmux

Optional settings (default values shown)

set -g @muxi-use-tmux-prefix 'on' # on|off set -g @muxi-prefix 'g' # Any valid tmux key, like M-Space set -g @muxi-uppercase-overrides 'off' # on|off

Init muxi

if "type muxi" { # If you're going to define bindings on the muxi table, don't use -b run "muxi init" }

Define bindings on the muxi table:

ge => Edit sessions in your editor

bind -T muxi e popup -w 76% -h 75% -b rounded -T " sessions " -E "muxi sessions edit -- +ZenMode -c 'nmap q :wqa'"

TIP: Using the native tmux menu is a good alternative to the common workflow,

it'll map your session bindings to the menu

bind 'f' run 'muxi sessions switch --tmux-menu' ```

Sessions

Running muxi sessions edit will open your sessions.toml file, which should look something like the following: