I built a terminal multiplexer for coding agents that works on my phone

Description and use

swe-mux consolidates coding agent management into a single terminal multiplexer with status indicators, markdown notes, and phone access.

Problem

Managing multiple coding agents (Claude Code, Codex, etc.) was hampered by fragmented terminals, hung processes, unclear agent status, and lack of phone-friendly interfaces.

Outcome

swe-mux unifies agent management, provides real-time status, markdown notes, and phone access, enabling continuous development from any device.

Workflow

• Install swe-mux via uv or pipx
• Start swe-mux daemon (swe-mux on Windows, swemux start elsewhere)
• Connect to sessions from desktop or phone via Tailscale PWA
• Use terminal panes for agents, notes, files, dev-server previews
• Configure status alerts and push notifications
• Use prompt queue to avoid interrupting agents
• Send messages between sessions for multi-provider workflows
• Update swe-mux frequently without killing sessions

Evidence

I run a lot of coding agents at once, mostly Claude Code and Codex, across several projects.

Source

The problems were everything around them: too many windows, agents leaving hung processes behind, no way to tell which one was waiting on me, and having to remote into my desktop or SSH into a single shell to deal with any of it from my phone.

Source

I built swe-mux.

Source

It runs any shell or CLI in real terminals on your own machine and serves the same live sessions to your desktop and your phone.

Source

The same sessions, over your own Tailscale network, installed as a PWA.

Source

A separate supervisor process owns the terminals, so the daemon can restart and the app can update underneath them without killing anything.

Source

Install with uv tool install swe-mux (or pipx install swe-mux), then run swe-mux on Windows or swemux start elsewhere.

Source