Installation
pmux is a single binary with no runtime dependencies beyond tmux. It supports macOS and Linux on both arm64 and amd64 architectures.
Requirements
- tmux 3.x or later, installed and in PATH
- macOS (arm64, amd64) or Linux (arm64, amd64)
pmux requires tmux but does not bundle it. Install tmux via your system package manager if you don't have it.
Homebrew
brew install shiftinbits/tap/pmux
This is the preferred method for macOS and Linux systems with Homebrew. It handles updates automatically via brew upgrade.
Binary download
Pre-built binaries for each release are available on the GitHub Releases page.
Download the binary for your platform, make it executable, and move it into your PATH. For example, on macOS arm64:
curl -L -o pmux https://github.com/ShiftinBits/pmux-agent/releases/latest/download/pmux-darwin-arm64
chmod +x pmux
sudo mv pmux /usr/local/bin/
Replace darwin-arm64 with the appropriate platform suffix for your system: darwin-amd64, linux-arm64, or linux-amd64.
Verify installation
pmux --version
Expected output:
pmux version X.Y.Z
If the command is not found, confirm the binary location is in your PATH.
Next steps
Continue to Initialization to generate your identity and set up pmux.