callstack__agent-device/index.md

Agent-native app automation for mobile, TV, and desktop.

agent-device gives coding agents structured UI access, deterministic interactions, and app-level evidence across mobile, TV, and desktop targets. Use it to verify generated code, debug broken flows, profile runtime behavior, and turn exploratory QA into replayable checks.

Get Started | Commands

Features

• One CLI, many app surfaces: Control iOS, Android, tvOS, Android TV, Amazon Vega OS TV apps in the Vega Virtual Device, macOS, and Linux desktop targets through one CLI.
• Accessibility-first snapshots: On supported targets, accessibility trees give agents structured UI context without forcing screenshot-only reasoning.
• Agent-native interactions: Tap, pan, fling, pinch, rotate, scroll, focus, type, assert, and find visible UI through refs, selectors, and semantic finders.
• Built-in debugging and profiling: Use each target's supported backends to collect logs, inspect traffic, capture screens and recordings, and sample performance.
• Session and replay: Open apps, keep stateful context, and replay recorded .ad actions to reproduce flows without AI at runtime.
• React Native internals: Use agent-device react-devtools for component trees and render profiles, and agent-device cdp for React Native JS heap snapshots, diffs, and leak retainers.