Open source
Nine expert AI agents that give your coding assistant real React Native expertise instead of generic React advice — build failures, performance, security, code quality, accessibility, testing, native modules and release.
Works with Claude Code, Cursor, Windsurf, GitHub Copilot, Codex, Zed, Aider, any MCP client, and as a GitHub Action on your pull requests.
9
expert agents
52
reference docs
0
dependencies
MIT
licensed
The problem
So it reaches for useMemo on a primitive, suggests a web pattern that has no native equivalent, recommends Flipper five versions after it stopped mattering, or hand-edits ios/ in a managed Expo project where that directory is regenerated on every prebuild. React Native Agents replaces that guesswork with specialist playbooks that read your package.json first, cite real file:line locations, and tell you how to verify the fix.
The agents
Ask a normal question and the right specialist is selected automatically, or invoke one directly with its command.
Day to day
Gradle, CocoaPods, Metro, Xcode and environment failures — diagnosed from your actual error output.
/rn-doctor
Day to day
New screens, components, forms and lists that already handle safe areas, accessibility, states and keyboard.
/rn-new
Review
Lists, rendering, startup, memory and bundles — measured before anything gets changed.
/rn-perf
Review
Secrets, storage, auth, TLS, WebViews, deep links and supply chain.
/rn-security
Review
Architecture, TypeScript, hooks, state, error handling and React Native idioms.
/rn-review
Review
Layout, safe areas, screen readers, contrast, RTL and theming.
/rn-ui
Review
Jest, React Native Testing Library, mocking, Maestro, Detox and CI.
/rn-test
Review
TurboModules, Fabric, JSI, codegen, Swift/Kotlin, packaging and bridge migration.
/rn-native
Review
EAS, signing, OTA updates, store submission, staged rollout and rollback.
/rn-release
A tenth command, /rn-audit, runs every review specialist and consolidates the findings. Knowledge is verified through React Native 0.87 and Expo SDK 57 — always check version-specific advice against your own project.
Bundle size
Bytes are attributed per source-map segment, so a package's number is measured rather than estimated. Because it is fully deterministic, it can run on every pull request for free. Budgets accept 250kb, 1.5mb or a raw byte count — an invalid value is an error, never a silently skipped check.
$ npx @maheshwarimrinal/react-native-agents size --base main --budget-delta 100kb 📦 Bundle size 📈 +332.0 KB 2.00 MB → 2.33 MB (+16.2%) ❌ Budget exceeded — increase 332.0 KB exceeds budget 100.0 KB | moment 🆕 | +207.0 KB | 207.0 KB | → date-fns or dayjs (Hermes ships Intl, so formatting may need no library at all)
Design decisions
A knowledge.json file records exactly what has been verified and when — React Native 0.87, Expo SDK 57, React 19.2. A scheduled workflow watches the npm registry and opens an issue when reality moves ahead of the docs. Stale advice becomes a bug report instead of a silent wrong answer.
Every agent ships with graded fixtures — realistic code plus what a competent engineer should say about it. Cases carry forbid rules too: the performance agent fails its own test suite if it reaches for FlashList before it has asked anyone to measure.
Invalid key, no credits, provider outage — the audit exits non-zero instead of reporting a clean pass with zero findings. A green check that means "we did not actually look" is worse than a red one.
Doctor and Build are deliberately excluded from pull-request routing. They need something brought to them, so firing them at a diff would spend tokens to say nothing. Review agents are matched to changed paths, not run indiscriminately.
The frontmatter parser, the CLI and the MCP server are all implemented directly. Nothing in node_modules to audit, nothing in the supply chain to trust, and dist/ is committed so npx works without a build step.
The installer previews changes before writing, skips conflicts by default, supports an explicit --force, and backs up user-authored files whenever it replaces one. Your existing rules survive the install.
Pull requests
The GitHub Action routes changed files to the relevant agents and posts findings to the pull request. Anthropic and OpenAI are both supported, with a per-run spend cap and configurable severity gates.
- name: React Native audit
uses: maheshwarimrinal/react-native-agents@v1.0.2
with:
provider: anthropic
model: claude-sonnet-5
api-key: ${{ secrets.ANTHROPIC_API_KEY }}
budget-usd: '1.50'
fail-on: neverStore API keys as repository secrets — never commit them to a workflow file.
Supported tools
Playbooks are authored once and compiled into each tool's native rule format, so the advice does not drift between the editor you use and the CI that reviews you.
Plugin, marketplace entry, subagents, slash commands
.cursor/rules/*.mdc
Trigger-scoped .windsurf/rules/*.md
Instructions, path-scoped rules, chat modes
AGENTS.md and .agents/react-native/
Zero-dependency stdio MCP server
Free and MIT licensed. Issues, ideas and pull requests are all welcome.