← all repositories
callstack/agent-device

A browser for AI agents, but make it mobile

Gives coding agents eyes and fingers on real iOS, Android, TV, and desktop apps through a single CLI.

3.6k stars TypeScript Coding AssistantsAgents
agent-device
Velocity · 7d
+96
★ / day
Trend
accelerating
star history

What it does

agent-device is a CLI that lets AI agents open, inspect, and interact with real mobile and desktop apps. It returns compact accessibility snapshots with semantic refs like @e3, handles taps and gestures, and captures evidence—screenshots, logs, traces, network traffic—only when needed. Think of it as Vercel’s agent-browser, but for the app store instead of the web.

The interesting bit

The project is explicitly not Appium or Detox. It is optimized for token efficiency: agents get sparse, actionable UI refs rather than dumping full view hierarchies, and they can record exploratory sessions into replayable .ad scripts for CI. The README also notes a typed Node client and public subpaths like agent-device/android-adb for bridge integrations, suggesting the CLI is a thin orchestration layer over platform-specific backends.

Key highlights

  • Supports iOS/tvOS (XCTest), Android (ADB), macOS desktop, and Linux (AT-SPI) targets
  • Works with native apps, React Native, Expo, and Flutter
  • Evidence capture is on-demand, not a firehose
  • Records sessions to .ad replay scripts for CI
  • Used by Callstack, Expensify, Shopify, and others

Caveats

  • Requires platform-specific toolchain setup (Xcode, Android SDK, macOS Accessibility permissions)
  • GitHub Actions template is listed as “coming soon”; only an EAS workflow template exists now
  • Cloud/remote execution routes through Callstack’s commercial offering

Verdict

Worth a look if you’re building agentic workflows that need to verify actual app behavior on devices. Skip it if your testing stays in headless browsers or you need a mature, framework-agnostic community ecosystem today.

Frequently asked

What is callstack/agent-device?
Gives coding agents eyes and fingers on real iOS, Android, TV, and desktop apps through a single CLI.
Is agent-device open source?
Yes — callstack/agent-device is open source, released under the MIT license.
What language is agent-device written in?
callstack/agent-device is primarily written in TypeScript.
How popular is agent-device?
callstack/agent-device has 3.6k stars on GitHub and is currently accelerating.
Where can I find agent-device?
callstack/agent-device is on GitHub at https://github.com/callstack/agent-device.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.