Tools/callstack/agent-device

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.

4.7k+134/wkemergingTypeScriptMIT Licensetrending

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 free

Free 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
Self-hosting ops:trivial

Get tools like this every Wednesday

One featured tool, three on the radar. No fluff.

Score
80/100 · A
Adoption17/30
Maintenance25/25
Community13/20
License15/15
Analysis10/10

A low score is not a verdict on quality. Young and niche tools start low by design. How we calculate scores

Trust Signals

Community discussions enabledOrganization account (109 public repos)Notable author: 1,471 followersAuthor also built: callstack/liquid-glass (1,659 stars)

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