claudecodex

rn-dev-agent

AI agent that fully tests React Native features on simulator/emulator — navigates the app, verifies UI, walks user flows, and confirms internal state.

20 on GitHubby Anton Lykhoydav1.0.14MITupdated 22 days agomobile-development
/

Plugin rn-dev-agent from marketplace rn-dev-agent in Lykhoyda/rn-dev-agent. Commands read from the repo's manifest — 22 days ago.

This plugin runs code on your machine — its hooks fire automatically on events like tool use and it starts local MCP servers. The exact commands are listed below; read them before installing.

What it installs

Skills (28)

  • build-and-test

    Explicit Codex workflow: Build the Expo/React Native app (local or EAS), install it, start Metro, then test a requested feature end-to-end.

  • capturing-proof

    This skill should be used when the user asks to "capture proof", "record a demo of this feature", "make a video showing it works", "record the flow for the PR", "generate a PR body", "capture screenshots for the PR", "proof-capture", or when a verified feature needs PR-ready proof artifacts (video +

  • check-env

    Explicit Codex workflow: Check that the fenced React Native session, Metro, app target, and device inventory are ready for testing.

  • check-vercel-rules

    Explicit Codex workflow: Run the packaged Vercel Labs agent-skills rule audit on the current project.

  • creating-actions

    This skill should be used when the user asks to "create an action", "save this flow as an action", "make this replayable", "record a reusable action", "author a Maestro flow as an action", "add a login/setup action", or when a verified UI walk should be persisted under .rn-agent/actions/ so future s

  • debug-screen

    Explicit Codex workflow: Diagnose why the current screen is broken, showing unexpected content, or crashing. Gathers parallel evidence from all layers and applies a targeted fix.

  • doctor

    Explicit Codex workflow: Run strictly read-only Codex plugin, MCP contract, schema, and environment diagnostics; recommend but never execute recovery.

  • list-learned-actions

    Explicit Codex workflow: List persisted reusable actions, UI skeletons, and legacy feedback memories before composing device primitives.

  • lock-e2e

    Explicit Codex workflow: Promote a verified param-free action into a frozen e2e regression test after one strict replay.

  • nav-graph

    Explicit Codex workflow: Extract, inspect, and query the app navigation graph — a complete map of all screens and navigators.

  • observe

    Explicit Codex workflow: Show the Observe web UI URL, stop it, or restart it through the active MCP server.

  • proof-capture

    Explicit Codex workflow: Capture PR-ready proof artifacts for a feature, with an attested fail-closed controller in strict mode.

  • qa-pr

    Explicit Codex workflow: Device-test a GitHub pull request on iOS simulator, Android emulator, and/or physical device. Installs the PR head via rn-dev-agent and reports pass/fail with repro steps and screenshots.

  • rn-best-practices

    This skill should be used when writing or reviewing React Native / Expo code — before writing list rendering, animations, data fetching, component APIs, navigation, or image/media UI — and when asked to "review best practices", "check performance", "optimize renders", "review list rendering", "check

  • rn-debugging

    This skill should be used when the user asks to "debug the app", "fix a crash", "diagnose a blank screen", "read error logs", "troubleshoot CDP connection", "check Metro status", "find native crashes", "inspect network failures", "the app crashed", "I see a blank screen", "the screen is white", "som

  • rn-device-control

    This skill should be used when the user asks to "control the simulator", "take a screenshot", "boot the emulator", "install the app", "read UI hierarchy", "manage device state", "open a deep link", "grant permissions", "stream native logs", "disable animations", "change device locale", or needs guid

  • rn-feature-dev

    Explicit Codex workflow: Guided feature development for React Native — explore codebase, design architecture, implement, verify live on device, and review quality.

  • rn-feature-development

    This skill should be used when building any new feature in a React Native or Expo app, or when the $rn-dev-agent:rn-feature-dev command runs. Triggers on "build a feature", "add X to the app", "implement Y", "create a new screen", "rn-feature-dev", "feature development", "build me X", "add a screen"

  • rn-setup

    Use for Codex rn-dev-agent onboarding, passive recovery diagnosis, dependency readiness, and safe setup routing when tools are missing or failing.

  • rn-testing

    This skill should be used when the user asks to "write a Maestro test", "create E2E flows", "add testIDs", "run UI tests", "run E2E tests", "verify a feature works", "test my screen", "set up maestro-runner", "mock network requests", "inspect store state", "write test assertions", or needs guidance

  • rn-workflow

    Validate and establish the proven rn-dev-agent operating sequence before a real React Native journey — read project instructions and the declared package manager, inventory sessions/Metro/devices read-only, establish one exclusive simulator/emulator via typed session actions, apply and verify packag

  • run-action

    Explicit Codex workflow: Execute a learned Maestro flow (\"action\") by name with optional -e KEY=VALUE parameters. Looks the flow up via packages/rn-dev-agent-core/dist/learned-actions.js (same inventory as $rn-dev-agent:list-learned-actions), then replays it via cdp_run_action — auto-repair-aware

  • run-workflow

    Explicit Codex workflow: Validate and establish the proven rn-dev-agent operating sequence before a real React Native journey — declared package manager and dependencies, read-only inventory, typed session recovery, one exclusive device, managed integration and Metro, only the requested proof, rever

  • send-feedback

    Explicit Codex workflow: Collect reviewed, sanitized rn-dev-agent feedback and create a GitHub issue only with user confirmation.

  • sending-feedback

    Use when the user wants to send feedback, report an rn-dev-agent bug, request a plugin feature, or says the rn-dev-agent MCP transport or tools are unavailable. Collects sanitized diagnostics and guides creation of a reviewed GitHub issue.

  • setup

    Explicit Codex workflow: Onboard a Codex project with passive diagnostics, managed AGENTS.md instructions, optional nav/store instrumentation, and the rn-agent scaffold.

  • test-feature

    Explicit Codex workflow: Test a React Native feature on the running simulator/emulator. Verifies UI, user flows, and internal state. Generates a persistent Maestro test file.

  • using-rn-dev-agent

    Entry point for the rn-dev-agent plugin. Maps user intent to the right command, agent, or skill. Use at the START of any React Native development conversation. Triggers on "I want to build", "build a feature", "add a feature to the app", "test this", "something is broken", "fix the crash", "help wit

Slash commands (17)

  • /rn-dev-agent:build-and-test

    Build the Expo/React Native app (local or EAS), install on simulator/emulator, start Metro, then test the specified feature end-to-end.

  • /rn-dev-agent:check-env

    Check that the fenced React Native session, Metro, app target, and device inventory are ready for testing.

  • /rn-dev-agent:check-vercel-rules

    Run the Vercel Labs agent-skills rule audit on the current project. Default scans changed files; pass --all for full project, --ci for CI-mode (exits 1 on violations).

  • /rn-dev-agent:debug-screen

    Diagnose why the current screen is broken, showing unexpected content, or crashing. Gathers parallel evidence from all layers and applies a targeted fix.

  • /rn-dev-agent:doctor

    Diagnose installation health. Check Node, CDP bridge, rn-fast-runner (iOS), rn-android-runner (Android), maestro-runner, learned-action compatibility, simulators, Metro, CDP, injected helpers, ffmpeg, physical devices, plugin version, Vercel rules sync. Reports what's missing — does NOT modify your

  • /rn-dev-agent:list-learned-actions

    List persisted "learned actions" — feedback memories, Maestro flows, UI skeletons, and plugin commands that should be consulted before composing new device_* primitives. Wraps packages/rn-dev-agent-core/dist/learned-actions.js for programmatic discovery.

  • /rn-dev-agent:lock-e2e

    Promote a verified action into a frozen, locked e2e regression test. Runs the action once strict (no repair) via cdp_lock_e2e_test and freezes it to .rn-agent/e2e/<id>.yaml only if it passes. v1 supports param-free actions only.

  • /rn-dev-agent:nav-graph

    Extract, inspect, and query the app navigation graph — a complete map of all screens and navigators.

  • /rn-dev-agent:observe

    Show the observability web UI URL (it autostarts with the session); stop or restart it.

  • /rn-dev-agent:proof-capture

    Capture PR-ready proof artifacts for a feature, with an attested fail-closed controller in strict mode.

  • /rn-dev-agent:qa-pr

    Device-test a GitHub pull request on iOS simulator, Android emulator, and/or physical device. Installs the PR head via rn-dev-agent and reports pass/fail with repro steps and screenshots.

  • /rn-dev-agent:rn-feature-dev

    Guided feature development for React Native — explore codebase, design architecture, implement, verify live on device, and review quality.

  • /rn-dev-agent:run-action

    Execute a learned Maestro flow ("action") by name with optional -e KEY=VALUE parameters. Looks the flow up via packages/rn-dev-agent-core/dist/learned-actions.js (same inventory as /rn-dev-agent:list-learned-actions), then replays it via cdp_run_action — auto-repair-aware orchestration with structur

  • /rn-dev-agent:run-workflow

    Validate and establish the proven rn-dev-agent operating sequence before a real React Native journey — declared package manager and dependencies, read-only inventory, typed session recovery, one exclusive device, managed integration and Metro, only the requested proof, reverse-order cleanup.

  • /rn-dev-agent:send-feedback

    Send feedback or report a bug for the rn-dev-agent plugin. Collects sanitized environment context and creates a GitHub issue. No sensitive data (paths, secrets, PII) is transmitted.

  • /rn-dev-agent:setup

    Full onboarding for a new project — runs /doctor diagnostics, then injects the CLAUDE.md template + nav-ref instrumentation + Zustand store exposure so the plugin works without the user having to read documentation.

  • /rn-dev-agent:test-feature

    Test a React Native feature on the running simulator/emulator. Verifies UI, user flows, and internal state. Generates a persistent Maestro test file.

Subagents (6)

  • rn-code-architect

    Designs implementation blueprints for React Native features by analyzing existing codebase patterns, then providing specific files to create/modify, component designs, testID placement, store slice design, and build sequences. Triggers: "design the architecture", "plan the implementation", "create a

  • rn-code-explorer

    Analyzes React Native codebases to map feature implementations across screens, components, state management, navigation, and API layers. Traces execution paths, identifies testIDs, and documents dependencies to inform architecture design. Triggers: "explore the codebase", "how does this feature work

  • rn-code-reviewer

    Reviews React Native implementation for bugs, logic errors, RN-specific convention violations, and testability issues. Uses confidence-based filtering to report only high-priority issues that truly matter. Triggers: "review this code", "check for bugs", "review the implementation", "are there any is

  • rn-debugger

    Diagnoses broken or unexpected behavior in a React Native app running on simulator/emulator. Gathers parallel evidence (component tree, logs, network, store), narrows root cause, applies a fix, and verifies recovery. PARENT-SESSION-ONLY: requires MCP tools (cdp_*, device_*, collect_logs) — do NOT sp

  • rn-pr-qa

    Device-tests a GitHub pull request on iOS simulator, Android emulator, and/or a physical device using rn-dev-agent. Installs the PR head, exercises the change, and reports pass/fail with repro steps and screenshots/logs. PARENT-SESSION-ONLY: requires MCP tools (cdp_*, device_*, rn_session) — do NOT

  • rn-tester

    Tests React Native features on simulator/emulator. Verifies UI renders correctly, user flows work, and internal state matches expectations. Use when a feature has been implemented and needs verification. PARENT-SESSION-ONLY: requires MCP tools (cdp_*, device_*) — do NOT spawn via Task tool, run prot

MCP servers (1)

  • cdp

    runs: node ${CLAUDE_PLUGIN_ROOT}/rn-dev-agent-core/dist/supervisor.js

Hooks (7)

  • SessionStart

    ${CLAUDE_PLUGIN_ROOT}/hooks/detect-rn-project.sh

  • PostToolUse

    ${CLAUDE_PLUGIN_ROOT}/hooks/post-edit-health-check.sh

  • PostToolUse

    ${CLAUDE_PLUGIN_ROOT}/hooks/vercel-rules-audit.sh

  • CwdChanged

    ${CLAUDE_PLUGIN_ROOT}/hooks/cwd-changed.sh

  • SubagentStart

    ${CLAUDE_PLUGIN_ROOT}/hooks/subagent-start.sh

  • PostToolUseFailure

    ${CLAUDE_PLUGIN_ROOT}/hooks/tool-use-failure.sh

  • Stop

    ${CLAUDE_PLUGIN_ROOT}/hooks/troubleshooting-sync.sh

View source on GitHub lykhoyda.github.io

Similar plugins

superpowers

claudecodex

Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques

15 skills · hooks

obra/superpowers 316,836

Collection of example skills demonstrating various capabilities including skill creation, MCP building, visual design, algorithmic art, internal communications, web testing, artifact building, Slack GIFs, and theme styling

19 skills

anthropics/skills 193,780

Comprehensive PR review agents specializing in comments, tests, error handling, type design, code quality, and code simplification

1 command · 6 agents

anthropics/claude-code 155,476

storybook

claudecodex

Build, preview, and test UI components with Storybook.

7 skills

storybookjs/storybook 91,552

Agentic QE (external: maintained in proffesor-for-testing/agentic-qe, pinned to v3.15.17): a quality-engineering fleet with 11 QE agents, 9 skills, 9 commands, the agentic-qe MCP server pinned to the plugin version, and the aqe-mod guard that refuses destructive operations on AQE learning data

9 skills · 9 commands · 11 agents · 1 MCP server

ruvnet/ruflo 81,589

Reliable automation, in-depth debugging, and performance analysis in Chrome using Chrome DevTools and Puppeteer

8 skills · 1 MCP server

ChromeDevTools/chrome-devtools-mcp 55,181

Maintain rn-dev-agent?

This page updates itself from your repo. Add the badge to your README, or get it Featured to pin it above the organic results with a followed link to your site.

claude & codex pluginslisted