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 worktrees
• 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/worktrees.json in your project to run setup commands for new worktrees:

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

Worktrees are stored in ~/.amux/worktrees/<project>/.

Development

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