imuximux
AI workbench for macOS

imux IDE

imux 是 Clavue 平台上的原生工作台。各类 agent（Claude Code、Codex、Clavue、Grok CLI 等）以真实进程运行；imux 提供窗格、Git 可见证据、浏览器验收与 Mission Control，一体化 AppKit 应用。

安装

从下载站获取已签名 DMG，拖入「应用程序」后启动。Sparkle 负责稳定版自动更新。

# Optional CLI on PATH
sudo ln -sf "/Applications/imux.app/Contents/Resources/bin/icc" /usr/local/bin/icc
icc --version

核心表面

一个工作区 = 一个项目或远程主机。其内组合窗格与面板。

  • 终端 — Ghostty 驱动，多窗格分屏
  • Agent Chat — 多会话标签、官方模型、可审阅 diff
  • 资源管理器 / SCM — 文件与 Git 状态，无需离开工作台
  • 浏览器自动化 — 与终端同一套定位模型
  • 监督器 / Mission Control — 目标、舰队、验收谓词
  • 收件箱提案卡 — CI/PR 吐卡后停；在 Mac 上决定

CI / PR 提案卡

侧栏 checks 变红，或当前分支 PR 已绿时，监督器吐出一张可批的卡然后停。不会默默再转一轮。手机能看见这张卡；批准、驳回、延后在 Mac 上做。

  • IDE 收件箱与 imux Mobile 同一 schema：imux.proposed-action.v1
  • v1 读已拉到的侧栏 checks，不是 GitHub webhook
  • 任务 runPhase 是排队 / 已领取 / 运行中，与 status 并列

IDE 中的官方模型

Agent Chat 使用官方 Clavue 模型时，与网页 Chat、API 共用会员额度。通过设备码或关联会话登录。本地 CLI agent（Claude/Codex/Grok）使用各自鉴权。

多会话对话

自 5.0.23 起，对话顶栏始终显示 Cursor 风格标签条：切换、关闭（×）、新建（+）。运行中会话显示 spinner；其他标签用未读点标记。

首次使用

安装后打开项目文件夹，创建第一个工作区。Agent Chat 中的官方 Clavue 模型与网页 Chat、API 共用同一账户与额度。

  • Cmd+T — 新建工作区（项目或远程主机）
  • Cmd+Shift+L — 在当前工作区打开 Agent Chat
  • Agent Chat → 提供商选择 → Official Clavue — 走会员额度
  • macOS 更新 — 通过 www.iccjk.com 的 latest.json / appcast Sparkle 推送
  • Windows IDE — 独立 0.2.x 通道，见 latest.json → downloads.windows（非 Mac Sparkle 源）

imux 不是什么

imux 是原生 IDE 与指挥中心（com.icc.app）。它不是 Clavue 家族手机应用，也不是独立的 Clavue GUI 工作台。

  • 不是 Clavue GUI — GUI 为 com.clavue.gui，Tauri 桌面 agent 工作台，见 /gui
  • 不是 imux Mobile — 手机遥控为 com.imux.mobile，见 /mobile#imux；手机不在本地跑 shell
  • 不是网页 Chat — 浏览器对话在 chat.clavue.com；见 /docs/chat-web
  • 不是 Clavue Bot — 多员工 bot 与云端电脑在 /bot/

故障排除

多数 IDE 问题是鉴权、额度或版本过旧。先在 www.clavue.com 账户 → 用量 确认，再排查本地应用。

  • Agent Chat 402 / 额度 — 升级套餐或等待池重置；与 Chat、API 同一套池
  • 官方模型不可用 — 在 设置 → 账户 用设备码登录
  • Sparkle 显示最新但缺功能 — 确认 /download 的 Mac 正式构建，而非旧 debug tag
  • Windows — 确认从 /download 的 Windows 通道安装，而非 Mac DMG

下一步