supermux

AFK. Still shipping.

supermux runs Claude Code, Codex, Cursor & OpenCode 24/7 on a box you own — every session, on every screen you carry.

$ curl -fsSL https://supermux.dev/install.sh | sh
Get started ↓ View on GitHub

MIT licensed · self-hosted · no vendor cloud · no account

supermux capabilities: push notifications, voice input with live waveform, inline diff comments, a git worktree per session, a real terminal, a code editor with file tree, a usage dashboard, Telegram and PWA clients, photos and camera input, shared memory, and live model switching.

the problem

Agents only work while you watch.

your laptop · today

09:14 $ claude · refactoring auth…

18:42 ⚠ lid closed — session killed

23:59 …nothing happened since

  • 5 hrsof evening, wasted
  • 1 difffinished, unseen
  • 1 questionblocking since 18:42

Walk away. They keep shipping. ↓

what changes

What changes for you

Never babysit

A push finds you when a worker finishes or asks. One tap opens that exact session.

Review from your phone

Read the diff, comment inline, merge — from the train.

Leave whenever

Sessions live on the box. Your laptop lid changes nothing.

Telegram built in

Same sessions, same pushes — in the chat app you already use.

Autonomous, not reckless

No permission prompts. Isolated worktrees, a dedicated box — and nothing merges unreviewed.

It learns your stack

Shared memory across sessions, an identity you write. Knowledge compounds instead of resetting.

product tour

Your window into every session

chat

A separate chat per session

An installable app, one thread per session. Voice with a live waveform, photos, camera — and push that stays quiet while you're already looking.

supermux chat: a worker session reporting progress in its own thread

review

Code review, pocket-sized

Every session gets its own git worktree. Read the full diff, drop inline comments, the agent fixes — main moves only on your word.

phone-sized git diff review with an inline comment on the changed line

workspace

A full workspace in the browser

File tree, editor, search. A real terminal in the session's directory. Rate limits and spend across every agent, one dashboard.

workspace — api-refactor
browser workspace: file tree, code editor on auth.ts, and a terminal running bun test

agents

Four agents, one interface

Same chat, same workspace, same orchestration. Pick the agent per session, switch models mid-session. If your subscription changes, your workflow doesn't.

Claude Code Codex Cursor OpenCode

models switch live, mid-session — no restart

how it works

How it works

One daemon, your keys. Credentials stay on your box; the broker runs every session with them.

Sessions that survive. Restart the broker, reboot the box — every session resumes with full history.

Yours, end to end. No vendor cloud, no account. Connect over LAN, VPN, or a tunnel — your call.

install

Install

One command. It asks Docker or native, then walks you through.

$ curl -fsSL https://supermux.dev/install.sh | sh

piping curl to sh makes you nervous? read the script — it's short, commented, and never sudos without asking.

Docker

Clone, compose up. Installs Docker itself if missing — the wizard handles the rest.

Native

Linux + tmux + bun. Optional systemd user service for the always-on box.

Guided

Paste SETUP.md into your agent — it installs supermux for you, even over SSH.

Requirements: Linux (or Docker anywhere) · tmux · at least one agent CLI logged in

Designed, built, and reviewed by agents running inside supermux — this page included. Steered from a tablet.

built with supermux