self-hosted · open source · MIT

Run dozens of agents.
One terminal. One control plane.

amux is the open-source control plane for AI coding agents. Spin up parallel Claude Code sessions, watch them from a web dashboard or your phone, and let agents coordinate work between themselves — with self-healing built in for the 3am crashes.

Try Cloud Free → View on GitHub Get the iOS App
~/dev — bash cmd · c 
# clone, install, register a project
$ git clone https://github.com/mixpeek/amux && cd amux && ./install.sh
$ amux register myproject --dir ~/Dev/myproject --yolo
$ amux start myproject
$ amux serve   # → https://localhost:8822
// Why amux

Multi-agent infra, without the duct tape.

If you're already running parallel coding agents from a stack of terminal windows, you've felt every one of these. amux fixes them in a single Python file.

Problem
amux's solution
Agents crash at 3am from context compaction
Self-healing watchdog — auto-compacts, restarts, replays the last message.
Can't monitor 10+ sessions from one place
Web dashboard — live status, token spend, peek into any session.
Agents duplicate work on the same task
Kanban board with atomic task claiming via SQLite CAS.
No way to manage agents from your phone
Mobile PWA + native iOS app — works anywhere, with offline support.
Agents can't coordinate with each other
REST API + channels — send messages, peek output, claim tasks across sessions.
No persistent knowledge between sessions
Shared notes & memory — markdown documents agents read and write across sessions.
// Dashboard

One pane of glass for the whole fleet.

Session cards, live terminal peek, kanban, notes, CRM, scheduler, files. Everything lives in a single Python file with inline HTML — clone it, edit it, deploy it.

• https://localhost:8822/sessions
workspace›sessions› all ⌈ K
Active
8 / 12
Tokens today
4.7M +612k cache
Spend (24h)
$18.40
Tasks shipped
23 this week
workingapi-refactor
Splitting auth middleware into per-route guards. Touching 14 files.
tmux:0•421k tok2m ago
needs inputmigrations
Drop legacy `users.role_id` column? Will require backfill from `permissions`.
tmux:1•198k toknow
workingtest-gen-frontend
Generating Playwright e2e suite for checkout flow. 12 / 34 specs done.
tmux:2•1.1M tok4m ago
idledocs-sweep
Updated 8 README sections. Waiting for review on PR #482.
tmux:3•76k tok22m ago
workingscheduler-cron
Implementing `--every` flag with timezone-aware parsing.
tmux:4•312k tokjust now
idlebug-PROJ-219
Race condition in board claim — repro pending. /compact ran 3m ago.
tmux:5•540k tok3m ago
// Mobile

Run agents from your pocket.

An installable PWA for iOS and Android, plus a native iOS app on the App Store. Background Sync replays your commands when you reconnect.

Get the iOS App
9:41
a
Sessions 8 ACTIVE · 12 TOTAL
tailnet
all working input idle
working api-refactor
Splitting auth middleware into per-route guards.
•421k2m
needs input migrations
Drop legacy users.role_id column? Will need backfill.
•198know
working test-gen-frontend
Generating Playwright suite for checkout. 12 / 34.
•1.1M4m
idle docs-sweep
Updated 8 README sections. PR #482 awaiting review.
•76k22m
Sessions
Board
Channels
Settings
9:41
«
api-refactor WORKING · 421K TOK
——— tmux peek · last 50 lines ———
• reading src/auth/middleware.ts
• reading src/routes/users.ts
✓ Found 4 routes using authMiddleware
Now extracting per-route guards…
↵ editing src/auth/guards/admin.ts
+ export const requireAdmin = ...
↵ editing src/routes/admin.ts
+ import { requireAdmin } from '../auth/guards'
✓ 14 files staged
• running tests…
PASS src/auth/guards/admin.test.ts
PASS src/routes/admin.test.ts
▌
send to session…
Sessions
Board
Channels
Settings
9:41
▤
Board 14 OPEN · 7 IN PROGRESS
todo doing review done
PROJ-12 claimed · api-refactor
Refactor auth middleware into per-route guards across 14 files
P1backend4h
PROJ-18 claimed · test-gen
Playwright e2e suite for checkout flow
P2frontend2h
PROJ-21 claimed · scheduler-cron
Add --every flag to amux scheduler with TZ parsing
P2cli1h
PROJ-25 unclaimed
Migrate notes index to FTS5
P3backend
Sessions
Board
Channels
Settings
// Agent ↔ agent

Agents that talk to each other.

Every session exposes a REST API. Agents discover peers, send tasks, peek terminals, and atomically claim board items — coordinating fleets of dozens without a human in the loop.

The full API reference is dropped into each agent's global memory at startup, so plain-English orchestration just works: “ask worker-2 to add tests for the changes I just made.”

orchestration.sh 
# Send a task to another session
$ curl -sk -X POST \
    -H 'Content-Type: application/json' \
    -d '{"text":"implement /login and report back"}' \
    $AMUX_URL/api/sessions/worker-1/send

# Atomically claim a board item
$ curl -sk -X POST $AMUX_URL/api/board/PROJ-5/claim
{"ok":true,"claimed_by":"worker-2"}

# Watch another session's output
$ curl -sk "$AMUX_URL/api/sessions/worker-1/peek?lines=50"
// Everything inside

Batteries included. No external services.

amux ships with the workspace tools an agent fleet needs — and nothing more. Every feature lives in the same single Python file.

01

Self-healing watchdog

Monitors context %, restarts on corruption, replays the last message, unblocks stuck prompts. Designed for unattended overnight runs.

02

Parallel sessions

Run dozens of agents at once. Each gets a UUID that survives stop/start. Conversation fork clones history onto a new branch in one command.

03

Agent orchestration

REST API + shared global memory. Agents discover peers, delegate work, claim tasks, and coordinate via channels with @mentions.

04

Kanban board

SQLite-backed with auto-generated keys, atomic CAS claiming, custom columns, and iCal sync. No two agents pick up the same ticket.

05

Notes & CRM

Markdown notes with rich editor and find-in-page. Contacts, companies, interaction logs, and follow-up tracking — all readable to agents.

06

Scheduler

Named cron-style recurring jobs with a built-in management UI. Run agents on a schedule — daily reviews, nightly test sweeps, hourly triage.

07

Browser automation

Shared Playwright instance with saved auth profiles, screenshots, and an AI agent mode for tasks that need a real browser.

08

Skills & slash commands

Project-level commands like /commit or /review-pr that any agent can invoke. Define once, share across the fleet.

09

Single-file architecture

One Python file with inline HTML/CSS/JS. No build step. No dependencies. Edit and save — it restarts itself. Audit the whole thing in an afternoon.

// ship at night

Stop babysitting one agent.
Start running the fleet.

Self-host the open-source build, or skip the setup and try amux Cloud free for 14 days.

Try Cloud Free → View on GitHub Get the iOS App