Skip to content

docs(commands): trim the interaction, app, and settings reference - #3442

Merged
thymikee merged 2 commits into
mainfrom
docs/commands-interactions
Oct 11, 2026
Merged

thymikee merged 2 commits into
mainfrom
docs/commands-interactions

Conversation

@thymikee

@thymikee thymikee commented Oct 11, 2026 •

Copy link
Copy Markdown
Member

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, and scroll --until replaces a manual shell loop.
  • Retry after a failed command: reasons, including session_or_device_selector_required and session_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_failed sentence, 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 --run passed on e656509.
  • 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

View guided diff Turn on auto-fix

…tings reference

Condense the Snapshot and inspect through Keyboard sections of the command
reference: list wait failure reasons and text-entry errors with their
recovery, group interactions into text entry, gestures, and scroll, point to
versioned help for gesture and scroll detail, and restructure settings by
area with one refusal list. Point the snapshots page at scroll --until and
--settle instead of a manual scroll loop.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@github-actions

github-actions Bot commented Oct 11, 2026 •

Copy link
Copy Markdown
Contributor
PR Preview Action v1.8.1
Preview removed because the pull request was closed.
2026-10-11 18:54 UTC

@cubic-dev-ai cubic-dev-ai Bot left a comment •

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All reported issues were addressed across 2 files

Reply with feedback, questions, or to request a fix.

View guided diff | Turn on auto-fix | Re-trigger cubic

Comment thread website/docs/docs/commands.md Resolved
Comment thread website/docs/docs/commands.md Resolved
Comment thread website/docs/docs/commands.md Resolved
Comment thread website/docs/docs/commands.md Resolved
Comment thread website/docs/docs/commands.md Resolved
Comment thread website/docs/docs/commands.md Resolved
…s claims

Address review on #3442: plain-duration waits take no timeout, the iOS
TEXT_ENTRY_MISMATCH check compares against the post-clear value plus the
request, the synthesis-budget recovery still appends with type,
scroll_no_progress needs the swipe inside the unchanged container,
Android airplane mode depends on cmd connectivity airplane-mode, and
settings resolve only installed apps.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@thymikee

Copy link
Copy Markdown
Member Author

This PR is ready at e656509. The docs-only change has no production code route, and CI is green with 11 checks and none failing. There are no conflicts, and nothing else stands between this and merge. Not blocking, and you can take or leave it: the removed scroll paragraph in https://github.com/callstack/agent-device/blob/e656509/website/docs/docs/commands.md#L509 said Android directional scrolls decelerate to reduce release momentum, and that scroll top and scroll bottom keep inertial release for edge traversal. I found those terms only in code and tests, not in help or docs, so you could restore one sentence or confirm that agent-device help scroll covers it. I did not run the pinning tests or check:doc-prose, and I sampled the wait reasons, permission targets, install limits and text-size categories against source rather than diffing every condensed claim.

@thymikee thymikee added the ready-for-human Valid work that needs human implementation, judgment, or maintainer merge label Oct 11, 2026
@thymikee
thymikee merged commit cd6d5f4 into main Oct 11, 2026
11 checks passed
@thymikee
thymikee deleted the docs/commands-interactions branch October 11, 2026 18:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ready-for-human Valid work that needs human implementation, judgment, or maintainer merge

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant