A local workspace for the coding agents you already run

Run your coding agents together.
Know which ones need you.

Keep Claude Code, Codex and other coding agents side by side, with live status, flexible panes and messages between sessions. Work from your desktop or phone. Dictate prompts, hear replies, and ask the assistant what needs attention.

Real terminals. Persistent sessions. Your own machine and subscriptions.

$ uv tool install swe-mux

TRY THE INTERACTIVE DEMO

open demo ⤢
Try your keys Click a pane to try the keyboard. Browser shortcuts still apply.

The real interface with simulated agent activity. No install, account or provider connection. Open demo to try the terminal keyboard on a phone.

01

Know which agent needs you

See who is working, waiting for approval, or blocked. Notifications name the session and the reason, so you can respond without watching every pane.

Choose a sound and push notification for each event. Set quiet hours and separate Desktop and Mobile preferences. The alert history stays readable when delivery is muted. Status and alerts

Preview a notification sound Sound credits
02

Keep working from your phone

Use the terminal, review changes, edit files and respond to agents from the same workspace. Mobile has its own touch controls and layout, with your desktop arrangement kept intact.

  • The same sessions. Continue a conversation from either device. Input ownership keeps two devices from typing over each other.
  • The tools you use at your desk. Terminals, Git review, notes, files, prompt queues and previews.
  • Your preview travels with you. Open a local dev server through swe-mux without exposing another port.
  • Your own connection. Reach your machine over Tailscale. No swe-mux account or vendor-operated relay.

Connect your phone. HTTPS enables microphone and clipboard APIs; push also needs browser permission.

03

Talk to your agents. Ask the assistant.

Dictate a prompt, hear an agent reply, or ask which sessions need your attention. Voice works from desktop and phone, with separate controls for listening and playback.

Hear an assistant example

A recorded exchange using local Windows speech synthesis. The interactive example uses scripted messages.

Read the audio transcript

You: Mux, what needs my attention?

Assistant: One session is waiting for your decision about cache invalidation. Two other agents are working. Open the waiting session to read the question.

  • DictationSpeak into a draft and send it to an agent or text surface. Speech recognition runs on your host machine.
  • Read aloudListen to replies or spoken summaries. Choose which sessions generate speech and which device plays it.
  • The assistantAsk about your sessions and navigate by name. Actions follow the trust settings you choose; consequential actions require confirmation.

Voice is optional. Speech models download when requested. The assistant uses a configured model endpoint and your budget; experimental Edge speech is a separate opt-in. Voice setup

04

Keep the same editing habits across agents

Use familiar shortcuts across supported agent inputs. Shift+Enter inserts a new line, Ctrl+Backspace deletes a word, and clicking positions the cursor in recognized composers.

  • Your keymapChoose swe-mux, tmux, VS Code, Vim or Emacs shortcuts for workspace navigation. Try a preset in the desktop demo toolbar.
  • Image pastePaste a screenshot from your clipboard into an agent that supports image attachments. You can also attach a file.
  • Shared clipboard historyReuse text copied inside swe-mux from desktop or phone. Pin entries and optionally retain history across restarts.

Workspace keymaps and agent text editing are separate features. Browser-reserved shortcuts and individual CLI capabilities still apply. Clipboard history records in-app text copies; it does not synchronize the system clipboard. Keyboard reference

Watch an image attachment
See shared clipboard history
05

Arrange the work around you

Split agents, notes, files and previews into panes, with tabs inside each. Keep the code, conversation and running result in view together.

Run any shell, TUI or CLI in a real terminal. Recognized agents add status, transcripts and input support. The Markdown editor supports tables, code blocks and sending a selection to an agent. Workspace guide

06

Let agents coordinate

Sessions can exchange messages, read each other's progress and request help within the permissions you set. See who asked, what they requested and where the response went.

Messages can wait in a session's queue until it is ready. Spawn and control requests require approval by default. Project permissions govern what agents can read and do. Queues and communication

07

Land finished branches behind your checks

A branch takes its turn in the queue, updates from master, and runs the checks you approved. Passed checks allow a fast-forward; a conflict or failed check stops the request.

A failed request returns to the agent that owns the branch. An agent cannot approve its own verification command. Enable the required Project permissions before allowing agents to request landing. Try the failed-check walkthrough · Git and landing

Watch a failed check
08

Find the session. Inspect the work.

Search conversations across agent CLIs, reopen the transcript, and inspect the commands, changes and test results that were recorded. Resume earlier work with its context close at hand.

Optional evidence capture records observed tool activity and attributes commits to contributing sessions. It reports missing evidence rather than treating it as proof of success. History and auditing

09

Keep your sessions through an app restart

A separate supervisor holds the terminals while the daemon restarts or the app updates. Reconnect to the working sessions and their scrollback.

The supervisor cannot survive its own death or a power loss. Cold recovery restores affected sessions as readable, resumable records. Session recovery

  • Local dataProjects, history and settings live on your machine. No swe-mux account or usage telemetry.
  • Your providersAgent CLIs use your existing subscriptions. Optional model features use your endpoint and budget.
  • Optional automationEvidence capture, attention analysis and agent control have explicit Project permissions. Start with the workspace and enable what you use.

The update check fetches a static version manifest and can be disabled. See what crosses the network.

10

Install

You need at least one agent CLI already installed and logged in. swe-mux does not install, manage, or proxy them. It runs the ones you already have, on the subscription you already pay for.

Windows desktop app GitHub Releases

Get the installer or portable archive from GitHub Releases. Direct download details appear here when release metadata is available.

You can also use the Python install below for the same Windows window and tray.

Install with Python

Requires Python 3.12 or newer. The package includes the built interface; Node is not needed.

$ uv tool install swe-mux
$ swe-mux # Windows desktop app

pipx install swe-mux is the alternative isolated install. For a browser on Windows, Linux or macOS, run swemux start, then open 127.0.0.1:8765. swemux doctor reports installation and runtime health.

The Windows app includes its tray and native window. First-run setup offers shortcuts. Linux and macOS use the daemon with a browser. All three platforms have required CI checks, including a source-daemon smoke test; that does not replace testing a published release on a clean machine.

Installation, source builds and upgrades · Start your first session · Troubleshooting