入门指南

imux 是一款基于 Ghostty 级终端渲染构建的原生 macOS 指挥中心,把终端执行、文件可见性、远程主机和更新链路放进同一个工作区。

安装

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 自动探测一次网站托管的 appcast。发现新版本后,标题栏会显示更新提示,你也可以从应用菜单里手动检查。

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