# Install tmuxp with Homebrew, apt, Nix, pacman Tmux session manager. Built on libtmux. Version 1.74.0 via Homebrew; verified 2026-07-05. ## Install ```sh sudo av install brew:tmuxp ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install tmuxp ``` Evidence: local Homebrew formula metadata ### Linux - Debian apt (92%): ```sh sudo apt install python3-tmuxp ``` Evidence: Debian stable package indexes: python3-tmuxp from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz - Nix (92%): ```sh nix profile install nixpkgs#tmuxp ``` Evidence: nixpkgs package indexes: pkgs/by-name/tm/tmuxp/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - pacman (92%): ```sh sudo pacman -S tmuxp ``` Evidence: Arch Linux sync databases: tmuxp from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz ## Package facts - **Package key:** brew:tmuxp - **Package manager:** Homebrew - **Package manager page:** - **Version:** 1.74.0 - **Source summary:** Tmux session manager. Built on libtmux - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Last updated:** 2026-07-05T16:18:52Z - **Generated:** 2026-07-08T18:08:21+00:00 ## Executables - tmuxp (cli) - tmuxp (alias) ## Dependencies - libyaml - python@3.14 - tmux ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 1.74.0 - Package-manager updated: 2026-07-05 - Local data: ok - Upstream repository: https://tmuxp.git-pull.com/ - info: Release/tag comparison is only available for GitHub repositories. ## Project history and usage tmuxp is a Python tmux session manager that saves and loads workspaces from YAML or JSON files. It is built on libtmux and presents tmux sessions, windows, and panes as a programmable Python-backed workspace rather than only as generated shell commands. ### Project history The official docs carry a 2013 copyright line for Tony Narlock, and the changelog records active public releases by the mid-2010s. Early tmuxp grew around loading declarative tmux layouts, then added tmux 2.0 support, environment expansion, multi-session loading, and named config loading. In 2016, the 1.0 release-candidate split core tmux APIs into libtmux and moved the project toward a cleaner library/CLI boundary. The project kept tracking tmux changes and Python packaging expectations. Later releases added OpenBSD support, XDG Base Directory support, a plugin system, `tmuxp shell`, workspace terminology, completion changes, and ongoing libtmux bumps for modern tmux versions. By 2026, its changelog shows tmux 3.7 support and feature parity flowing through libtmux while preserving YAML workspace compatibility. ### Adoption history tmuxp's README documents installation through pip, uv/uvx, Homebrew, Debian/Ubuntu, and Nix, and links to Repology for distribution versions. The supplied package facts additionally list Arch Linux packaging, so it has the kind of multi-channel packaging footprint that terminal users expect for infrastructure-adjacent CLI tools. Its adoption niche overlaps with tmuxinator but appeals to Python users and to people who want both declarative tmux workspaces and a Python API. The official docs explicitly compare tmuxp with tmuxinator and teamocil: all load sessions from config files, while tmuxp is Python, uses libtmux's ORM layer, supports JSON and YAML, and can freeze running sessions back to config. ### How it is used The normal workflow is to write a YAML or JSON workspace, run `tmuxp load`, and let tmuxp create sessions, windows, panes, layouts, working directories, and shell commands. It can also load projects by directory when `.tmuxp.yaml` or `.tmuxp.json` is present, load multiple sessions, start detached, and freeze an existing tmux session into a config file. tmuxp also imports tmuxinator and teamocil style configs, making it useful when migrating between tmux session managers. Its `tmuxp shell` command opens a Python console preloaded with libtmux server/session/window objects, which makes it attractive to users who debug or automate tmux from Python. ### Why package nerds care For package nerds, tmuxp is the Pythonic counterpart to Ruby-based tmuxinator. It matters because it packages tmux layouts as portable config files, exposes the same state through libtmux, and keeps compatibility with package-manager installation paths and shell completion workflows. The project is also a useful case study in how CLI tools survive changing platform layers: its changelog repeatedly tracks tmux version support, Python version support, Click/completion behavior, XDG paths, and distro packaging needs. ### Timeline - 2013: Official docs copyright begins for Tony Narlock. - 2015: 0.8.0 added tmux 2.0 support and command API cleanup. - 2016: 1.0.0-rc1 split core tmux APIs into libtmux and refreshed docs/tests. - 2016: 1.1.0 rewrote the CLI around Click and added config-name loading. - 2018: 1.5.0 added XDG Base Directory support. - 2021: 1.7.0 was the last Python 2.7 release and added stable plugin support. - 2022: 1.18.0 renamed config concepts toward workspace terminology and reorganized workspace modules. - 2026: 1.71.0 and 1.72.0 added tmux 3.7 support through newer libtmux releases. ### Related projects - Built on libtmux, the Python API layer for tmux. - Related to tmuxinator and teamocil as alternate tmux session managers whose config styles tmuxp can import. ### Sources - - - - - - input source_facts.package-manager ## Security Notes No matching local secret-handling manifest was found for tmuxp. Nucleus package metadata is still published here so future coverage has a stable package URL. ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** tmuxp - **Version Scheme:** 0 - **Revision:** 0 - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Other Package-Manager Records - Debian apt - python3-tmuxp - 1.55.0-1: normalized package name match | Debian stable package indexes: python3-tmuxp from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | tmux session manager (Python 3) | https://github.com/tony/tmuxp/ - Debian apt - tmuxp - 1.55.0-1: normalized package name match | Debian stable package indexes: tmuxp from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | tmux session manager | https://github.com/tony/tmuxp/ - Nix - tmuxp: normalized package name match | nixpkgs package indexes: pkgs/by-name/tm/tmuxp/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - Ubuntu apt - python3-tmuxp - 1.38.0-1ubuntu1: normalized package name match | Ubuntu 24.04 LTS package indexes: python3-tmuxp from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | tmux session manager (Python 3) | https://github.com/tony/tmuxp/ - Ubuntu apt - tmuxp - 1.38.0-1ubuntu1: normalized package name match | Ubuntu 24.04 LTS package indexes: tmuxp from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | tmux session manager | https://github.com/tony/tmuxp/ - pacman - tmuxp - 1.70.0-1: normalized package name match | Arch Linux sync databases: tmuxp from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Tmux session manager built on libtmux | https://tmuxp.git-pull.com/en/latest/ ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata. - [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew. - [tmux](https://www.automicvault.com/pkg/brew/tmux/) - Runtime dependency declared by Homebrew. - [sesh](https://www.automicvault.com/pkg/brew/sesh/) - Shares av.db curated category or tags: cli, developer-tools, session-manager, terminal, tmux. - [tmex](https://www.automicvault.com/pkg/brew/tmex/) - Shares av.db curated category or tags: cli, developer-tools, terminal, tmux. - [aha](https://www.automicvault.com/pkg/brew/aha/) - Shares av.db curated category or tags: cli, developer-tools, terminal. - [amtterm](https://www.automicvault.com/pkg/brew/amtterm/) - Shares av.db curated category or tags: cli, developer-tools, terminal. - [ansifilter](https://www.automicvault.com/pkg/brew/ansifilter/) - Shares av.db curated category or tags: cli, developer-tools, terminal. - [ccat](https://www.automicvault.com/pkg/brew/ccat/) - Shares av.db curated category or tags: cli, developer-tools, terminal. - [clive](https://www.automicvault.com/pkg/brew/clive/) - Shares av.db curated category or tags: cli, developer-tools, terminal. - [colordiff](https://www.automicvault.com/pkg/brew/colordiff/) - Shares av.db curated category or tags: cli, developer-tools, terminal. - [aoe](https://www.automicvault.com/pkg/brew/aoe/) - Local package facts share a topical domain. Shared terms: cli, developer, developer-tools, manager, session. - [gptline](https://www.automicvault.com/pkg/brew/gptline/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, developer, developer-tools, libyaml, python. ## Combined YAML source View the package source record on GitHub. [combined/tmuxp.yml](https://github.com/automic-vault/db/blob/main/combined/tmuxp.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph