Skip to main content
Returns a live, read-only snapshot of a device: hardware, software, battery, network, accessibility status, current app, and launchable apps. No extra Android permissions are required, and nothing on the device changes. Use it to ground a workflow in reality before acting - which apps exist, whether the battery can survive a long task, what app is currently in the foreground.

​
Parameters

Provide at most one selector:
​
string
Target a specific registered phone. Omit all selectors to use your default device.
​
string
Read the device that owns this session - useful when continuing existing work.
​
string
Read the device that owns this task.

​
Response

The snapshot includes:
  • Manufacturer, model, Android version, SDK, and app build information
  • Screen size, density, refresh rate, and font scale
  • Memory, storage, CPU core count, battery percentage, and charging state
  • Network transport, locale, time, and timezone
  • Accessibility service status and the current app package
  • Apps Android exposes as launchable, with display label and package name
The app list is limited by Android package visibility and does not include hidden packages. The snapshot excludes identifiers and sensitive data that require additional permissions, such as IMEI, serial number, contacts, location, notifications, and private app data.

​
When to use it

  • Before dispatching app-specific work - confirm the target app is installed and get its exact package name and label.
  • Diagnosing agent behavior - check whether the Accessibility service is running and which app is in the foreground.
  • Environment-sensitive tasks - read locale, timezone, battery, and network transport before long or time-dependent workflows.