find_visually — Claude Code prompt for finding screen elements
find_visually — a prompt for Claude Code and ChatGPT that locates a button, icon, or input by sight. It kicks in when the element list misses the target or an app draws its own interface.
Apache-2.0 ★ 9,488 updated 2026-11-16
.claude/commands/find_visually.mdWhat find_visually does
The prompt searches for one visible control, such as a button, icon, or input field. It covers cases where list_elements omits the target, returns it without a name, or the app renders a custom interface. Unlike describe, it focuses on a single target rather than the whole screen.
The request should briefly identify the element and include its exact visible label when available. A match returns a ref like @vN and a snapshotId for tap. Both expire after the screen changes or another action happens on that screen.
What it helps with
- locate a button omitted by
list_elements - find an unnamed item in the element list
- spot a control in an app-rendered interface
Example prompts for the agent
- Find the button labeled “Continue” on the screen.
- Locate the search icon to the right of the heading.
- Find the input field even if it is missing from the element list.
How to install find_visually
Manually: put the files in place
.claude/commands/find_visually.mdHow to use
Paste the text at the start of a chat or into project instructions
Questions about find_visually
How do I install find_visually in Claude Code?
Place the prompt file at .claude/commands/find_visually.md.
What does find_visually do?
It locates one screen element by sight when list_elements misses it or cannot name it. The result includes a ref and snapshotId that can be passed to tap.
How long do the ref and snapshotId remain valid?
They remain valid until the screen changes or another action is performed on that screen.
Source text
find_visually.md · Apache-2.0
Find one element (a button, icon or input box) by sight when the element list cannot give it to you: {{list_elements}} leaves it out or shows it without a name, or the app paints its own screen. Faster than {{describe}}, which reads the whole screen. Say briefly what it is in target, and put its exact visible label in text when it has one. When found you get a ref (@vN) and snapshotId to pass to {{tap}}; they only last until the screen changes or you do anything else on this screen.
© wangzan101 · Apache-2.0 · wangzan101/Mika