docs(commands): trim the navigation, target, and runner reference

Merged
TH
1mo ago
+167-174

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 help prints the topic list itself.
  • Navigation: split into labelled groups. iOS launch prompts, action-button and fold are condensed, and fold details point to agent-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_KEEP are kept.
  • sessions.md gains "Release a device another workspace holds", covering device status, device release --stale, live vs dead owners, and reboots. The slow-device section now covers the 90-second default and boot_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 --run passed on 08aee6a2e.
  • The four tests that pin commands.md text pass.
  • check:doc-prose and check:doc-links pass.
  • Docs only, so no device runs.

๐Ÿค– Generated with Claude Code