# Install tmuxinator with Homebrew, apk, apt, Nix Manage complex tmux sessions easily. Version 3.4.1 via Homebrew; verified 2026-07-03. ## Install ```sh sudo av install brew:tmuxinator ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install tmuxinator ``` Evidence: local Homebrew formula metadata ### Linux - apk (92%): ```sh sudo apk add tmuxinator ``` Evidence: Alpine Linux edge package indexes: tmuxinator from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz - Debian apt (92%): ```sh sudo apt install tmuxinator ``` Evidence: Debian stable package indexes: tmuxinator from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz - Nix (92%): ```sh nix profile install nixpkgs#tmuxinator ``` Evidence: nixpkgs package indexes: pkgs/by-name/tm/tmuxinator/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ## Package facts - **Package key:** brew:tmuxinator - **Package manager:** Homebrew - **Package manager page:** - **Version:** 3.4.1 - **Source summary:** Manage complex tmux sessions easily - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Last updated:** 2026-07-03T15:53:53Z - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - tmuxinator (cli) - tmuxinator (alias) ## Dependencies - ruby - tmux - tmuxinator-completion ## 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: 3.4.1 - Package-manager updated: 2026-07-03 - Local data: ok - Upstream repository: https://github.com/tmuxinator/tmuxinator - Upstream latest detected: v3.4.1 (current) ## Project history and usage Tmuxinator is one of the long-running tmux session managers. It lets users describe named tmux workspaces in YAML and then start, edit, list, debug, stop, or copy those workspaces from the command line. ### Project history The project dates to the early tmux adoption era: its license carries a 2010 copyright notice, and its changelog shows a progression from basic panes, pre commands, and project roots into a Ruby/Thor CLI with completions, hooks, local project configs, detached starts, per-window roots, ERB support, and support for new tmux releases. The README still states the core promise plainly: create and manage tmux sessions easily. The 0.6.0 rewrite was an important internal milestone, replacing early scripts with a more structured Ruby command-line application, tests, generated shell commands, and completion support. Later releases added local `.tmuxinator.yml` files, `stop`, `stop-all`, append starts, focused panes, XDG-aware config discovery, and repeated updates to the supported tmux version matrix as tmux 2.x and 3.x changed behavior. ### Adoption history Tmuxinator spread through RubyGems first, but the README also documents Homebrew installation and notes that distribution package managers may install shell completions automatically. The supplied package facts show broader packaging in Homebrew, Debian, Ubuntu, Alpine, and Nix, which is unusually wide coverage for a tmux workflow helper. Its adoption history tracks the habits of developers who keep a stable editor/server/logs layout per project. The default sample config in the README is Rails-flavored, and years of changelog entries around shell completions, tmux compatibility, XDG paths, hooks, and local configs reflect practical use in daily development shells. ### How it is used A common workflow is `tmuxinator new project`, editing the generated YAML, and then `tmuxinator start project` to create windows and panes with commands already placed or running. The README assumes users already understand tmux windows and panes and exposes config fields for roots, layouts, pane commands, project hooks, attach behavior, pane titles, tmux options, and custom tmux commands. Tmuxinator also became a diagnostic and maintenance tool for tmux layouts: `debug` prints generated shell commands, `doctor` checks for tmux, `$EDITOR`, and `$SHELL`, and `stop`/`stop-all` remove sessions created from configs. ### Why package nerds care For package nerds, Tmuxinator is a canonical example of a small Ruby CLI that became part of the terminal productivity stack. It sits at the intersection of dotfiles, shell completions, XDG config directories, Homebrew/RubyGems packaging, and tmux version compatibility. It is also historically useful as a reference point for later session managers: tmuxp explicitly supports tmuxinator-style configuration import, which shows how Tmuxinator's YAML workspace model became a recognizable format in the tmux ecosystem. ### Timeline - 2010: License copyright begins for Allen Bargi and Christopher Chow. - 0.2.0: Added pane support and RVM support. - 0.6.0: Core functionality rewritten around Thor, tests, debug output, and completion commands. - 0.7.0: Added detached starts, unnamed windows, per-project `.tmuxinator.yml`, and command-line args. - 0.10.0: Added project hooks and XDG/user configuration directory support. - 1.0.0: Added support for tmux 2.9. - 3.4.0: Added focused pane support and restored explicit open/edit commands. ### Related projects - Related to tmux as the underlying terminal multiplexer. - Related to tmuxp and teamocil as declarative tmux session managers; tmuxp documents import support for tmuxinator-style configs. ### Sources - - - - input source_facts.package-manager ## Security Notes narrow executable package without higher-risk signals. - **Geiger risk:** green / low - narrow executable package without higher-risk signals ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: ~/.tmuxinator/*.yml, ~/.config/tmuxinator/*.yml, ./.tmuxinator.yml ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** tmuxinator - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Debian apt - tmuxinator - 3.3.3-1: normalized package name match | Debian stable package indexes: tmuxinator from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Create and manage tmux sessions easily | https://github.com/tmuxinator/tmuxinator - Nix - tmuxinator: normalized package name match | nixpkgs package indexes: pkgs/by-name/tm/tmuxinator/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - Ubuntu apt - tmuxinator - 3.1.0-3: normalized package name match | Ubuntu 24.04 LTS package indexes: tmuxinator from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Create and manage tmux sessions easily | https://github.com/tmuxinator/tmuxinator - apk - tmuxinator - 3.4.0-r0: normalized package name match | Alpine Linux edge package indexes: tmuxinator from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | manage complex tmux sessions easily | https://github.com/tmuxinator/tmuxinator - apk - tmuxinator-bash-completion - 3.4.0-r0: normalized package name match | Alpine Linux edge package indexes: tmuxinator-bash-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Bash completions for tmuxinator | https://github.com/tmuxinator/tmuxinator - apk - tmuxinator-fish-completion - 3.4.0-r0: normalized package name match | Alpine Linux edge package indexes: tmuxinator-fish-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Fish completions for tmuxinator | https://github.com/tmuxinator/tmuxinator - apk - tmuxinator-zsh-completion - 3.4.0-r0: normalized package name match | Alpine Linux edge package indexes: tmuxinator-zsh-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Zsh completions for tmuxinator | https://github.com/tmuxinator/tmuxinator ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Package publisher tools](https://www.automicvault.com/pkg/package-publishers/) - Belongs to a package publishing or registry command family. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Language runtime packages](https://www.automicvault.com/pkg/language-runtime-packages/) - Matched language runtime, compiler, or interpreter metadata. - [ruby](https://www.automicvault.com/pkg/brew/ruby/) - Runtime dependency declared by Homebrew. - [tmux](https://www.automicvault.com/pkg/brew/tmux/) - Runtime dependency declared by Homebrew. - [tmux-sessionizer](https://www.automicvault.com/pkg/brew/tmux-sessionizer/) - Shares av.db curated category or tags: cli, productivity, session-management, terminal, tmux. - [byobu](https://www.automicvault.com/pkg/brew/byobu/) - Shares av.db curated category or tags: cli, productivity, session-management, terminal, tmux. - [smug](https://www.automicvault.com/pkg/brew/smug/) - Shares av.db curated category or tags: cli, productivity, terminal, tmux. - [wemux](https://www.automicvault.com/pkg/brew/wemux/) - Shares av.db curated category or tags: cli, productivity, terminal, tmux. - [cbonsai](https://www.automicvault.com/pkg/brew/cbonsai/) - Shares av.db curated category or tags: cli, productivity, terminal. - [eless](https://www.automicvault.com/pkg/brew/eless/) - Shares av.db curated category or tags: cli, productivity, terminal. - [nvimpager](https://www.automicvault.com/pkg/brew/nvimpager/) - Shares av.db curated category or tags: cli, productivity, terminal. - [page](https://www.automicvault.com/pkg/brew/page/) - Shares av.db curated category or tags: cli, productivity, terminal. ## Combined YAML source View the package source record on GitHub. [combined/tmuxinator.yml](https://github.com/automic-vault/db/blob/main/combined/tmuxinator.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - 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