view_user_screen — Claude Code prompt: what it does, how to install
The view_user_screen Claude Code prompt looks up a screen shared by the user. It returns details from the captured image and can answer questions about visual elements.
Apache-2.0 ★ 9,488 updated 2026-11-16
.claude/commands/view_user_screen.mdWhat view_user_screen does
The prompt retrieves a user-shared screen by ID and provides the app name, capture time, and recognized text with centre coordinates from 0 to 999. When the image is available, the screenshot can be viewed as well.
If the image cannot be seen directly, ask about a specific detail, such as an icon, colour, or layout; a vision model answers from the screenshot. The image records the screen at capture time, not the phone’s current display. For Claude Code, place the file at .claude/commands/view_user_screen.md.
What it helps with
- look up a shared screen by ID
- identify the app shown in a screenshot
- read recognized text and its screen position
- ask about a visual detail in the captured image
Example prompts for the agent
- Inspect screen ID
screen_123and list the text it contains. - Identify the app shown in this screenshot.
- Describe the colour of the icon in the top corner of screen ID
screen_123.
How to install view_user_screen
Manually: put the files in place
.claude/commands/view_user_screen.mdHow to use
Paste the text at the start of a chat or into project instructions
Questions about view_user_screen
How do I install view_user_screen in Claude Code?
Place the prompt file at .claude/commands/view_user_screen.md.
What does view_user_screen do?
It retrieves a shared screen by ID and returns the app, capture time, and recognized text with coordinates. If the image is not directly visible, a vision model can answer questions about it.
Does it show what is on the phone right now?
No. It shows the screen as it appeared when the screenshot was taken.
Source text
view_user_screen.md · Apache-2.0
Look again at a screen the user sent you, by its id (given with the screen, or in the earlier turns). You get its app, when it was taken and its text with 0-999 centre points; when you can see images, the screenshot too. When you cannot see images, say in question what you want to know (an icon, a picture, a colour, the layout) and the vision model answers it from that screenshot. It shows that moment, not what the phone shows now.
© wangzan101 · Apache-2.0 · wangzan101/Mika