agent-device

让 AI 代理直接操控手机，自动化测试与交互一步到位

agent-device 是一个面向 AI 代理的移动设备控制命令行工具，旨在让 AI 代理能够直接操作 iOS 和 Android 设备，完成自动化测试、应用交互和端到端验证等任务。它解决了传统移动自动化中 AI 接入困难的问题，通过封装 adb、iOS 模拟器、Expo 和 Flutter 等底层技术，提供统一的 CLI 接口，并支持 MCP 协议，使 AI 代理可以像调用工具一样控制设备。核心能力包括设备连接管理、屏幕操作、应用启动与关闭、UI 元素交互、截图与日志获取等，适用于智能体驱动的移动端自动化场景。

开源 unknown 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 4730

维护状态活跃

是否开源是

定价模式 unknown

项目数据

分类智能体

开发团队callstack

所属国家

官网地址https://agent-device.dev

GitHubhttps://github.com/callstack/agent-device

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型adb,agentic-ai,agents,ai-agents,android-emulator,automation,e2e-testing,expo,flutter,ios-simulator,mcp,mobile,mobile-testing,performance-optimization,react-native,testing,xcuitest

GitHub 星标★ 4730

30天Star增速

HF 下载量

上线时间2026-01-30 00:00:00

最近更新2026-09-22 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数1

使用教程

难度：入门约 10 分钟部署方式：命令行工具 3 步

环境要求

Node.js 22.12 或更高版本
如需使用 web 自动化能力，需 Node.js 24 或更高版本
可用的 npm 全局安装权限
如需控制设备，需准备 iOS/Android 模拟器、仿真器或真机（README 未给出具体配置命令）

安装与启动步骤

1全局安装 CLI

通过 npm 全局安装 agent-device 最新版，安装后即可在终端直接调用 agent-device 命令。
```
npm install -g agent-device@latest
```
2检查环境

运行 doctor 自检本机环境与设备依赖是否就绪；建议在把 CLI 交给 AI 代理之前自己先跑一遍。
```
agent-device doctor
```
3查看工作流指南

查看官方工作流帮助，链接到调试、回放（replay）和性能分析（profiling）指南，帮助内容与已安装版本一致。
```
agent-device help workflow
```

如何确认成功

执行 agent-device doctor 能正常输出环境检查结果、且终端可识别 agent-device 命令，即表示安装成功。

常见问题

Q：对 Node.js 版本有什么要求？

A：需要 Node.js 22.12 或更新版本；如果要使用 web 自动化能力，则需要 Node.js 24 或更新版本。

Q：能在 CI 里运行吗？

A：可以。把一次运行录制为 .ad 脚本，在 CI 中回放，并保留截图与日志作为构建产物；官方提供了 EAS workflow 模板作为可运行示例。

Q：支持哪些设备和平台？

A：支持 iOS、Android、HarmonyOS 的模拟器、仿真器和真机，此外还支持 tvOS、Android TV、Amazon Vega OS TV、web、macOS 和 Linux。

Q：可以接入哪些 AI 代理？

A：支持 Claude Code、Codex、Cursor、Windsurf、Cline、Goose，以及任何能运行 CLI 或通过 MCP 连接的代理，也可作为 AI SDK / Eve 构建的代理运行时。

注意事项

把 CLI 交给编码代理之前，请先自行运行 agent-device doctor 确认环境就绪。
agent-device 内置 MCP 服务，可通过 MCP 协议接入代理，也可使用带类型的 Node.js API。
云/远程设备场景需要额外配置 remote proxy 或接入设备云（BrowserStack、AWS Device Farm、Limrun）。
除本地外，还支持 CI/CD 与云端远程设备执行三种运行路径。

核心亮点

统一封装 adb 与 iOS 模拟器命令，降低移动设备控制门槛
原生支持 MCP 协议，AI 代理可无缝集成设备操作能力
覆盖 Android 和 iOS 双平台，兼顾 Expo/Flutter 等跨平台框架

不足之处

文档/社区待观察
依赖本地环境配置，复杂设备场景可能需要额外调试

适用场景

AI 驱动的移动端自动化回归测试
智能体辅助的 App 功能验证与演示
基于 MCP 的移动设备远程控制与运维

替代项目

Appium、Maestro、Detox

项目介绍

agent-device 是智能体领域的开源项目，由 callstack 开发，是 2026 年新上线的项目。

在全站 13,014 个收录项目中，它的 GitHub 星标数（4,730）位列前 9%，在智能体分类的 2,499 个项目里位列前 10%。

近 44 天，它的 GitHub 星标从 4,029 增加到 4,730，净增 701。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-22。从国内网络环境看，可直接访问。

它主要面向的使用场景是：AI驱动的移动端自动化回归测试。同类可对比的替代方案包括 Appium、Maestro、Detox。

上一篇：suede-creator-skills

下一篇：sphere-sdk