imuximux
AI workbench for macOS

imux Mobile

imux Mobile 是远程编码伴侣：手机发任务与审批；Mac 或 Windows imux 执行。Bundle com.imux.mobile。从 https://www.clavue.com/mobile#imux 经 latest-imux-mobile.json 安装。手机从不在本地跑 shell — 仅云中继，无需 Tailscale 或 VPN。

安装

使用 imux Mobile 区块与清单 — 不要在此安装 Clavue Mobile 构建。

# Hub
https://www.clavue.com/mobile#imux

# Manifest (imux Mobile only)
https://www.clavue.com/downloads/mobile/latest-imux-mobile.json

# Bundle ID
com.imux.mobile

与桌面 imux 配对

两侧使用同一 Clavue 账户。桌面须运行协议 2 并显示 Online，手机任务才会执行。

  • macOS — 设置 → imux Mobile → 允许手机控制 → 显示配对码（QR / 8 位 / imux://pair 深链）
  • Windows — 设置 → imux Mobile · phone link → 同样流程
  • 手机 — imux Mobile → 配对主机 → 输入码或打开深链
  • 每台 Mac/Windows 主机重复配对（受账户设备上限）
  • 主机徽章显示 Mac/Win；协议 ≥ 2 时显示 Ready · p2

能做什么

主循环是多主机、多工作区、多终端 — 不只是 Agent Chat。

  • 列出桌面投影的工作区与终端表面
  • 向选定终端注入 CLI/TUI 按键（target: terminal）
  • 运行带审批的 Agent Chat 任务（target: agent）
  • 在手机上批准/拒绝待处理工具写入
  • 看见 Mac 投影的 CI/PR 提案卡（这轮只读）
  • 保持桌面唤醒 — 手机列出离线主机但无法在其上执行

提案卡

Mac 把未决提案卡投影到手机。卡的 schema 与 IDE 收件箱相同。批准仍在 Mac 上做 — 这轮没有手机决定接口。

imux Mobile 不是什么

imux Mobile 是桌面 imux 的远程控制面 — 不是 Clavue 会员手机 App。

  • 不是 Clavue Mobile — Chat/Imagine/Discover 为 com.clavue.xw
  • 不是本地 shell — 手机仅为控制面
  • 不是 GUI Phone Mirror — 该路径为 Clavue GUI + Clavue Mobile
  • 不是 Mac IDE — com.icc.app DMG 来自 iccjk.com / /download

连接模型

经 www.clavue.com 会员 devices/tasks API 云中继。无 Tailscale、无 VPN、Mac 无需开放入站端口。

故障排除

配对与协议版本不匹配是最常见的手机联机失败原因。

  • 主机显示旧协议 — 先升级桌面 imux，再升级手机 App
  • 配对失败 — 切换允许手机控制；重新生成配对码
  • 任务不执行 — 确认主机 Online 且同一 Clavue 账户
  • 装错 App — latest-imux-mobile.json 与 latest-mobile.json 勿混

下一步