OpenMinis/iCTRL

An AI-friendly iOS/iPadOS automation testing tool built on XCUITest, but more than a testing tool: agents like Codex, Claude Code, Hermes, OpenClaw and Minis can operate your iPhone or iPad wirelessly through an encrypted JSON-RPC 2.0 API (tap, type, read the screen, launch apps, and more).

解决的问题

iCTRL 将 iPhone 转变为 AI 代理的可控自动化端点。它通过提供稳定、高性能的 API,使代理能够像人类用户一样与屏幕、应用和系统设置交互,解决了以编程方式驱动 iOS 设备的难题。

工作原理

该项目在 iPhone 上运行一个长期存活的 XCUITest 运行器,通过 HTTP 暴露 JSON-RPC 2.0 API。由于它是为 AI 设计的,设备通过 GET /skill 和 GET /schema 提供自身的文档,使代理能够在运行时学习如何与手机交互。它使用合成的触摸事件来绕过标准 UI 测试延迟,实现快速响应的点击、滑动和屏幕读取。

适用人群

这适用于构建需要在 iOS 上执行任务的 AI 代理的开发者和研究人员,例如导航应用、读取屏幕内容或自动化需要真实设备交互的工作流程。

亮点

  • 自描述 API: 代理无需预先配置知识即可动态发现功能和调用方法。
  • 高性能: 针对速度优化,点击延迟约 280 毫秒,屏幕快照亚秒级完成。
  • 增强可见性: 使用设备上的 Vision OCR 读取标准辅助功能树可能遗漏的文本和元素。
  • 稳健安全: 具有加密、认证的通信,并需要在设备上直接进行配对批准。
  • 灵活部署: 可通过 SideStore(免费 Apple ID)或 Xcode 安装,并支持局域网远程操作或仅本地模式。

相关

  • 项目
  • 项目
  • 项目
  • 项目