Skip to main content
prompt GP ChatGPT

phone_run — Claude Code prompt: what it does, how to install

The phone_run Claude Code prompt runs a sequence of phone commands. It checks the current accessibility tree before each action, so clear screen conditions can guide the next step without another model decision.

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_run.md
Open on GitHub

What phone_run does

phone_run executes phone commands and looks up each target in the current accessibility tree before acting. Its commands cover launching an app, tapping, typing, scrolling, swiping, waiting for text, and checking what appears on screen. A whenText condition can gate a command on visible text.

Execution stops if a target is missing or ambiguous, a condition fails, an action errors, the app switches, or the screen needs visual review. Each phone action uses the normal execution path and is recorded. Use phone_collect for long lists or chat history; after reading the final screen, another call can continue the sequence.

What it helps with

  • run app actions based on labels or visible conditions
  • enter text after checking the target screen
  • halt a sequence when a target is ambiguous or an app switch occurs
  • gather a long list or chat history with phone_collect

Example prompts for the agent

  • Open com.example.app and tap the “Sign in” button.
  • Enter the username in the “Login” field, then press Enter.
  • Wait until “Done” appears and inspect the screen.

How to install phone_run

Manually: put the files in place

.claude/commands/phone_run.md

Questions about phone_run

How do I install phone_run in Claude Code?

Place the prompt file at .claude/commands/phone_run.md.

What does phone_run do?

It runs a sequence of phone commands and looks up each target in the current accessibility tree before acting. It stops on an ambiguous target, a failed action, or a screen that needs visual review.

When does phone_run stop the sequence?

It stops for a missing or ambiguous target, an unmet condition, a failed action, an app switch, or a screen requiring visual review.

Source text

phone_run.md · Apache-2.0
Run a sequence of phone commands locally, looking up each target again in the current accessibility tree before acting. Use when the next screen can be handled by a clear condition or label without another model decision. Commands: launch(packageName, optional cold), tap(targetText/resourceId/role or x+y), type(text, optional targetText/resourceId/role and pressEnter), clear(optional target), scroll(direction, amount), swipe(startX,startY,endX,endY,durationMs), key(key), back, wait(targetText,present,timeoutMs), assert(targetText,present), observe. Add whenText to a command to require that text to be visible before it runs. Stop on a missing or ambiguous target, unmet condition, failed action, app switch, or screen needing visual review. Each actual phone action goes through the normal execution path and is recorded. Read the final screen and continue with another call when needed. Use phone_collect to gather long lists or chat history.

© wangzan101 · Apache-2.0 · wangzan101/Mika

Similar prompts

Prompts catalog →
build-zoom-phone-integration official anthropics build-zoom-phone-integration is a Claude Code skill with reference material on Zoom Phone OAuth, REST API, webhooks, Smart Embed, URI schemes, and CRM/CTI bindings. It is used after routing to a phone workflow. CX Codex +1 2,200installs Sms Gateway using your phone sms8 Sms Gateway using your phone connects real Android phones via SMS8.io to AI coding assistants for sending SMS, handling webhooks, and extracting OTP codes during automated flows. CX Codex +1 1,800installs open-autoglm-phone-agent reason-machines open-autoglm-phone-agent — a skill for Claude Code, Codex, Cursor and other IDEs that teaches your agent to set up Open-AutoGLM, an AI phone agent framework controlling Android, HarmonyOS NEXT and iOS via the AutoGLM vision-language model. CX Codex +1 1,400installs create-phone-number vapi create-phone-number — a skill for working with Vapi phone numbers through the public API: plan, provision, import, route, update and verify. Useful for connecting a voice assistant to calls. CX Codex +1 973installs phone-calls Merit-Systems Automates outbound AI phone calls, rents US/CA numbers, and fetches call transcripts via StablePhone. Useful for voice lead qualification and automated appointment reminders. CX Codex +1 420installs minimal-run-and-audit lllllllama minimal-run-and-audit is a Claude Code skill that captures and standardizes evidence from deep learning reproduction runs, including inference, evaluation, and smoke tests. CX Codex +1 502,400installs

From the same set132

The whole set →
phone_set_wheel The phone_set_wheel Claude Code prompt sets values in wheel pickers for time, dates, numbers, or regions. It handles one wheel per call and reads back the result. GP ChatGPT ★ 9,488repo stars groups The groups prompt for Claude Code and ChatGPT loads tools on demand when interacting with phone apps, web pages, and the terminal. GP ChatGPT ★ 9,488repo stars phone_system_command The phone_system_command prompt for Claude Code and ChatGPT runs Android commands through the connected device shell. Screen input is restricted; use the phone tool for actions on Mika’s display. GP ChatGPT ★ 9,488repo stars phone_launch_app phone_launch_app — a prompt for Claude Code and ChatGPT launches an app on the phone virtual display by package name and waits for foreground focus. Handles app clones, cold restarts, and occupied task locks. GP ChatGPT ★ 9,488repo stars hand_to_user hand_to_user — a prompt for Claude Code and ChatGPT that hands control of the screen to the user for manual steps tools cannot complete. GP ChatGPT ★ 9,488repo stars web_read_page The web_read_page Claude Code prompt extracts readable text from a web page, including content beyond the visible area. It can read the current tab or an address supplied in the request. GP ChatGPT ★ 9,488repo stars skill_save The skill_save prompt for Claude Code stores a personal skill inside memory and settings upon user request. GP ChatGPT ★ 9,488repo stars request_confirmation The request_confirmation Claude Code prompt asks for approval before an action that spends money. It covers placing an order, making a booking, or taking a final step on a page showing a payment amount. GP ChatGPT ★ 9,488repo stars

Project sponsors

Companies that keep this analytics open