peach describe

The default way to see what is on screen. Lists visible UI elements with type, text, position, size, and style: buttons show [button], tappable views show [tap], inputs show [input]. Structural noise (icon wrappers, layout containers, duplicate text inside buttons) is pruned by the semantic inspection tree. Use —json to script against it. Reach for describe before screenshots or DOM poking.

terminal
peach describe [filter] [--verbose] [--watch] [--json] [--compact] [--no-xy] [--only <glob>] [--subtree <id>] [--testid-like <pat>]

Options

flagdescription
--verboseinclude ids, labels, and extra style info
--watchredraw as the UI changes (ctrl-c to stop)
--jsonemit structured JSON. rows keep their full text and labels: the terminal dump clips a long string to keep a row on one line, and a machine reader cannot undo that, so a red-box message or a bundle-eval stack comes back whole here
--compactrender the tree in a tighter format
--no-xyhide x,y coordinates from each row
--only <glob>glob filter across text/role/testID
--subtree <id>limit the dump to a subtree rooted at the given testID
--testid-like <pattern>fuzzy-match nodes whose testID contains the pattern

Examples

terminal
peach describe
peach describe button
peach describe --verbose
peach describe --json
peach describe --watch
peach describe --subtree feedListRoot
peach describe --only "*Header*"