Getting Started

imux is a native macOS command center built on Ghostty-grade terminal rendering. It combines terminal execution, file visibility, remote hosts, and update-aware release delivery in one workspace.

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-v1.10.3-macos.dmg https://www.iccjk.com/downloads/archive/v1.10.3/imux-v1.10.3-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

CLI setup

imux includes a compatibility command-line tool for automation. 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