docs(commands): trim the navigation, target, and runner reference
Merged
TH
1mo ago+167+167+012345678901234567890123456789-174-174-012345678901234567890123456789
Summary
The third of three family-scoped trims of commands.md. This one covers the intro through Desktop targets. The range drops from about 5,970 to 3,850 words (โ36%). Every command, flag, example, error reason and recovery step is kept.
- Intro: the 20-line help-topic list is now four lines;
agent-device helpprints the topic list itself. - Navigation: split into labelled groups. iOS launch prompts,
action-buttonandfoldare condensed, andfolddetails point toagent-device help foldable. - Prepare Apple runner: internal cache detail is cut (build-scratch trimming and sizes, cache-key internals). Every error reason with its fix, the CI cache rule, and
AGENT_DEVICE_IOS_RUNNER_CACHE_KEEPare kept. sessions.mdgains "Release a device another workspace holds", coveringdevice status,device release --stale, live vs dead owners, and reboots. The slow-device section now covers the 90-second default andboot_timeout.- No headings changed, so all linked anchors still resolve.
Companion to #3441 and #3442. Each edits a different range of commands.md.
Validation
pnpm check:affected --runpassed on 08aee6a2e.- The four tests that pin
commands.mdtext pass. check:doc-proseandcheck:doc-linkspass.- Docs only, so no device runs.
๐ค Generated with Claude Code