Skip to content

docs(commands): trim the diagnostics, media, and remote Metro reference - #3441

Merged
thymikee merged 3 commits into
mainfrom
docs/commands-diagnostics
Oct 11, 2026
Merged

thymikee merged 3 commits into
mainfrom
docs/commands-diagnostics

Conversation

@thymikee

@thymikee thymikee commented Oct 11, 2026 •

Copy link
Copy Markdown
Member

Summary

The first of three family-scoped trims of commands.md. This one covers Performance diagnostics through Cloud provider artifacts. The range drops from 5,794 to 3,345 words. Every command, flag, example, error code and recovery step is kept; explanations owned by a guide or by agent-device help are replaced with a link.

  • Media and logs: split into Screenshots, Screenshot diffs and Recordings. Record details point to agent-device help record.
  • Performance, React Native, Metro, Remote Metro: condensed. Content that existed only here moved to debugging-profiling.md: remote bridge sessions, network dump platform details, and perf data sources and limits.
  • Added: the React Native 0.87+ agent-react-devtools setup (dev dependency, npx agent-react-devtools init, rebundle). CLI help already documented it, but the docs didn't.
  • Anchors #metro-reload, #media-and-logs and #remote-metro-workflow still resolve. The pinned cdp and agent-react-devtools@0.5.0 lines are unchanged.

The other two families (lifecycle, interactions) follow in separate PRs. Each edits a different range of commands.md.

Validation

  • pnpm check:affected --run passed on 8fdb233.
  • 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

thymikee and others added 2 commits October 11, 2026 19:38
…ections

Condense Performance diagnostics through Cloud provider artifacts in
commands.md, pointing to versioned help and Debugging & Profiling for
detail. Move perf data sources, Android frame-window reset, iOS network
dump caveats, and the remote-bridge React DevTools relaunch order into
debugging-profiling.md.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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:55 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
… to the debugging guide

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

Copy link
Copy Markdown
Member Author

This PR is ready at 8fdb233. CI is green, with 11 checks and none failing, and the docs-only diff touches no runtime route. There are no conflicts and nothing else stands in the way of merge. Not blocking: a few removed facts may now live only in the old docs, namely the expo-dev-client note that open skips writing simulator debug-server settings, the Android screenrecord --bit-rate quality mapping, and the --scale range 0.01-1 with the --max-size refusal, so please check that each is in agent-device help (screenshot, open, record) and restore a line if not, or leave it. I sampled the highest-risk removed facts (limits, defaults, reason codes, platform support) against help and spot-checked the rest against the registry, but I did not diff every removed line.

The RN 0.87+ setup thread (#3441 (comment)) no longer applies. That setup is now in the React DevTools section of debugging-profiling.md, and commands.md links to it, so you can resolve it.

@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 d926d5f into main Oct 11, 2026
11 checks passed
@thymikee
thymikee deleted the docs/commands-diagnostics 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