Amp Multiplexer for tmux

Restore agent workspaces without the ritual.

amux is a small CLI that restores named Amp workspaces inside tmux from a simple TSV file. Keep long-running agent threads organized, resumable, and one command away.

Download v0.1.0 View on GitHub
~/Code/amux 
$ amux launch mac Amp --dry-run
would create session Amp
would open window my-project

$ amux launch mac Amp
restored mac/Amp

$ amux doctor mac
OK config rows: 3
OK live tmux session matches config

Built for persistent agent work.

amux keeps the state you care about in boring text, then uses tmux and the Amp CLI to bring that state back when you need it.

Restore workspaces
Launch a named workspace into a tmux session with one window per configured Amp thread.
Store the current window
Pin or remove the tmux window you are already in without manually retyping its name or path.
Inspect drift
Use doctor to compare your TSV config with the live tmux session before trusting a restore.
Preview first
--dry-run validates inputs and reports intended tmux actions without mutating your workspace.
Spawn fresh threads
Create a new Amp thread in a real interactive tmux window and add it to your restore config.
Plain-text config
The restore contract is a simple TSV file that is easy to read, diff, back up, and sync.

A tiny contract you can understand.

The default config lives at ~/.config/amp-tmux/workspaces.tsv. Each row maps a workspace, a tmux window, a working directory, and an Amp thread.

Config format

workspace   window       workdir             thread
mac         my-project   ~/Code/my-project   T-example
mac         docs         ~/Code/docs         T-docs
1 StoreSave the current tmux window with amux store-current.
2 RestoreRun amux launch to recreate the workspace later.
3 VerifyRun amux doctor when live tmux state and config may have drifted.

Install it, try it, keep what works.

amux is intentionally small: a Go binary, tmux, Amp, and a text file. Start with a dry run, then let it restore the workspace you already use. 

$ curl -LO https://github.com/zainfathoni/amux/releases/download/v0.1.0/amux-v0.1.0-linux-amd64.tar.gz
$ tar -xzf amux-v0.1.0-linux-amd64.tar.gz
$ install -m 0755 amux-v0.1.0-linux-amd64/amux ~/.local/bin/amux