agent-device 是 Callstack 开源的移动应用自动化与验证工具，目标是给 AI 编程智能体一个运行中应用的实时反馈闭环。智能体可通过 CLI、内置 MCP 服务器或类型化 Node.js API 检查、控制、调试并验证应用。
用途：让编码智能体在真实运行的应用中验证自己的改动，读取基于无障碍树的精简快照而非仅依赖截图，通过 refs 和选择器执行操作，并保存可复核的证据。
主要能力：检查应用状态（无障碍快照、refs、选择器，并可分析 React Native 渲染性能）；操作可见 UI（点击、输入、滚动、手势、等待、断言、处理弹窗）；诊断失败（截图、视频、日志、trace、网络数据、性能采样、崩溃信息、React profile）；将步骤保存为 .ad 脚本用于本地或 CI 重放，也可导出严格的 Maestro YAML。
支持平台：iOS、Android、HarmonyOS 的模拟器、仿真器与真机，以及 tvOS、Android TV、Amazon Vega OS TV、Web、macOS、Linux。不同目标支持深度不同，可用 agent-device capabilities --platform <platform> 查看。
使用方式：安装 CLI 并检查环境，要求 Node.js 22.12 或更高，Web 自动化要求 Node.js 24 或更高；交给智能体前先自行运行 doctor。agent-device mcp 启动官方 stdio MCP 服务器；createAgentDeviceClient() 提供 Node.js 类型化访问。会话按调用者的 git worktree 隔离，设备占用可防止并行智能体互相抢占模拟器，可用 agent-device device status 查看归属，agent-device device release --stale 释放失效占用。
适用场景：与 Claude Code、Codex、Cursor、Windsurf、Cline、Goose 等可运行 CLI 或连接 MCP 的智能体配合；支持原生 iOS/Android 应用及 React Native、Expo、Flutter 应用；可在 CI 中重放 .ad 脚本并保留截图与日志；也可连接 BrowserStack、AWS Device Farm、TestMu AI、Limrun 等远程设备云。
限制：部分后端（如 HarmonyOS、Vega OS）仅覆盖部分命令；refs 仅在最新输出中有效，执行 --settle 命令后应使用其 diff 中的 refs；无障碍数据质量差时需依赖截图或视频。项目为 MIT 许可开源。
