Repository navigation
v0.2.4
English
Upgrade notes
- The control page and its
/mcpneed a login. Runiphone-control viewer tokenand open the link it prints. HTTP MCP clients sendAuthorization: Bearer <token>. The CLI and stdio MCP are unaffected (#79). - With
--lan, the page is HTTPS on the local network. Check the certificate fingerprint fromservice statusthe first time (#76). ICTL_AGENT_GATEandICTL_AGENT_TOKENare replaced byIPHONE_CONTROL_TASK_TOKEN(#64).
New
- AI tasks for any agent:
iphone-control task run -- <command>, steered withtask list,events,pause,resume,takeover,handback,stop,approveandreject(#64). - Limit a task to some apps with
task run --appor the App button on the control page. Anywhere else, each step waits for you (#69, #70). - An agent can't pause, approve or otherwise control its own task (#75).
- The control page picks up running tasks after a reload, including ones started elsewhere (#64).
viewer --lanopens the control page to the local network over HTTPS (#72, #76).- MCP over HTTP at
/mcpon the control page's port (#77). - Named and read-only login tokens:
viewer token add <name> [--read-only](#80). - Use another machine's phone:
mcp --urlbridges to its/mcp, andtask … --urlruns and controls tasks there (#80, #82). service viewer installruns the control page as a background service (#74).- Arrow-key setup menus, and shell completions with
iphone-control completions <shell>(#71).
Improvements
- Tasks are kept by the daemon. While one runs, other clients can look but not act (#64).
- The picture zooms only with its − / + buttons, not by pinching (#68).
Fixes
- Locking takes about 2 s instead of 10 s on some iPhones, and now works on iPads below iOS 27 (#59, #63).
- A WDA that still answers
/statusbut nothing else is restarted within about 30 s (#60, #62). - A failed lock says what each way of locking did, instead of "WDA just dropped" (#61).
- On iOS 27, system alerts missing from the phone's video are drawn on the picture and can be tapped (#67).
- Task summaries on the control page are formatted instead of raw Markdown (#66).
- Every connected device's screen size is remembered, not only the last one's (#86).
- Notifications name the device instead of always saying "iPhone" (#85).
- Updates no longer fail now and then with "Text file busy" (#81).
task runkeeps the command's own exit code aftertask finish(#78).- Holding an arrow key in setup menus no longer prints escape codes (#73).
中文
升级注意事项
- 控制台和它的
/mcp要登录了。运行iphone-control viewer token,打开它打印的链接;经 HTTP 接入的 MCP 客户端带Authorization: Bearer <令牌>。命令行和 stdio 方式的 MCP 不受影响(#79)。 - 开了
--lan时,局域网里走 HTTPS,第一次打开时核对service status显示的证书指纹(#76)。 ICTL_AGENT_GATE、ICTL_AGENT_TOKEN改成IPHONE_CONTROL_TASK_TOKEN(#64)。
新功能
- 任何 Agent 都能用 AI 任务:
iphone-control task run -- <命令>,用task list、events、pause、resume、takeover、handback、stop、approve、reject控制(#64)。 - 任务可以限定 App:
task run --app,或控制台上的 App 按钮。到了别的 App,每一步都先等你确认(#69、#70)。 - Agent 不能暂停、批准或以其他方式控制自己的任务(#75)。
- 页面刷新后,控制台会接上正在进行的任务,包括在别处开的(#64)。
viewer --lan把控制台经 HTTPS 开放到局域网(#72、#76)。- 控制台同一端口提供 MCP over HTTP(
/mcp)(#77)。 - 有名字的登录令牌,可以是只读的:
viewer token add <名字> [--read-only](#80)。 - 操作另一台机器上的手机:
mcp --url转到它的/mcp,task … --url在那里开任务、控制任务(#80、#82)。 service viewer install把控制台装成后台服务(#74)。- 设置菜单可以用方向键选择;
iphone-control completions <shell>生成补全脚本(#71)。
改进
修复
- 部分 iPhone 锁屏从约 10 秒降到约 2 秒,iOS 27 以下的 iPad 也能锁屏了(#59、#63)。
- WDA 还应答
/status、其他请求都不应答时,约 30 秒内会被重启(#60、#62)。 - 锁屏失败时如实说明两种锁屏办法各自的结果,不再报「WDA 刚掉线」(#61)。
- iOS 27 上,手机视频里看不到的系统弹窗会画在画面上,可以直接点(#67)。
- 控制台上的任务总结按格式显示,不再是 Markdown 原文(#66)。
- 接着多台设备时,每台的屏幕尺寸都记住,不再只记最后一台(#86)。
- 通知标题写设备自己的名字,不再一律写「iPhone」(#85)。
- 升级不再偶尔因「Text file busy」失败(#81)。
task finish之后,task run保留命令自己的退出码(#78)。- 在设置菜单里长按方向键不再回显按键序列(#73)。
Binaries / 二进制: macOS macos-arm64 (11+, Apple Silicon) · Linux linux-x86_64, linux-aarch64 (glibc 2.34+) · .deb amd64, arm64 (Debian 12+, Ubuntu 22.04+)
- Script / 脚本:
curl -fsSL https://github.com/Derrors/iphone-control/releases/download/v0.2.4/install.sh | sh - Homebrew:
brew install Derrors/tap/iphone-control - Debian / Ubuntu:
sudo apt install ./iphone-control_0.2.4_amd64.deb(or / 或_arm64.deb)
Already installed? Run iphone-control update. / 已安装的运行 iphone-control update 升级。