docs(commands): trim the interaction, app, and settings reference
Merged
TH
1mo ago+179+179+012345678901234567890123456789-223-223-012345678901234567890123456789
Summary
The second of three family-scoped trims of commands.md. This one covers Snapshot and inspect through Keyboard. The range drops from 8,266 to 5,397 words (โ35%). Every command, flag, example, error code and recovery step is kept.
- Wait and alerts: wait failure reasons are a list, each with what it means. Poll evidence is shorter.
- Interactions: split into Text entry, Pointer and gestures, and Scroll. Text-entry error codes are a list with the next step for each. Scroll details point to
agent-device help scroll, andscroll --untilreplaces a manual shell loop. - Retry after a failed command: reasons, including
session_or_device_selector_requiredandsession_app_required, are a list with their fixes. - Settings helpers: grouped by area with one shared refusal list. Internal mechanics are cut (simctl notification names, container paths, pm/appops); what the user sees is kept.
- The pinned snapshot usage line, the
predicate_failedsentence, the supported-predicates sentence, and every linked anchor are unchanged.
Companion to #3441. Each edits a different range of commands.md.
Validation
pnpm check:affected --runpassed on e6565098d.- The four tests that pin
commands.mdtext pass. check:doc-proseandcheck:doc-linkspass.- Docs only, so no device runs.
๐ค Generated with Claude Code