The open-source workspace for coding agents.
supermux runs Claude Code, Codex, and other coding agents on your own computer or server, many sessions at once, and lets you work with them from your desktop or phone.
$ curl -fsSL https://supermux.dev/install.sh | sh -s -- --native
A recorded supermux workspace, replayed: Claude Code, Codex, Grok and Antigravity in one split, each in its own git worktree.A recorded Grok session, replayed in the supermux phone layout. Recorded Oct 18, 2026 on a demo host; long waits are shortened.
Run many sessions at once
- Parallel sessions: Run as many agents as you need, each in its own git worktree.
- Know who needs you: Get notified when a session finishes or asks a question.
- Review before merge: Read the diff, comment inline to the agent, then merge, open a PR, or discard.
- Mix agents: Change the agent, model, reasoning level, or fast mode per session.
Shared memory across agents
Each agent CLI keeps what it learns to itself. supermux gives them one shared memory as Markdown files on your machine.
- Write once: Sessions save what they learn to a file per topic.
- Read everywhere: Every new session starts with the topic index, whichever agent runs it.
- Same for context: Set up instructions, skills, plugins, and MCP servers once for every agent.
~/.mux/domains/billing.md. A Codex session started afterwards reads the note and writes .env.example. Recorded on the demo host; long waits are shortened.Editor, terminal, and ports on every device
The same workspace runs on desktop, tablet, and phone.
- Code editor: Edit any file with syntax highlighting, search, and language-server completion.
- Terminal: Open a full terminal in any workspace, with a key bar for phone keyboards.
- Expose ports: Turn any port on your machine into a private or public link.
- Files both ways: Send photos and files to a session, and get screenshots, documents, and videos back in the chat.
Keep going when you hit a usage limit
Move a Claude Code or Codex session that hits its limit to another account and continue.
Nothing to install first
Pick your agents and supermux installs their CLIs.
Also included
- Desktop and serverRun it on macOS, Windows, Linux, or a headless server, and see every machine's sessions in one app.
- Always onSessions survive closed laptops, dropped connections, and reboots.
- SearchFind any message across every chat on every machine.
- VoiceDictate into the composer and have replies read aloud.
Where your code and traffic go
Repositories, credentials, and session history stay on your machine.
Download
The first launch of a desktop app sets it up and shows a QR code. Scan it with the phone app.
v0.13.1 · Release notes
| Platform | File | SHA-256 |
|---|---|---|
| macOS Apple silicon | supermux-desktop-macos.dmg | |
| Windows x64 | supermux-windows.msi | |
| Linux x64 | supermux-linux.deb | |
| iPhone, iPad | App Store | |
| Android | supermux-android.apk |
Headless Linux and servers
$ curl -fsSL https://supermux.dev/install.sh | sh -s -- --native
Installs supermux as a user service and prints a pairing QR. x64 and arm64. Docker and source installs are in the setup guide.
Agent support
 Claude Code |
Codex | Cursor | OpenCode | Grok | Antigravity | |
|---|---|---|---|---|---|---|
| Parallel sessions, worktrees, review | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| Shared memory, skills, MCP | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| Installed and signed in by supermux | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| Multiple accounts | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| Auto-switch account on usage limit | ✓ | ✓ | – | – | – | – |
FAQ
- Is supermux an agent?
- No. It runs the agent CLIs you already use, like Claude Code and Codex, and it is where you work with them. It is not a cloud service either.
- Is it free?
- Yes. supermux is open source under the MIT license, and it runs on the agent subscriptions you already have.
- Can my team share one install?
- Not yet. Each install belongs to one person. Each teammate runs their own.
- Does Windows need WSL?
- No. The Windows app runs agents natively.