Skip to main content
prompt GP ChatGPT

phone_observe — Claude Code prompt: phone screen and setup

The phone_observe Claude Code prompt reads a phone’s virtual display and its accessibility tree. The agent can locate a control or dialog before tapping it.

Apache-2.0 ★ 9,488 updated 2026-11-16

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/commands/phone_observe.md
Open on GitHub

What phone_observe does

The prompt reports the foreground app, visible elements, and the phone screen’s accessibility tree. It groups the tree by window and includes parent-child links and control states.

The agent passes a control’s ref and snapshotId to tap. When the tree misses part of the screen, treeQuality flags the gap and visibleText adds on-device OCR text with tap centers. If the target remains unclear, the agent can request screenshot or find_visually.

What it helps with

  • locate a control on the phone screen
  • identify the window that contains a dialog
  • read screen text missing from the accessibility tree
  • get a control reference for a tap

Example prompts for the agent

  • Show the open phone app and its accessibility tree.
  • Find the confirmation dialog and list its controls.
  • Read the screen text and locate the sign-in button.

How to install phone_observe

Manually: put the files in place

.claude/commands/phone_observe.md

Questions about phone_observe

How do I install phone_observe in Claude Code?

Save the prompt file as .claude/commands/phone_observe.md.

What does phone_observe do?

It reports the foreground app, visible elements, and the accessibility tree for the virtual phone display. A control’s ref and snapshotId can then be passed to tap.

What happens when the accessibility tree misses part of the screen?

treeQuality flags the gap, while visibleText adds OCR text and tap centers. If the target is still unclear, the prompt can request screenshot or find_visually.

Source text

phone_observe.md · Apache-2.0
Look at the phone's current screen (the virtual display). Returns the foreground app, all visible elements, and the full accessibility tree grouped by window, with parent-child relationships and control states. Use the tree to identify which item or dialog owns a control, then pass that control's ref and snapshotId to {{tap}}. When the tree is missing much of the screen, treeQuality says so and visibleText adds on-device OCR text with tap centers (a screenshot too, if you can view images); if the target is still missing or ambiguous, request {{screenshot}} or {{find_visually}}.

© wangzan101 · Apache-2.0 · wangzan101/Mika

Similar prompts

Prompts catalog →

From the same set132

The whole set →
spawn_agent The spawn_agent Claude Code prompt sends a child agent to investigate a bounded question. It returns a short observation; that result alone does not finish the main task. GP ChatGPT ★ 9,488repo stars phone_wait The phone_wait Claude Code prompt waits for text, an activity screen, or a settled phone display. Its Android port responds to accessibility events. GP ChatGPT ★ 9,488repo stars phone_scroll The phone_scroll Claude Code prompt scrolls an Android app screen. Set a direction, gesture amount, or scroll region. GP ChatGPT ★ 9,488repo stars phone_open_link The phone_open_link Claude Code prompt opens an Android page on the virtual display from a settings action or URI. Request a target page directly instead of navigating through the app. GP ChatGPT ★ 9,488repo stars phone_collect phone_collect — a prompt for Claude Code and ChatGPT reads text across consecutive Android app screens with local scrolling. It gathers long chat logs, feeds, and lists while merging overlapping lines. GP ChatGPT ★ 9,488repo stars run_command This Claude Code prompt runs shell commands in a Linux sandbox. It can also route calls to the current task’s phone tools through mika phone. GP ChatGPT ★ 9,488repo stars web_capture The web_capture Claude Code prompt lists XHR/fetch responses received by the current tab. It helps inspect data a page loaded through an API. GP ChatGPT ★ 9,488repo stars swipe This Claude Code prompt describes swipes between two interface points. It covers page scrolling, carousel gestures, and how to read the action result. GP ChatGPT ★ 9,488repo stars

Project sponsors

Companies that keep this analytics open