This project provides an open-source control plane for AI agents, specifically designed to multiplex and manage dozens of parallel Claude Code sessions using tmux. It targets developers and power users seeking to automate, orchestrate, and monitor AI coding agents efficiently, offering a significant productivity boost for tasks like parallel feature development, large-scale refactoring, and AI-driven testing.

How It Works

amux leverages tmux to create and manage independent agent sessions. A core self-healing watchdog monitors these sessions, automatically detecting and rectifying issues like context compaction failures, stuck prompts, and rate limits by restarting sessions or applying predefined actions. It facilitates agent-to-agent orchestration via a REST API and shared global memory, enabling complex workflows through features like a Kanban board for task management and real-time inter-session chat channels for coordination.

Quick Start & Requirements

• Primary install / run command:

  git clone https://github.com/mixpeek/amux && cd amux && ./install.sh
  amux serve # → https://localhost:8822
  

• Non-default prerequisites and dependencies: tmux, python3.
• Links: amux.io, Getting started, FAQ, Blog

Highlighted Details

• Self-healing: Automatically handles context compaction, restarts on corruption, and manages rate-limiting prompts.
• Parallel Agents: Supports running dozens of independent agent sessions, each with a persistent UUID.
• Orchestration: Features a REST API for inter-session communication, task delegation, and a Kanban board with atomic task claiming.
• Web Dashboard & Mobile PWA: Provides a browser-based dashboard for live status, terminal peeking, file exploration, and a mobile-optimized PWA with offline support.
• Single-file Architecture: The entire application is contained in a single Python file with inline HTML/CSS/JS, allowing for easy modification and automatic restarts on save.

Maintenance & Community

No specific details on maintainers, community channels (e.g., Discord/Slack), or roadmap were present in the provided README. The project is hosted on GitHub.

Licensing & Compatibility

• License type: MIT + Commons Clause.
• Compatibility notes: Free for use, modification, and self-hosting. Commercial resale requires a separate license. The project is local-first and designed for integration with Claude Code via tmux.

Limitations & Caveats

The project currently supports Claude Code via tmux; integration with other models or environments may require adaptation. It is local-first with no built-in authentication, necessitating careful network exposure management (e.g., using Tailscale or binding to localhost) to prevent unauthorized access to the dashboard. Mobile PWA functionality requires manual installation of a custom CA certificate for trust.