zainfathoni/amux

amux

amux is the local tmux lifecycle layer for Amp. It manages interactive workers, non-interactive runners, and named workspaces with explicit, agent-safe side effects.

• A worker is an interactive Amp client identified machine-wide by its canonical thread ID.
• A runner is an amp --no-tui client identified machine-wide by its canonical workdir. It enables Amp Agents Anywhere but does not own remote agent threads.
• A workspace groups workers and runners in one same-named tmux session.

Website: amux.zainf.dev · Skill guide: amux.zainf.dev/skill/

Install

Requirements: Amp CLI and tmux. Building from source also requires the Go version in go.mod.

Shell installer

Install the latest Linux or macOS release at the canonical self-updating path, ~/.local/bin/amux:

curl -fsSL https://amux.zainf.dev/install.sh | sh

The installer detects arm64/amd64, downloads the matching GitHub release archive and published checksum, verifies SHA-256, and atomically replaces the canonical binary. Any failure before that replacement leaves the existing binary untouched. It reports any PATH setup or shadowing and prints the exact amux install doctor command to run next.

For automation that needs a pinned release, set a published tag:

curl -fsSL https://amux.zainf.dev/install.sh | AMUX_VERSION=v0.2.1 sh

Homebrew

brew install zainfathoni/tap/amux
brew upgrade amux

Homebrew owns that installation. amux update deliberately refuses Homebrew, mise, asdf, Nix, and system-package paths.

Manual release fallback

If the shell installer cannot be used, release archives are available for Linux and macOS on amd64 and arm64. Select the matching archive, verify its separately published checksum, then install the binary at the canonical self-updating path. For example, on Linux amd64:

curl -LO https://github.com/zainfathoni/amux/releases/latest/download/amux-linux-amd64.tar.gz
curl -LO https://github.com/zainfathoni/amux/releases/latest/download/amux-linux-amd64.tar.gz.sha256
sha256sum -c amux-linux-amd64.tar.gz.sha256
tar -xzf amux-linux-amd64.tar.gz
install -D -m 0755 amux-linux-amd64/amux ~/.local/bin/amux