amux

🥈Silver

Amux is a TUI for managing and running parallel coding agents. It benefits developers and operations teams by simplifying the orchestration of multiple AI agents. It connects to various coding agents like Claude, Codex, and Gemini, streamlining workflows in software development and operations.

8710Updated 2mo ago

Intermediate30min to implementautomation

Saves ~45 min per use

Quick InstallView Source

git clone https://github.com/andyrewlee/amux.git

Works with:

Claude

Overview

About This Skill

Amux is a terminal user interface that simplifies running multiple coding agents in parallel within isolated workspaces backed by git worktrees. It works with popular coding agents including Claude Code, Codex, Gemini, Amp, OpenCode, and Droid without requiring wrappers or modifications. Each agent runs in its own tmux session for terminal isolation and persistence, allowing developers to launch multiple agents simultaneously and merge changes back when ready. The tool supports both keyboard and mouse control, includes diff viewing, and provides terminal access—all within a single interface. It's ideal for development teams and operations staff who need to orchestrate multiple AI agents across different branches or contexts.

How to Use

Install amux via Homebrew (`brew tap andyrewlee/amux && brew install amux`), Go, or the install script. Run `amux` to open the dashboard. Configure workspaces by creating `.amux/workspaces.json` in your project with setup, run, and archive commands. Amux requires tmux 3.2 or later and is supported on Linux and macOS.

Use Cases

Run multiple coding agents on different branches simultaneously for parallel development

Manage isolated workspaces with git worktrees for agent collaboration

View and compare diffs across multiple agent outputs in one interface

Orchestrate agents with custom setup, run, and archive commands per project

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

git clone https://github.com/andyrewlee/amux

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

I'm a developer working at [COMPANY] in the [INDUSTRY] sector. I need to automate [SPECIFIC TASK] using Amux. Here's the [DATA] I have available. Can you help me set up and run parallel coding agents to accomplish this?

Example Output

# Amux Setup for Automated Code Review

## Configuration
- **Agents**: Claude, Codex
- **Task**: Automated code review for Python scripts
- **Data**: Repository: `git@github.com:company/repo.git`

## Execution Plan
1. Clone repository
2. Run static analysis with Pylint
3. Generate code review comments
4. Consolidate findings

## Expected Output
- Detailed code review report
- List of critical issues
- Suggested improvements

## Notes
- Focus on security vulnerabilities
- Prioritize performance optimizations