TUI for easily running parallel coding agents

Quick start · How it works · Features · Configuration

amux is a terminal UI for running multiple coding agents in parallel with a workspace-first model that can import git worktrees.

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.

Each workspace tracks a repo checkout and its metadata. For local workflows, workspaces are typically backed by git worktrees on their own branches so agents work in isolation and you can merge changes back when done.

• 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-one tool: Run agents, view diffs, and access terminal

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"
  ]
}

Workspace metadata is stored in ~/.amux/workspaces/<workspace-id>/workspace.json and local worktree directories live under <repo>/.amux/workspaces/.

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