# 使用 Homebrew, apk, apt, Nix 安装 tmuxinator

查看 tmuxinator 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:tmuxinator
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install tmuxinator
```

  证据: local Homebrew formula metadata

### Linux

- apk (92%):

```sh
sudo apk add tmuxinator
```

  证据: 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
```

  证据: 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
```

  证据: nixpkgs package indexes: pkgs/by-name/tm/tmuxinator/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## 软件包事实

- **软件包键:** brew:tmuxinator
- **软件包管理器:** Homebrew
- **版本:** 3.4.1
- **来源摘要:** Manage complex tmux sessions easily
- **主页:** <https://github.com/tmuxinator/tmuxinator>
- **仓库:** <https://github.com/tmuxinator/tmuxinator>
- **最后更新:** 2026-07-03T15:53:53Z
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- tmuxinator (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 3.4.1
## 项目历史与用法

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.

### 项目历史

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.

### 采用历史

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.

### 使用方式

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.

### 为什么软件包爱好者会关心

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.

### 时间线

- 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.

### 来源

- <https://github.com/tmuxinator/tmuxinator#readme>
- <https://github.com/tmuxinator/tmuxinator/blob/master/CHANGELOG.md>
- <https://github.com/tmuxinator/tmuxinator/blob/master/LICENSE>
- input source_facts.package-manager


## 安全说明

narrow executable package without higher-risk signals.

- **Geiger 风险:** 绿色 / 低
- 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
## 其他软件包管理器记录

- 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.1-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.1-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.1-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.1-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


## Combined YAML source

View the package source record on GitHub. [combined/tmuxinator.yml](https://github.com/mxcl/pkgdb/blob/main/combined/tmuxinator.yml)


## 来源

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph