amux is an open-source agent harness and session multiplexer developed by Mixpeek. Built in Rust, it is designed to manage, isolate, and orchestrate terminal-based AI coding sessions across multiple concurrent execution lanes and development environments. Operating directly from the command line, amux allows developers to launch and monitor persistent agent workflows. It handles session states, manages local execution boundaries, inspects session freshness, and coordinates interactions across local shell environments or containerized runtimes. Unlike standalone coding assistants that execute directly within a single shell prompt, amux functions as an orchestrator layer (similar to tmux for agents). It is designed to track agent sessions, supervise resource utilization like disk space, and prevent silent execution failures across concurrent AI tasks. amux is open-source under a public repository on GitHub. It is actively maintained with continuous integration covering Rust test suites, linting, and Docker-based containerized deployments.
Agent Session Multiplexing — Coordinates and tracks multiple concurrent AI coding agent sessions across isolated execution paths. - Rust-Based Core Engine — Provides a fast, native command-line binary with minimal runtime overhead. - Session Freshness & Path Verification — Inspects execution paths and active sessions to avoid stale CLI shadowing and silent binary mismatches. - Resource & Disk Guarding — Includes built-in monitoring mechanisms such as low-disk space alarms during long-running agent workloads. - Container & Cloud Readiness — Supports orchestration within local developer environments as well as Docker-based cloud container pipelines.
Use cases
Use Case: Managing Parallel Coding Agent Sessions A developer runs multiple automated agent tasks simultaneously on distinct branches or submodules. amux orchestrates these parallel lanes, maintaining session state and preventing process collisions in the local workspace.
Use Case: Supervised Headless Workflows A team runs long-running AI coding tasks in CI or containerized environments. amux monitors session health and disk usage thresholds, terminating or flagging agent runs that run out of space or produce silent failures.
Use Case: Multiplexed Agent Workspaces A developer needs a dedicated harness layer over terminal coding assistants (like Claude Code or custom agents) to multiplex terminal I/O, maintain persistent agent sessions, and track multi-session logs across local and cloud environments.
Who it is for
amux is intended for software engineers, DevOps practitioners, and AI tooling developers who orchestrate multiple concurrent CLI coding agent sessions and need harness-level process control. It is not suitable for developers looking for a turnkey, single-prompt GUI assistant or simple text-completion extension.
Install guide
Installation Clone the repository and build from source using standard Cargo tooling: bash git clone https://github.com/mixpeek/amux.git cd amux cargo build --release cp target/release/amux ~/.local/bin/ Ensure ~/.local/bin is in your PATH: bash export PATH="$HOME/.local/bin:$PATH"
First Run Verify that the binary is properly located and executable: bash amux --help
Example Session Start an orchestrated session or inspect active execution lanes: bash # Launch an agent session amux session start --name dev-refactor # List running sessions amux session list
Pi Boss — Pi Boss is an open-source multi-agent orchestration extension developed by skyfallsin for the pi terminal coding agent ecosystem. It provides…
Open Interpreter — Open Interpreter is an open-source terminal coding agent maintained by Killian Lucas and the Open Interpreter community. It is designed…
SWE-agent — SWE-agent is an open-source autonomous software engineering agent harness built and maintained by researchers from Princeton University and Stanford University.…
Claude Squad — Claude Squad is an open-source terminal user interface (TUI) orchestrator and multi-instance session harness for Claude coding agents, developed by…
Crush — Crush is an open-source terminal coding agent created by Charm (Charmbracelet), the team behind popular Go terminal UI libraries like…
Gemini CLI — Gemini CLI is an open-source terminal coding agent maintained under the Google Gemini organization (google-gemini/gemini-cli). It provides a command-line and…