sex is a session manager for the Rex terminal multiplexer, built on sesh.
It lists running Rex sessions together with the sessions defined in sesh.toml and the directories known to zoxide, creates a session when the selected one does not exist, and switches the Rex app to it.
sex takes config and zoxide entries from sesh list --json.
The Rex app must have Remote Control enabled (Settings, Rex Server) for the command line to switch sessions.
Run sex doctor to check the setup.
Release binaries for macOS and Linux are published on GitHub. With mise:
mise use -g github:rtuszik/sexFrom source:
go install github.com/rtuszik/sex/cmd/sex@latestWith Amber:
local amber = dofile(os.getenv("HOME") .. "/.local/share/rex/amber/amber.lua")
amber.setup({
plugins = {
{ "rtuszik/sex", opts = { host = "layer" } },
},
})
rex.bind("ctrl+b>shift+t", "sex_pick")
rex.bind("ctrl+b>shift+l", "sex_last")
rex.bind("ctrl+b>shift+a", "sex_activity")
rex.bind("ctrl+b>t", "sex_pick_palette")
rex.bind("ctrl+b>a", "sex_activity_palette")The sex binary must still be installed.
Then run rex config reload, rex do amber_install, and
rex config reload again.
The loader sits at lua/sex.lua with a setup(opts) function.
Any Rex plugin manager that loads lua/<name>.lua
and calls setup works.
Rex plugin
The plugin adds five actions to Rex: sex_pick opens the session picker in a floating layer, sex_activity opens the activity picker, and sex_last switches to the previously shown session.
sex_pick_palette and sex_activity_palette show the same lists in the Rex command palette, without fzf.
They have no preview and no picker keys. In sex_pick_palette, a typed name or path that is not in the list creates a session.
The palette needs a Rex server with API revision 17 or later (see rex version) and a Rex app that shows palette prompts.
sex plugin install adds sex.lua to $REX_CONFIG, $XDG_CONFIG_HOME/rex. (--path accepted)
Add the plugin loader to your rex.lua:
require("sex").setup()
rex.bind("ctrl+b>shift+t", "sex_pick")
rex.bind("ctrl+b>shift+l", "sex_last")
rex.bind("ctrl+b>shift+a", "sex_activity")
rex.bind("ctrl+b>t", "sex_pick_palette")
rex.bind("ctrl+b>a", "sex_activity_palette")Then run rex config reload. On rex config load/reload the loader runs
sex plugin --source, to ensure the plugin is kept up to date.
sex plugin --source prints the plugin itself.
setup accepts a table with these fields:
bin Path to sex. Default: $SEX_BIN, then the first sex found in
/opt/homebrew/bin, /usr/local/bin, ~/go/bin, ~/.local/bin, the
Nix profiles, and the mise and asdf shims. Rex does not run
commands with the PATH of an interactive shell.
host "layer" (default), "split", or "tab".
bounds Layer position { x, y, w, h } as fractions of the window.
Default: { 0.1, 0.1, 0.8, 0.8 }.
direction "horizontal" (default) or "vertical", for host = "split".
fzf_args Extra fzf options, appended after the defaults.
sex_last and the palette actions switch through the app and work without Remote Control.
sex_pick and sex_activity do not.
sex list [-r] [-c] [-z] [-i] [-H] [-j]
List Rex sessions (-r), sesh config sessions (-c), and zoxide
directories (-z); all three by default. -i adds source icons, -H hides
the session on screen, -j prints JSON.
sex connect [-b] [-p] [-c command] name
Switch to the session called name. If it does not exist, create it
from the matching config entry, zoxide entry, or directory. -b creates
the session without switching. -p prints the session ID. -c replaces
the startup command.
sex pick [-- fzf options]
Select a session with fzf and connect to it.
sex last [-p]
Switch to the session shown before the current one. -p prints its ID.
sex activity [-A] [-j]
List terminals whose programs report a status (OSC 7501), the data
behind Rex's Activity view. Blocked programs come first, then errors,
working, done, and idle. -A hides idle programs.
sex activity pick [-A] [-- fzf options]
Select a terminal from that list with fzf. sex focuses it and switches
the app to its session and tab.
sex preview name Print a session's screen or a directory preview.
sex kill name Destroy a running Rex session.
sex root Print the git root name of the current session.
sex doctor Check Rex, Remote Control, sesh, zoxide, and fzf.
sex plugin Print the Rex plugin loader.
The global option --client selects the Rex app to switch when more than
one is connected. It defaults to $REX_CLIENT, then to the only app.
In the picker, ctrl-a, ctrl-t, ctrl-g, and ctrl-x show all sources, Rex sessions, config sessions, and zoxide directories. ctrl-d destroys the selected Rex session. ctrl-/ toggles the preview. In the activity picker, ctrl-r reloads the list.
To use a different fzf command:
sex connect "$(sex list | fzf --preview 'sex preview {}')"Config sessions are hidden while a Rex session with the same name runs. zoxide directories are hidden while a Rex session runs in them.
Directories are named as sesh names them. Characters that tmux rejects, such
as . and :, are kept.
The windows of a config session become Rex tabs. The first tab runs the
startup command and keeps focus.
Rex does not record a session's directory. sex stores it in
$XDG_STATE_HOME/sex/state.json and falls back to the working directory of
the visible terminal for sessions it did not create.
sex last orders sessions by the time the app last sized their visible
terminal. This includes switches made from the Rex sidebar. The field is not
a documented Rex interface.
Inside Rex, sex pick reads the terminal background color (OSC 11) and
passes it to fzf.
sesh compatibility
sex reads config and zoxide entries through sesh list --json, so sesh
resolves these sesh.toml keys before sex sees them: [[session]] (name,
path, startup_command, preview_command, windows, disable_startup_command,
alias, icon), [[window]], [[wildcard]], [default_session], import,
blacklist, and sort_order. sex reads dir_length, git_dir_length,
git_namer_use_worktree_root, and name_substitution itself, from the main
sesh.toml only, as sesh does.
These keys behave differently:
cache sex list, sex pick, and sex preview use the sesh cache when
cache = true. sex connect always reads live data.
blacklist Also applied to Rex sessions.
sort_order Applies to config and zoxide entries. Rex sessions are always
listed first; the position of "tmux" is ignored.
[frecency] Used by sesh for the zoxide list. sex runs zoxide add and
zoxide query directly, so other backends are not used when
connecting.
alias Resolved by sex connect. alias_auto_connect and the [tui]
alias options belong to the sesh picker and have no effect.
[icons] Not used. sex shows its own source icons, or the icon of the
session or wildcard.
These keys have no effect: tmux_command, terminal, [tui], [browser],
[[worktree]], and the tmuxinator and tmuxp fields of [[session]].
The sesh commands window, worktree, clone, mkdir, and rename have no sex
equivalent. sex pick uses fzf instead of the sesh picker.
mise run build
mise run checkcheck runs golangci-lint, the tests, zizmor, and opengrep.
Open an issue at https://github.com/rtuszik/sex/issues. Include the output
of sex doctor and rex version.
sex is distributed under the MIT License. See LICENSE. The package
internal/namer is derived from sesh; its license is in
THIRD_PARTY_LICENSES.md.

