> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agi.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# phone_get_state

> Read a live, permission-free snapshot of a phone.

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:

<ParamField body="device_id" type="string">
  Target a specific registered phone. Omit all selectors to use your default
  device.
</ParamField>

<ParamField body="session_id" type="string">
  Read the device that owns this session - useful when continuing existing
  work.
</ParamField>

<ParamField body="task_id" type="string">
  Read the device that owns this task.
</ParamField>

## 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

<Note>
  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.
</Note>

## 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.

## Related

* [`phone_device_status`](/api-reference/tools/phone-device-status) - lighter connectivity/readiness check
* [`list_devices`](/api-reference/tools/list-devices) - enumerate devices first