Installation

Bash YOLO

curl -fsSL https://raw.githubusercontent.com/raine/workmux/main/scripts/install.sh | bash

Homebrew (macOS/Linux)

brew install raine/workmux/workmux

Cargo

Requires Rust. Install via rustup if you don't have it.

cargo install workmux

Nix

Requires Nix with flakes enabled.

nix profile install github:raine/workmux

Or try without installing:

nix run github:raine/workmux -- --help

See Nix guide for flake integration and home-manager setup.

---

For manual installation, see pre-built binaries.

Shell alias (recommended)

For faster typing, alias workmux to wm:

alias wm='workmux'

Add this to your .bashrc, .zshrc, or equivalent shell configuration file.

Shell completions

To enable tab completions for commands and branch names, add the following to your shell's configuration file.

Bash

# Add to ~/.bashrc
eval "$(workmux completions bash)"

Zsh

# Add to ~/.zshrc
eval "$(workmux completions zsh)"

Fish

# Add to ~/.config/fish/config.fish
workmux completions fish | source