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.

Maintenance direction: amux's current lifecycle behavior remains implemented and supported, but orchestration framework expansion is frozen. New work is limited to critical fixes, safety-preserving cleanup, measurement, and gradual migration. Permanent per-machine Lead/coordinator threads are no longer the target architecture; new delegation should be bounded to the task that needs it and must prove lower coordination cost without reducing result quality. No command, schema, or runtime behavior is deprecated by this notice. See ADR 0004 for the evidence, scorecard, and phased retirement plan.

• 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: