amux

TUI for easily running parallel coding agents

Quick start · Features · Configuration · Development

What is amux?

amux is a terminal UI for running multiple coding agents in parallel with first-class support for git worktrees.

Quick start

curl -fsSL https://raw.githubusercontent.com/andyrewlee/amux/main/install.sh | sh

Or with Go:

go install github.com/andyrewlee/amux/cmd/amux@latest

Then run amux to open the dashboard.

Features

• Parallel agents: Launch multiple agents within main repo and within workspaces
• No wrappers: Works with Claude Code, Codex, Gemini, Amp, OpenCode, and Droid
• Keyboard + mouse: Can be operated with just the keyboard or with a mouse
• All-in-on tool: Run agents, view diffs, and access terminal

Configuration

Create .amux/workspaces.json in your project to run setup commands for new workspaces:

{
  "setup-workspace": [
    "npm install",
    "cp $ROOT_WORKSPACE_PATH/.env.local .env.local"
  ]
}

Workspaces are stored in ~/.amux/workspaces/<project>/.

Development

git clone https://github.com/andyrewlee/amux.git
cd amux
make run

Release

The release workflow is tag-driven. Pushing a tag like v0.0.5 triggers the GitHub Actions release job.

Fast path:

make release VERSION=v0.0.5

Manual steps:

make release-check
git tag -a v0.0.5 -m "v0.0.5"
git push origin v0.0.5