amux

amux

TUI for running parallel coding agents with first class support for git worktrees.

Here are some reasons why you would use amux over others:

• Use coding agents directly (i.e. Claude Code, Codex). There's no new coding agent, wrapper, or SDK involved.
• Supports all of the major coding agents: Claude Code, Codex, Gemini, Amp, OpenCode, Droid, Cursor.
• Navigate with keyboard or mouse.
• Run it on the terminal.
• Open source.

Installation

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

Or with Go:

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

Quick Start

After installing, run amux in any git repository:

cd your-project
amux

Build from source

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

Setup Worktrees Script

The setup worktrees script allows you to configure commands that run when creating new worktrees. You can define setup commands in your .amux/worktrees.json file.

Example configuration:

{
  "setup-worktree": [
    "pnpm i",
    "cp $ROOT_WORKTREE_PATH/.env.local .env.local",
    "cp -r $ROOT_WORKTREE_PATH/.clerk ."
  ]
}

This will run the specified commands in each new worktree after creation. Worktrees are saved inside ~/.amux/worktrees/.