agent-device is a mobile app automation and verification tool that gives AI coding agents a live feedback loop through a CLI, MCP server, or typed Node.js API.
The tool solves the problem of agents lacking real-time verification of their changes in running applications. Instead of reasoning only from screenshots, agents work with token-efficient accessibility snapshots extracted from the app's accessibility tree, act through element references and selectors, and capture evidence for review. The approach supports iOS, Android, and HarmonyOS on simulators, emulators, and physical devices, alongside tvOS, Android TV, Amazon Vega OS TV, web, macOS, and Linux. It coordinates device access across parallel agent worktrees and integrates with remote device clouds.
The tool suits teams building or using AI coding agents that need to verify mobile app changes. It works with Claude Code, Codex, Cursor, Windsurf, Cline, Goose, and any agent capable of running a CLI or connecting over MCP. Developers can also build custom agents using the AI SDK or Eve framework with the tool as the runtime. The accessibility-tree approach makes agent runs more reliable when apps have clear labels, roles, and test IDs, though screenshots and video remain available as evidence or fallback when accessibility data is sparse. The tool requires Node.js 22.12 or newer, with Node.js 24 or newer needed for web automation.
Development activity shows consistent engagement with the codebase through regular commits addressing both features and maintenance. The project maintains comprehensive documentation that stays synchronized with the installed version, helping users debug, replay, and profile agent behavior. The maintainers provide per-client setup guidance and actively support integration with multiple agent platforms, indicating ongoing investment in the tool's usability across different deployment contexts.
