agent-device

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

开源 🏷️定价信息待确认 ✅ 目前可打开 智能体 🍴 复刻 385 🐛 待处理 119 👀 关注 6
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 5289
维护状态 活跃
是否开源 开源
定价模式 🏷️定价信息待确认

项目预览

agent-device 项目界面预览图
图片来源：项目官网

项目数据

分类智能体
开发团队callstack
官网地址https://agent-device.dev
GitHubhttps://github.com/callstack/agent-device
定价模式🏷️定价信息待确认
价格说明定价信息待确认
访问状态✅ 目前可打开
是否开源是
开源协议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 星标★ 5289
上线时间2026-01-30 00:00:00
代码更新2026-11-07
仓库体积234.5 MB
本站数据更新2026-11-07
维护状态活跃
收录时间2026-08-09
浏览次数2

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 5289

使用教程

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

环境要求

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

安装与启动步骤

  1. 1全局安装 CLI

    通过 npm 全局安装 agent-device 最新版，安装后即可在终端直接调用 agent-device 命令。

    npm install -g agent-device@latest

  2. 2检查环境

    运行 doctor 自检本机环境与设备依赖是否就绪；建议在把 CLI 交给 AI 代理之前自己先跑一遍。

    agent-device doctor

  3. 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

上一篇：suede-creator-skills

下一篇：sphere-sdk

同类项目推荐

gpt-newspaper 开源

填几个兴趣，AI 自动给你出一份专属报纸

GPT based autonomous agent designed to create personalized newspapers tailored to us···

★ 1485 2026-10-17
yao 开源

一个二进制文件，搞定 AI 智能体和 Web 应用开发

✨ All your agents and workspaces in one place, on every device you own. Track tasks···

★ 8277 2026-08-09
llm-wiki-agent 开源

丢进资料，自动长出你的个人维基百科

A personal knowledge base that builds and maintains itself. Drop in sources — Claud···

★ 3681 2026-08-09
yu-ai-agent 开源

一套教程，带你从零掌握 Java AI 开发全栈技能

编程导航 2025 年 AI 开发实战新项目，基于 Spring Boot 3 + Java 21 + Spring AI 构建 AI···

★ 97 2026-08-09
forge-orchestrator 开源

让多个 AI 代理有序协作，不打架、不跑偏

NXTG-Forge orchestrator: an MCP server for Claude Code with task orchestration, file···

★ 165 2026-08-09
blink 开源

自托管 AI 智能体平台，快速构建内部定制代理

Blink is a self-hosted platform for building and running custom, in-house AI agents.

★ 165 2026-08-09
openclaw-voice-call-realtime 开源

让AI接打电话，实时语音交互+工具调用，一步搞定。

Give your AI assistant a phone — OpenClaw plugin for real phone calls via Twilio + ···

★ 106 2026-08-09
ai-character-studio 开源

亲手捏出专属角色，想和谁聊就和谁聊。

Open-source AI character creator & roleplay chat studio — production-ready Next.js ···

★ 27 2026-08-09