tmuxp
Session manager for tmux, which allows users to save and load tmux sessions through simple configuration files.
Decision gist · record as of 2026-08-14
Yes. tmuxp is actively maintained, has no known vulnerabilities, low install friction, and solves a real problem for anyone using tmux regularly. The MIT license is permissive. Install it if you find yourself recreating the same tmux layouts repeatedly or want to version-control your terminal workspace configuration.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires tmux 3.2+ to be installed on your system; tmuxp is a Python wrapper around tmux, not a replacement for it.
- Low install friction; pure Python wheel with only two runtime dependencies (libtmux and pyyaml).
- Actively maintained with a recent release and no known vulnerabilities.
License · maintenance · safety
MIT (permissive) — MIT license is permissive; you can use, modify, and distribute tmuxp with minimal restrictions, making it suitable for both personal and commercial projects.
last release 2026-07-04 (41 days) · last repo commit 2026-08-13 · 4,558 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 136,558 downloads/mo, #11,393 on PyPI
Alternatives
Verify before relying
pip install tmuxp
# Create mysession.yaml with your tmux layout, then:
tmuxp load ./mysession.yaml
# Or load from user config directory:
tmuxp load mysession- Whether the plugin system is documented well enough for typical extension use cases.
- Performance characteristics when loading sessions with many panes or complex shell commands.
What it is and what it does
tmuxp is a command-line session manager for tmux that lets you define terminal workspaces in YAML or JSON files and load them reproducibly. Instead of manually creating windows, panes, and running commands each time, you write a configuration file once describing your layout, shell commands, and working directories, then restore the entire session with a single command. It wraps the libtmux library and supports multiple configuration formats, including tmuxinator and teamocil styles.
The tool is useful for developers who work with consistent terminal setups—development environments, monitoring dashboards, or multi-service local testing rigs. It also includes utilities to freeze (snapshot) running sessions, convert between YAML and JSON formats, and a Python shell for interactive tmux manipulation. You can load sessions in the background, run pre-load hooks for setup scripts, and organize configs in standard directories like ~/.config/tmuxp/.
Use it for
- Restore a multi-window development environment (editor, build, logs, tests) with one command after restarting.
- Define and share a standard tmux layout for a project so all team members start with the same pane setup.
- Automate local infrastructure testing by loading sessions with panes running different services in parallel.
- Snapshot a running tmux session's layout and pane commands, then replay it later or in a different context.
- Bootstrap a project workspace by combining session loading with pre-load hooks that install dependencies.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
tmuxp is actively maintained, has no known vulnerabilities, low install friction, and solves a real problem for anyone using tmux regularly. The MIT license is permissive. Install it if you find yourself recreating the same tmux layouts repeatedly or want to version-control your terminal workspace configuration.
Install
tmuxp on PyPI
Before you install
Low install friction; pure Python wheel with only two runtime dependencies (libtmux and pyyaml). Actively maintained with a recent release and no known vulnerabilities.
Requires tmux 3.2+ to be installed on your system; tmuxp is a Python wrapper around tmux, not a replacement for it.
License in practice
MIT license is permissive; you can use, modify, and distribute tmuxp with minimal restrictions, making it suitable for both personal and commercial projects.
Quickstart
pip install tmuxp
# Create mysession.yaml with your tmux layout, then:
tmuxp load ./mysession.yaml
# Or load from user config directory:
tmuxp load mysessionVerify before relying
- Whether the plugin system is documented well enough for typical extension use cases.
- Performance characteristics when loading sessions with many panes or complex shell commands.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release <4.0,>=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 2 packageslibtmuxpyyaml |
| Maintenance | Actively maintained 41 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 136,558 / month, #11,393 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableEnvironment :: Web EnvironmentIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseOperating System :: MacOS :: MacOS XOperating System :: POSIXProgramming Language :: PythonProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: Implementation :: PyPyTopic :: System :: ShellsTopic :: Utilities |
Evidence: tmuxp-1.74.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “tmux session manager”
- tmuxptmuxp saves and loads tmux sessions from YAML or JSON configuration…
- libtmuxlibtmux provides a typed Python API to control tmux (the terminal…
- pairmuxpairmux lets AI agents control interactive terminal programs through…
Give your agent the search over MCP, or paste the wish link into any chat.
More Utilities packages
Converts domain names between Unicode and ASCII-compatible encoding (Punycode) according to IDNA 2008 and Unicode Technical Standard 46, with security validation and broader script coverage than the standard library.
Install it if you work with internationalized domain names, need to validate domains, or use HTTP clients that depend on it transitively.
Detects and normalizes text encoding from unknown or ambiguous sources, supporting all IANA character sets that Python's core library provides codecs for, with the ability to register custom codecs.
Setuptools is a Python build backend and package management tool that handles building, distributing, and installing Python packages, including support for C/C++ extension modules.
Pluggy provides a plugin system that lets you define hook specifications and register implementations to be called in sequence, enabling extensible Python applications without tight coupling.
Install it if you're building an extensible application or framework.
Pygments is a syntax highlighter that colorizes source code and text in over 500 languages and formats, outputting to HTML, LaTeX, RTF, SVG, images, or ANSI terminal sequences.
Install it if you need to display or transform source code.
Six provides utility functions to write Python code that runs on both Python 2.7 and Python 3.3+, smoothing over language differences between the two versions.
See also libtmux · pairmux · iterm2 · imgcat · textual-image · textual-dev · textual-serve · asciinema · jupyter-server-terminals · yamlfix