Isomux

Friction going from 1 Claude Code to 4+? Isomux is your agent office. Cute in a useful way.

Free · open source · no cloud · no account

See isomux.com for setup instructions and a live demo. Read the blog post for a deeper dive.

Feature Highlights

• Manage multiple agents with your existing Claude subscription (a visual alternative to tmux)
• Visual office metaphor: see what every agent is doing at a glance
  • undefinedAnimated characters: sleeping when idle, typing when working, waving when waiting for you
  • undefinedSkeuomorphic touchesundefined: click the moon to toggle dark mode, click doors to switch rooms, etc.
• undefinedMobile UIundefined: continue conversations on your phone with a touch-optimized interface
• Works locally or as a self-hosted persistent server (Mac Mini style):
  • Run at home, access from any device in your Tailscale network
  • No syncing headaches: same conversations, same filesystem, every device updates in real timeundefined
• undefinedEmbedded terminalundefined per agent
• undefinedVoice-to-text prompting and text-to-speech responses
• undefinedPre-tool-call safety hooksundefined: blocks dangerous commands like rm -rf
• undefinedCustom commandsundefined in addition to your own, all with autocomplete: e.g. /isomux-peer-review to review another agent’s work, or /isomux-all-hands to see what everyone is up to
• undefinedAgents can check on each otherundefined: inter-agent discovery via shared manifest
• undefinedShared task boardundefined: humans and agents can create, assign, claim, and close tasks — full interop via UI and HTTP API
• undefinedImage/PDF attachments: agents understand images and PDFs. Agents can show images inline in the conversation
• undefinedSound notifications: get pinged when an agent finishes

Get Started

1. Prerequisites

You need Bun (v1.2+) and the Claude Code CLI installed and authenticated with a Claude Pro or Max subscription.

# Install Bun
curl -fsSL https://bun.sh/install | bash

# Install Claude Code
npm install -g @anthropic-ai/claude-code

# Launch Claude Code, then type /login to authenticate
claude

2. Install & Run

git clone https://github.com/nmamano/isomux.git
cd isomux
bun install
bun run dev

3. Open

Visit http://localhost:4000 in your browser. Click an empty desk to spawn your first agent.

For persistent server setup (systemd + Tailscale) and voice input configuration, see isomux.com.

Full Feature List

Office View

• undefinedIsometric office with 8 desks — see all your agents at a glance
• undefinedName your agents — each gets a nametag on their desk
• undefinedUnique character per agent — customize hat, shirt, hair, accessory, or randomize
• undefinedAnimated characters — sleeping when idle, typing when working, waving when waiting for you
• Desk monitors glow based on agent state (green / purple / red)
• Status light with escalating warnings: amber at 2 min, red at 5 min
• Auto-generated conversation topic below nametag
• undefinedDrag agents between desks to rearrange
• Light / dark theme toggle

Agent Creation & Editing

• undefinedClick empty desk to spawn — name, working directory, permission mode, custom instructions
• Working directory input with recent CWD suggestionsundefined
• undefinedOutfit customization: color swatches, hat, accessory, randomize with live preview
• undefinedCustom instructions per agent, editable at spawn and later

Conversation View

• undefinedInput drafts preserved when switching between agents
• undefinedMarkdown rendering for agent output
• undefinedCollapsible thinking and tool-call cards with timing for each step
• undefinedCopy buttons on code blocks, user messages, full agent turns, and entire conversations
• undefinedSend disabled while agent is busy — type ahead freely, send when ready
• undefinedFile attachments: agents understand images and PDFs. Upload them via button, drag-and-drop, or paste
• undefinedImage display: agents can show images inline in the conversation
• undefinedEmbedded terminal for direct shell access per agent
• undefinedRight-click context menu — resume past sessions, edit agent, kill

Keyboard Shortcuts

• undefinedNumber keys 1–8 jump to agents from office view
• undefinedTab / Shift+Tab cycle between agents in chat view
• Escape returns to office
• undefinedCtrl+C to interrupt — cleanly aborts and lets you resume

Slash Commands & Autocomplete

• Built-in commands: /clear, /help, /cost, /context
• User skills from ~/.claude/skills/ and project commands
• undefinedBundled skills like /grill-me — available to every agent out of the box
• undefinedAutocomplete dropdown with keyboard navigation

Persistence & Lifecycle

• undefinedAgents persist across server restartsundefined
• undefinedAuto-resume last conversation on restart
• Agent manifest for inter-agent discoveryundefined
• undefinedResume past conversations from session files
• Kill removes agent and frees desk

Mobile Support

• undefinedOpen from your phone — same Tailscale URL, touch-optimized UI
• undefinedInstant sync — laptop and phone see the same state in real time over WebSocket
• undefinedAgent list view replaces isometric office on small screens
• undefinedFull conversation view with readable font sizes and two-row header
• undefinedSend & abort buttons for touch input
• Safe area insets for notch/home bar devices

Notifications

• undefinedSound notification when agent finishes and tab is unfocused
• undefinedActivity badge on desk when attention needed

System & Backend

• undefinedReal-time sync via WebSocket — every connected device stays in lockstep
• undefinedSingle Bun process — no bundler, no database, minimal deps
• Uses Claude subscription via CLI auth — no API key needed
• undefinedBuilt-in safety hooks — blocks rm -rf, git reset --hard, and other footguns out of the box
• undefinedWorks on a headless server — run on a Mac Mini or Linux box, access from anywhere via Tailscale