
agent-device
Mobile app automation and verification for AI coding agents. CLI, MCP server, and typed Node.js API for iOS, Android, HarmonyOS, TV, web, macOS, and Linux.
The Lens
By Erik Loyd, SaaS CEO and former COO/CFO of an AWS Premier Partner.
Updated Sep 2026
agent-device gives a coding agent a live app to poke at. It drives iOS, Android, and HarmonyOS across simulators, emulators, and physical hardware, plus tvOS, Android TV, web, macOS, and Linux, through a CLI, a built-in MCP server, or a typed Node.js API. MIT, from Callstack, the consultancy behind a lot of the React Native ecosystem.
The design choice that matters is the accessibility tree. Rather than feeding an agent screenshots and hoping it reasons over pixels, agent-device hands it a text snapshot with element refs, so the agent presses the element it was handed, at-e2, instead of guessing at coordinates. Cheaper in tokens and far more reliable. Install is a global npm install on Node.js 22.12 or newer, and the bundled doctor command checks your setup before you hand the keys to an agent. It also arbitrates device ownership across parallel agent worktrees, which is the problem you hit the moment two agents want the same simulator.
Solo devs and small mobile teams get value immediately, and it plugs into Claude Code, Codex, Cursor, Windsurf, Cline, and Goose with no custom work. Bigger teams can point the same commands at BrowserStack, AWS Device Farm, or Limrun instead of local hardware. Free at every size.
The catch is that this is glue, not a device farm. It drives hardware you already own or a cloud you already pay for, so iOS still wants a Mac with Xcode and the cloud path still wants a cloud bill. Your app also has to be accessible: snapshots come from the accessibility tree, so if labels, roles, and test IDs are a mess, the agent is back to squinting at screenshots.
Free vs Self-Hosted vs Paid
fully freeFree tier
Everything. MIT, no paid edition and no hosted service. Install with npm install -g agent-device on Node.js 22.12 or newer; web automation wants Node.js 24 or newer.
Self-hosted The default and only mode. It runs on your machine against your own simulators, emulators, and physical devices. The real prerequisites are platform ones: a Mac with Xcode for iOS, the Android SDK for Android. Callstack offers team QA engagements by email, which is consulting rather than a product tier.
Paid Nothing to buy from the project. If you route it at a device cloud instead of local hardware, BrowserStack, AWS Device Farm, or Limrun bill you on their own terms.
Free and MIT with nothing to buy. Your costs are the platform SDKs you already need and any device cloud you route it at.
What to do by team size
- Solo
- free; the fastest way to give an agent a real device loop
- Small team
- free; device arbitration pays off the moment two agents run at once
- Medium team
- free, but budget for the device cloud you route it at
- Large team
- free tool; point it at BrowserStack or AWS Device Farm rather than a rack of local phones
Get tools like this every Wednesday
One featured tool, three on the radar. No fluff.
A low score is not a verdict on quality. Young and niche tools start low by design. How we calculate scores
Trust Signals
License: MIT License
Use freely, including commercial. Just keep the license.
Commercial use: ✓ Yes
About
- Owner
- Callstack (Organization)
- Stars
- 4,717
- Forks
- 311
Also by Callstack
Explore Further
More tools in the directory
everything-claude-code
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
264.9k ★hermes-agent
The agent that grows with you
247.9k ★dify
Production-ready platform for agentic workflow development.
156.1k ★