Skip to content

fix: clarify remote device devtools guidance#485

Open
thymikee wants to merge 1 commit intomainfrom
codex/bridge-guidance
Open

fix: clarify remote device devtools guidance#485
thymikee wants to merge 1 commit intomainfrom
codex/bridge-guidance

Conversation

@thymikee
Copy link
Copy Markdown
Contributor

@thymikee thymikee commented Apr 30, 2026

Summary

Clarifies remote/cloud device guidance after the remote DevTools tunnel work landed on main in #487. This PR is now narrower: it keeps the new remote Android companion tunnel path, but prevents agents from trying remote iOS React DevTools while the current cloud service rejects that device-port route.

Details:

  • Marks local-only or runner-backed commands in CLI help, including boot, ensure-simulator, alert, and keyboard, using remote/cloud device wording instead of making agents reason about bridge internals.
  • Updates help workflow, help remote, and help react-devtools with remote profile guidance for device lifecycle, runner-backed helper fallbacks, and React DevTools tunnel behavior.
  • Keeps remote Android React DevTools on the CLI-managed tunnel path, and fails fast for remote iOS React DevTools because the currently deployed cloud service rejects iOS device-port routing.
  • Updates the React DevTools skill and public command docs to describe current remote Android support and the current remote iOS limitation.
  • Adds help assertions, React DevTools companion coverage, and SkillGym cases for remote/cloud command planning.

Touched files: 7. Scope includes wording cleanup plus the small React DevTools remote iOS fail-fast guard so CLI behavior matches verified cloud behavior.

Validation

  • pnpm format
  • pnpm exec vitest run src/__tests__/cli-react-devtools.test.ts src/utils/__tests__/args.test.ts
  • pnpm check:quick
  • pnpm build
  • pnpm exec skillgym run ./test/skillgym/suites/agent-device-smoke-suite.ts --config ./test/skillgym/skillgym.config.ts --case remote-cloud-avoids-local-device-setup
  • pnpm exec skillgym run ./test/skillgym/suites/agent-device-smoke-suite.ts --config ./test/skillgym/skillgym.config.ts --case remote-ios-cloud-react-devtools-unavailable

@github-actions
Copy link
Copy Markdown

github-actions Bot commented Apr 30, 2026

PR Preview Action v1.8.1

QR code for preview link

🚀 View preview at
https://callstackincubator.github.io/agent-device/pr-preview/pr-485/

Built to branch gh-pages at 2026-04-30 19:00 UTC.
Preview will be ready when the GitHub Pages deployment is complete.

@thymikee thymikee force-pushed the codex/bridge-guidance branch from ba6b3f5 to e2d3c99 Compare April 30, 2026 14:43
@thymikee thymikee changed the title docs: clarify remote bridge guidance fix: support bridge devtools guidance Apr 30, 2026
@thymikee thymikee force-pushed the codex/bridge-guidance branch from e2d3c99 to 17f26ca Compare April 30, 2026 14:49
@thymikee thymikee changed the title fix: support bridge devtools guidance fix: clarify remote device devtools guidance Apr 30, 2026
@thymikee thymikee force-pushed the codex/bridge-guidance branch from 17f26ca to cc28ded Compare April 30, 2026 15:23
@thymikee thymikee force-pushed the codex/bridge-guidance branch from cc28ded to 3f63bd4 Compare April 30, 2026 19:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant