Isomux - The agent office to go from 1 Claude Code to 4+

Features

Office View

Isometric 2D office with 8 desks arranged in a 2×4 grid
Unique character per agent — fully customizable outfit (hat, shirt color, accessory)
Animated character poses per state: idle, working, waiting, error
Desk monitors glow based on agent state (green / amber / red)
Status light with escalating warnings: amber at 2min, red at 5min, inline abort button
Monitor preview showing latest agent output
Auto-generated conversation topic below nametag
Drag agents between desks to rearrange
Light / dark theme toggle

Agent Creation & Editing

Click empty desk to spawn — name, working directory, permission mode, custom instructions
Working directory autocomplete + browse + recent CWD suggestions
Outfit customization: color swatches, hat, accessory, randomize with live preview
Custom instructions per agent, editable at spawn and later

Conversation View

Input drafts persisted when navigating away
Markdown rendering for agent output
Collapsible thinking blocks and tool call cards with duration
Copy buttons on code blocks, user messages, full agent turns, and entire conversations
Messages blocked while agent busy to prevent loss
Embedded terminal for direct shell access per agent

Keyboard Shortcuts

Number keys 1–8 jump to agents from office view
Tab / Shift+Tab cycle between agents in chat view
Escape returns to office
Ctrl+C interrupts busy agent (clean abort + resume)

Slash Commands & Autocomplete

Built-in commands: /clear, /help, /cost, /context
User skills from ~/.claude/skills/ and project commands
Autocomplete dropdown with keyboard navigation

Persistence & Lifecycle

Agents persist across server restarts
Auto-resume last conversation on restart
Agent manifest for inter-agent discovery
Resume past conversations from session files
Kill removes agent and frees desk

Notifications

Sound notification when agent finishes and tab is unfocused
Activity badge on desk when attention needed

System & Backend

WebSocket-only communication — full state snapshot + incremental updates
Single Bun process, no Vite, no database
Uses Claude subscription via CLI auth — no API key needed
Global Claude skills and MCP servers inherited automatically
Safety hooks to protect config and block destructive commands

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

# Verify Claude Code is installed
claude --version

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.

Persistent Server Setup (Mac Mini style)

Run Isomux on a headless Mac Mini (or any always-on Linux box), access it from anywhere via Tailscale, and let your agents work while you sleep.

1. Create the systemd service

This auto-rebuilds the UI on each start and restarts on failure.

mkdir -p ~/.config/systemd/user

cat > ~/.config/systemd/user/isomux.service <<'EOF'
[Unit]
Description=Isomux - Isometric Office Manager
After=network.target

[Service]
Type=simple
WorkingDirectory=/home/YOUR_USER/isomux
ExecStartPre=/home/YOUR_USER/.bun/bin/bun run build:ui
ExecStart=/home/YOUR_USER/.bun/bin/bun run server/index.ts
Restart=always
RestartSec=3
Environment=PATH=/home/YOUR_USER/.bun/bin:/usr/local/bin:/usr/bin:/bin

[Install]
WantedBy=default.target
EOF

2. Enable and start

systemctl --user daemon-reload
systemctl --user enable --now isomux

# Check status
systemctl --user status isomux

3. Enable lingering

By default, systemd user services stop when you log out. Enable lingering so Isomux keeps running.

sudo loginctl enable-linger $USER

4. Set up Tailscale

Install Tailscale on both the server and your laptop/phone. Once connected, access Isomux at your machine's Tailscale IP.

curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up

# Find your Tailscale IP
tailscale ip -4

5. Access remotely

From any device on your Tailnet:

http://YOUR_TAILSCALE_IP:4000

Bonus: Use a Tailscale machine name

Instead of remembering an IP, rename your machine in the Tailscale admin console to something friendly:

http://my-mac-mini:4000