imux
imux

Getting Started

imux 4.1.20 is a native macOS terminal-first AI command center on Ghostty-grade rendering for multi-agent work. Install once, pick a default operating path, and keep agents plus evidence on one surface — without claiming every VS Code IDE workflow.

Install

DMG (recommended)

Download for macOS

Open the .dmg and drag imux to your Applications folder. imux checks the website-hosted Sparkle feed automatically, so the direct download only needs to happen once.

Direct download:

curl -L -o ~/Downloads/imux-v4.1.20-macos.dmg https://www.iccjk.com/downloads/imux-v4.1.20-macos.dmg
On first launch, macOS may ask you to confirm opening an app from an identified developer. Click Open to proceed.

Verify installation

Open imux and you should see:

  • A terminal window with a vertical tab sidebar on the left
  • One initial workspace already open
  • The Ghostty-powered terminal ready for input

Pick a default path (important)

Do not open every surface on day one. Choose one primary path for the session:

  • Terminal agent CLI (recommended for power users): run Claude Code, Codex, Aider, or Cursor Agent CLI as real processes in the workspace terminal.
  • Agent Chat: streaming in-app LLM with @mentions, slash commands, and reviewable diffs (Cmd+Shift+L).
  • Supervisor: multi-panel orchestration after you have a one-sentence charter and done criteria — not the place to invent the goal.

Switch from VS Code or Cursor

Open the same git root you used before. Run agents, tests, remote hosts, browser checks, and Git evidence in imux as the daily driver. Use explorers and in-app edit for the full workbench loop without bouncing back to an Electron IDE.

CLI setup

imux includes a compatibility command-line tool for automation (product name imux; CLI remains icc). Inside imux terminals it works automatically. To use the icc CLI from outside imux, create a symlink:

sudo ln -sf "/Applications/icc.app/Contents/Resources/bin/icc" /usr/local/bin/icc

Then you can run commands like:

icc --help
icc notify --title "Build Complete" --body "Your build finished"

Auto-updates

imux checks for updates automatically via Sparkle. On launch and then hourly, the app probes the website-hosted appcast. When an update is available you’ll see an update pill in the titlebar, and you can still check manually from the app menu.

https://www.iccjk.com/downloads/appcast.xml
https://www.iccjk.com/downloads/latest.json

Session restore (current behavior)

After relaunch, imux restores layout and metadata only:

  • Window, workspace, and pane layout
  • Working directories
  • Terminal scrollback (best effort)
  • Browser URL and navigation history
imux does not restore live process state yet. Active terminal app sessions such as Claude Code, tmux, and vim are not resumed after app restart.

Requirements

  • macOS 14.0 or later
  • Apple Silicon or Intel Mac