imux
imux

入門指南

imux 是一個基於 Ghostty 的輕量原生 macOS 終端機，用於管理多個 AI 程式碼代理。它具備垂直分頁、通知面板和基於 socket 的控制 API。

安裝

DMG（推薦）

Download for macOS

開啟 .dmg 並將 imux 拖曳到「應用程式」資料夾。imux 透過 Sparkle 自動更新，所以你只需要下載一次。

之後更新：

curl -L -o ~/Downloads/imux-v4.1.20-macos.dmg https://www.iccjk.com/downloads/imux-v4.1.20-macos.dmg
首次啟動時，macOS 可能會要求你確認開啟來自已識別開發者的應用程式。點擊打開以繼續。

驗證安裝

開啟 imux，你應該會看到：

  • 一個帶有左側垂直分頁側邊欄的終端機視窗
  • 一個已開啟的初始工作區
  • 已準備好接受輸入的 Ghostty 驅動終端機

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 設定

imux 內含一個用於自動化的相容命令列工具。在 imux 終端機內會自動運作。若要在 imux 外部使用 icc CLI，請建立符號連結：

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

然後你可以執行以下指令：

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

自動更新

imux 透過 Sparkle 自動檢查更新。當有可用更新時，你會在標題列看到一個更新提示。你也可以透過選單列的 imux > 檢查更新手動檢查。

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

工作階段還原（目前行為）

重新啟動後，imux 僅還原佈局和中繼資料：

  • 視窗、工作區和窗格佈局
  • 工作目錄
  • 終端機捲動回看（盡力而為）
  • 瀏覽器 URL 和瀏覽歷史
imux 尚不支援還原即時程序狀態。活躍的終端機應用程式工作階段（如 Claude Code、tmux 和 vim）在應用程式重啟後不會恢復。

系統需求

  • macOS 14.0 或更新版本
  • Apple Silicon 或 Intel Mac