Skip to main content
prompt GP ChatGPT

phone_launch_app · wangzan101, tools — Claude Code prompt: what it does, how to install

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.

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

What phone_launch_app does

The prompt launches an installed application on the phone virtual display using its exact package name and confirms it reached the foreground. Setting cold=true restarts the app from its initial view. Running a cloned or work-profile copy requires the user identifier from the phone_list_apps output, while the primary app omits it.

Execution logic covers system dialogs and read failures. When the app fails to appear, the call returns ok:false detailing what occupies the screen. If window contents cannot be inspected or Android displays an app clone chooser, the prompt stops further launch retries.

If another task holds the application, the run yields app_in_use_by_other_task. Repeating the call with wait in seconds queues the launch until the active task releases the app.

What it helps with

  • open an app on the phone virtual display by package name
  • launch a cloned application using the user ID
  • restart an app from the initial screen with cold=true
  • wait out task locks when receiving app_in_use_by_other_task

Example prompts for the agent

  • Launch com.example.app on the phone display and wait until it is in the foreground
  • Restart com.example.app from its initial screen with cold=true
  • Open the work profile copy using the user parameter from phone_list_apps

How to install phone_launch_app

Manually: put the files in place

.claude/commands/phone_launch_app.md

Questions about phone_launch_app

How to install phone_launch_app in Claude Code?

Save the prompt file to .claude/commands/phone_launch_app.md.

What does phone_launch_app do?

It opens an app on the phone virtual display by package name, waits for foreground visibility, and manages clone selectors.

How to handle an app occupied by another task?

Run the command again with the wait parameter in seconds. It launches the application as soon as the competing task releases it.

Source text

phone_launch_app.md · Apache-2.0
Open an installed app on the phone's virtual display by exact package name, and wait until it is in the foreground. To open another copy of the app (a clone or work-profile copy), also pass user from that copy's phone_list_apps entry; leave it out for the main app. Set cold=true to restart it from its initial screen. If the app does not reach the foreground, it returns ok:false with what is there instead; if it is in the foreground but its window cannot be read, the result says so: do not launch it again. If the system asks which one to open (an app installed twice, as main and clone), it returns ok:true with chooser: tap the option the user meant, otherwise the main one, and do not launch again. If another task is using the app, it returns app_in_use_by_other_task; to wait for it instead of doing something else, call again with wait (seconds): it opens the app as soon as the other task lets go.

© wangzan101 · Apache-2.0 · wangzan101/Mika

Similar prompts

All prompts for Mobile →

phone_launch_app by other authors comes first.

phone_launch_app wangzan101 The phone_launch_app Claude Code prompt opens an installed app on a phone’s virtual display using its exact package name. Screen-reading and control tools become available after the next call. GP ChatGPT ★ 9,488repo stars app-launch appeeky app-launch — a skill that builds a launch plan for a new app or a major update: a week-by-week checklist, promotion channels and success metrics. CX Codex +1 3,600installs phone-harness DuskBotAI phone-harness is a Claude Code skill that automates Android device control via USB debugging. It performs taps, text entry, and screenshots within mobile apps. CX Codex +1 ★ 567repo stars capacitor-app-upgrades capawesome-team capacitor-app-upgrades walks the agent through upgrading a Capacitor app to a newer major version, including jumps across several versions. Useful when you finally move from 4 to 8. CX Codex +1 1,500installs mobile-app-debugging secondsky mobile-app-debugging — a skill for debugging iOS, Android and cross-platform apps: crashes, memory leaks, dropped frames, network problems. CX Codex +1 446installs mobile-app-builder Michael Galpert mobile-app-builder — a subagent for native mobile work: iOS, Android and React Native, with attention to scroll smoothness and memory use. ★ 1,013repo stars capacitor-app-development capawesome-team capacitor-app-development guides coding agents through configuring, running, and troubleshooting existing Capacitor 6, 7, and 8 apps across iOS and Android. CX Codex +1 1,800installs

From the same set132

The whole set →
locate locate — a prompt for Claude Code finds a specific element on a mobile phone screenshot and returns its coordinates. The task runs when an interface button or icon location needs to be identified from an image. GP ChatGPT ★ 9,488repo stars 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_run 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. 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

Project sponsors

Companies that keep this analytics open