tmuxp
Session manager for tmux that loads and freezes sessions from YAML or JSON workspace files, built on libtmux.
tmuxp is a session manager for tmux. It builds tmux sessions from declarative workspace files written in YAML or JSON, including tmuxinator and teamocil style configs. A file defines the session name, windows, layouts, panes, and the commands each pane runs, plus a shell_command_before entry that runs first in every pane. It is built on the libtmux Python library and supports tmux 3.2+ and Python 3.10+.
The main command is tmuxp load, which accepts a file path, a project directory containing .tmuxp.yaml or .tmuxp.json, or a bare name resolved against user config directories ($TMUXP_CONFIGDIR, $XDG_CONFIG_HOME, or ~/.tmuxp/). It can load several sessions at once in the background and offer to attach to the last one. Other options include -s to name a session, -d to load detached, and --log-file to write debug output. A before_script hook can run a startup script, such as installing project dependencies, before the session loads.
Other commands cover the rest of the workflow. tmuxp freeze snapshots a running session's layout, pane paths, and window and session names. tmuxp convert converts a workspace file between YAML and JSON. tmuxp shell opens a Python console preloaded with the libtmux server, session, window, and pane objects. It supports breakpoint() and one-off commands via -c. tmuxp debug-info collects system details for bug reports, and a plugin system allows custom behavior. It suits developers who want reproducible tmux project environments, and Python users who want to script tmux.
Installation
# via Homebrew
brew install tmuxp
# via apt
sudo apt install tmuxp
# via pip
pip install --user tmuxp
Alternatives & related tools
thefuck
Command-line error correction tool that suggests and fixes typos in previously executed shell commands
HSTR
Shell history TUI suggest box for bash and zsh that searches, navigates, and manages command history, with bookmarking of favorite commands.
X-CMD
Shell toolkit with command modules, on-demand CLI packages, completions, themes, and AI service integrations.
pet
Command-line snippet manager written in Go. Save, tag, search, and run shell command snippets with parameters, stored in TOML and synced via Gist or GitLab.
vivid
Generates LS_COLORS values from YAML filetype databases and color themes, for ls, tree, fd, bfs, dust and other tools.
add a badge to your README
Maintain tmuxp? Show that it's featured on trmn. The badge links back to this page.
[](https://www.trmn.sh/tools/tmuxp?utm_source=badge)<a href="https://www.trmn.sh/tools/tmuxp?utm_source=badge"><img src="https://www.trmn.sh/badge/tmuxp.svg" alt="Featured on trmn" height="20"></a>