imuximux
AI workbench for macOS

imux IDE

imux is the native workbench on the Clavue platform. Agents (Claude Code, Codex, Clavue, Grok CLI, and more) run as real processes; imux gives you panes, Git-visible evidence, browser checks, and Mission Control in one AppKit app.

Install

Download the signed DMG from the download host, drag imux to Applications, and launch. Sparkle keeps stable builds current.

# Optional CLI on PATH
sudo ln -sf "/Applications/imux.app/Contents/Resources/bin/icc" /usr/local/bin/icc
icc --version

Core surfaces

One workspace = one project or remote host. Inside it you compose panes and panels.

  • Terminals — Ghostty-powered, multi-pane splits
  • Agent Chat — multi-session tabs, official models, reviewable diffs
  • Explorer / SCM — files and Git status without leaving the workbench
  • Browser automation — same targeting model as terminals
  • Supervisor / Mission Control — goals, fleet, verify predicates
  • Inbox proposed actions — CI/PR card, then stop; decide on the Mac

CI / PR proposed actions

When sidebar checks go red, or a current-branch PR is green, Supervisor emits an approvable card and stops. It does not start another silent loop. The phone can see the card; approve, dismiss, and defer happen on the Mac.

  • Same schema on IDE inbox and imux Mobile: imux.proposed-action.v1
  • v1 reads already-fetched sidebar checks — not a GitHub webhook
  • Task runPhase is queued / claimed / running beside status

Official models in the IDE

Agent Chat on official Clavue models uses the same membership quota as web Chat and API. Sign in via device code or linked session. Local CLI agents (Claude/Codex/Grok) use their own auth.

Multi-session chat

From 5.0.23, the chat header always shows a Cursor-style tab strip: switch, close (×), and new (+). Running sessions show a spinner; unread dots mark other tabs.

First run

After install, open a project folder and compose your first workspace. Official Clavue models in Agent Chat share the same account and quota as web Chat and API.

  • Cmd+T — new workspace (project or remote host)
  • Cmd+Shift+L — open Agent Chat in the current workspace
  • Agent Chat → provider picker → Official Clavue — uses membership quota
  • macOS updates — Sparkle from latest.json / appcast on www.iccjk.com
  • Windows IDE — separate 0.2.x channel from latest.json → downloads.windows (not the Mac Sparkle feed)

What imux is not

imux is the native IDE and command center (com.icc.app). It is not the Clavue family phone apps or the standalone Clavue GUI workbench.

  • Not Clavue GUI — GUI is com.clavue.gui, a Tauri desktop agent workbench at /gui
  • Not imux Mobile — phone remote control is com.imux.mobile at /mobile#imux; the phone does not run shell locally
  • Not web Chat — browser chat lives at chat.clavue.com; see /docs/chat-web
  • Not Clavue Bot — multi-staff bots + cloud PC at /bot/

Troubleshooting

Most IDE issues are auth, quota, or an outdated build. Check Account → Usage on www.clavue.com before blaming the local app.

  • Agent Chat 402 / quota — upgrade plan or wait for pool reset; same pools as Chat and API
  • Official models greyed out — sign in via device code under Settings → Account
  • Sparkle says up to date but feature missing — confirm Mac build from /download, not an old debug tag
  • Windows — confirm you installed from the Windows channel on /download, not the Mac DMG

Next