by mixpeek
Open-source control plane for AI coding agents — run, monitor & orchestrate dozens of parallel Claude Code, Codex & Gemini sessions from one web dashboard or your phone. Self-healing, single-file, tmux-native.
# Add to your Claude Code skills
git clone https://github.com/mixpeek/amuxLast scanned: 5/30/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-05-30T15:37:34.459Z",
"npmAuditRan": true,
"pipAuditRan": true
}amux is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by mixpeek. Open-source control plane for AI coding agents — run, monitor & orchestrate dozens of parallel Claude Code, Codex & Gemini sessions from one web dashboard or your phone. Self-healing, single-file, tmux-native. It has 293 GitHub stars.
Yes. amux passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/mixpeek/amux" and add it to your Claude Code skills directory (see the Installation section above).
amux is primarily written in HTML. It is open-source under mixpeek on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh amux against similar tools.
No comments yet. Be the first to share your thoughts!
Open-source control plane for AI agents. Run dozens of parallel agent sessions from your browser or phone — with a web dashboard, kanban board, notes, CRM, email, browser automation, slash-command skills, and agent-to-agent orchestration. Self-healing, single-file, zero external dependencies. Works with Claude Code, Codex, and Gemini CLI via tmux.
amux.io · Getting started · FAQ · Blog
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
Requirements: Python 3.10+, tmux 3.2+, and at least one of: Claude Code, Codex CLI, or Gemini CLI.
License: MIT + Commons Clause — free to use, modify, and self-host. Commercial resale requires a separate license.
amux alert "..." fires an in-app push and an iMessage/SMS to the owner. A fire alarm any session can pull; configured in Settings → Alerts.amux tunnel start 3000). Your machine dials out, so there's no inbound port to open. Requires an amux cloud subscription.done/verified, preventing the failure mode of marking work done before it's confirmed in production.| Problem | amux's solution |
|---|---|
| Claude Code crashes at 3am from context compaction | Self-healing watchdog — auto-compacts, restarts, replays 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 (SQLite CAS) |
| No way to manage agents from your phone | Mobile PWA + native iOS app — works anywhere, offline support |
| Agents can't coordinate with each other | REST API orchestration — send messages, peek output, claim tasks between sessions |
| Agents operate in a vacuum — no shared context | Channels — 1:1 inter-session chat with @mentions so agents can coordinate in real time |
| No persistent knowledge between sessions | Notes — markdown documents agents can read, write, and reference across sessions |
| No way to automate recurring work | Scheduler — named cron-style recurring jobs with built-in management UI |
/commit, /review-pr) that agents can invokeParses ANSI-stripped tmux output — no hooks, no patches, no modifications to Claude Code.
| Condition | Action |
|---|---|
| Context < 50% | Sends /compact (5-min cooldown) |
redacted_thinking … cannot be modified |
Restarts + replays last message |
Stuck waiting + CC_AUTO_CONTINUE=1 |
Auto-responds based on prompt type |
| YOLO session + safety prompt | Auto-answers (never fires on model questions) |
/rate-limit-options (any session, fleet-wide) |
Auto-presses 1, records reset time, auto-resumes at reset |
When a single Max/Pro account's usage cap is hit, every active Claude Code
session on that account blocks at the same /rate-limit-options prompt
within seconds. amux's watchdog detects this fleet-wide, presses option 1
("Stop and wait for limit to reset") on each blocked session, parses the
reset time from the surrounding scrollback, and steers a resume message
to every still-parked session once the reset time passes.
The dashboard shows a per-session "Rate-limited until HH:MM" badge plus a header pill summarizing the fleet ("N of M rate-limited, reset HH:MM").
Per-session resume text — set CC_RATE_LIMIT_RESUME_TEXT in
~/.amux/sessions/<name>.env to override the default continue. Useful
for orchestrators or supervisors that need a richer resume prompt:
echo 'CC_RATE_LIMIT_RESUME_TEXT="peek workers, surface phase STOPs, resume monitoring"' \
>> ~/.amux/sessions/orchestrator.env
Fleet auto-resume mode — set AMUX_RATE_LIMIT_MODE in
~/.amux/server.env:
| Mode | Behavior |
|---|---|
off |
Detect prompt and press 1, but do NOT auto-resume — user must steer manually |
capped (default) |
Auto-resume up to AMUX_RATE_LIMIT_BUDGET times per session per UTC day (default 3); fall back to manual after the cap |
unlimited |
Auto-resume every time, no cap |
A user who manually intervenes on a rate-limited session (picks option 2/3, types something new, archives it) is detected at reset time via a state-aware scrollback check, and auto-resume is skipped for that session.
Manual verification: install the feature on a development server, then inject a fake prompt into a test session's tmux scrollback:
tmux send-keys