How it works#

Isomux runs as a single Bun process that manages persistent agent sessions — one per desk — across two backends: Claude (Claude Agent SDK) and Codex (Codex app-server).

A WebSocket layer keeps every connected device — and every connected user — in sync in real time. Open the same URL on your laptop, phone, and a friend's browser: all three see the same office, same conversations, same messages as they land.

Agent identities are saved to the local file system and persist across server restarts.

No API key needed. Isomux piggybacks on your existing Claude or Codex CLI authentication and inherits the skills you already have set up for those CLIs.

For a deeper dive, see the Design and Architecture blog post.