入門指南

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

安裝

DMG(推薦)

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

之後更新:

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

驗證安裝

開啟 imux,你應該會看到:

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

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