xAI在今年推出的Grok Build编程代理为开发者提供了一套基于Mac端的AI编程助手工具。近日，开发者Pedro Shakour在GitHub上开源了一个名为grok-build-ios的项目，为Grok Build构建了一款iOS客户端，让开发者可以用iPhone作为远程界面来操控运行在Mac上的Grok代理。

架构设计：手机做界面，Mac算力

grok-build-ios的核心设计理念是”手机是寻呼机UI，Mac才是算力引擎”。具体来说，Mac端通过官方的grok agent serve命令运行Grok代理，iPhone端则通过ACP（Agent Communication Protocol）协议以JSON-RPC格式通过WebSocket与Mac端进行通信。

这种架构意味着AI代理的推理和代码执行仍在Mac上完成，iPhone仅作为远程交互界面使用。对于开发者而言，这意味着可以在外出时用手机查看编程进度、下达指令，而回到电脑前时无缝继续工作。

连接方式根据运行环境有所不同：在模拟器中，客户端通过127.0.0.1的2419端口与Mac通信；如果是实体iPhone，则通过同一Wi-Fi网络下Mac的局域网IP进行连接。此外，项目还保留了一个基于TLS + Bonjour的旧版局域网桥接方案，存放在companion/目录下供实验使用。

技术要求与使用方式

要运行grok-build-ios，用户需要满足以下条件：

• 搭载Grok CLI（grok命令行工具）的macOS系统
• xAI API密钥
• Xcode 16或更高版本（支持模拟器或真机）
• iOS 17或更高版本

使用流程分为三步：首先在Mac上设置XAI_API_KEY环境变量并启动grok agent serve，CLI会输出一个Secret密钥；然后在Xcode中打开iOS项目并运行；最后在应用中粘贴Secret密钥完成连接。

项目结构与开源状态

从仓库结构来看，该项目主要包含以下模块：

• ios/GrokApp/：基于SwiftUI构建的iOS应用主体
• companion/：旧版ACP TCP/TLS桥接
• shared/：来自上游的主题和斜杠命令目录
• upstream-grok-build/：锁定到xAI官方grok-build仓库的子模块
• scripts/：演示和测试辅助脚本

该项目使用Apache-2.0开源协议，代码构成上Swift占65.4%、Shell占19.2%、Python占15.4%。需要注意的是，该项目目前不在App Store上架，仅限开源侧载或模拟器使用。

作为一款开源社区驱动的项目，grok-build-ios目前获得了8个Star，反映了开发者对跨设备AI编程体验的兴趣。随着AI编程代理的日益普及，这类让开发者随时随地与AI协作的远程控制工具，有望成为一个值得关注的方向。