ghost_see
Describe a window's UI as structured elements (name, role, rect) by matching a title substring or using the foreground window. Read visible text, detect changes, or retrieve selected text via modes.
Instructions
Describe a window's UI as elements {name, role, rect}. Target = window= (title substring; becomes the session anchor) or the current anchor; with neither, the human's foreground window and the response says so (target.source). Never focuses or raises anything. mode=full (default whenever a window is targeted: scoped walk, works on covered windows and hidden-desktop apps), mode=fast (foreground-only quick path, used only when nothing is targeted), mode=text (READ the visible text - the cheapest way to read content), mode=delta (changed elements since since_seq), mode=marks (DEBUG Set-of-Marks image), mode=selection (selected text of a name/role element). Elements capped at 150 (limit); text at 20000 chars.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | full=scoped tree (default with a target), fast=foreground quick path, delta=changed only, text=readable text, marks=SoM debug image, selection=selected text of name/role element | |
| name | No | Element name (mode=selection) | |
| role | No | Element role (mode=selection) | |
| limit | No | Max elements (default 150) or chars for mode=text (default 20000); 0 = unlimited elements | |
| window | No | Title substring of the window to describe. Anchors it for later calls. 'foreground' = the human's current window. | |
| since_seq | No | Prior snapshot seq for delta mode |