# ๐๏ธ ERNE โ Everything React Native & Expo
> **AI agent harness with 13 specialized agents, autonomous worker, video debugging, adaptive fix, and 29 auto-updating knowledge rules.** Adaptive stack detection, multi-agent orchestration, and a pixel-art dashboard. Every config is generated to match _your_ exact project setup.
[](https://www.npmjs.com/package/erne-universal)
[](https://github.com/JubaKitiashvili/everything-react-native-expo)
[](https://opensource.org/licenses/MIT)
[](https://makeapullrequest.com)
---
## โก Quick Start
> **Prerequisite:** [Claude Code](https://claude.ai/claude-code) is required for the full experience (13 agents, pipeline orchestration, dashboard, hooks). Other IDEs receive adaptive rules and configuration โ see [IDE Support](#%EF%B8%8F-ide--editor-support).
### Install
```bash
# Install globally (recommended)
npm i -g erne-universal
```
### Setup
```bash
# One-time setup in your React Native / Expo project
erne init
# Launch the dashboard
erne dashboard
# Or do both at once
erne start
```
> **Without global install:** use `npx erne-universal` instead of `erne` (slower โ downloads each time).
### What `init` does:
1. ๐ **Deep-scans your project** โ detects 15 stack dimensions (state management, navigation, styling, lists, images, forms, storage, testing, build system, component style, monorepo, New Architecture, and more)
2. ๐๏ธ Lets you choose a hook profile (minimal / standard / strict)
3. ๐ Select MCP integrations (simulator control, GitHub, etc.)
4. โ๏ธ **Generates adaptive configuration** โ selects from 24 variant templates matched to your exact stack (Zustand vs Redux, Expo Router vs React Navigation, NativeWind vs StyleSheet, etc.)
### CLI Commands
```bash
erne init # Setup ERNE in your project
erne dashboard # Launch dashboard
erne start # Init + dashboard
erne doctor # Health check (22 checks)
erne audit # Generate project documentation
erne worker --config w.json # Start autonomous worker
erne sync-configs # Export rules to other IDEs
erne update # Update to latest version
erne uninstall # Clean removal
```
---
## ๐ฆ What's Included
| Component | Count | Description |
| -------------------- | ----- | -------------------------------------------------------------------------------------------- |
| ๐ค Agents | 13 | Specialized AI agents incl. visual debugger, doc generator, smart routing |
| ๐ Agent variants | 9 | Stack-adaptive agent configurations (StyleSheet vs NativeWind, Zustand vs Redux, etc.) |
| โก Commands | 24 | Slash commands for every React Native workflow (incl. /erne-debug-video, /erne-update) |
| ๐ Rule layers | 5 | Conditional rules: common, expo, bare-rn, native-ios, native-android |
| ๐ฏ Rule variants | 15 | Stack-specific rules selected by deep detection (state, navigation, styling, security, etc.) |
| ๐ Knowledge rules | 29 | Expo SDK 55, RN 0.84, React 19.2, Reanimated, Skia, Gesture Handler, SVG, ExecuTorch, more |
| ๐ก๏ธ Hook profiles | 3 | Minimal, standard, strict โ quality enforcement your way |
| ๐ Skills | 7 | Reusable knowledge modules loaded on-demand |
| ๐ญ Contexts | 3 | Behavior modes: dev, review, vibe |
| ๐ MCP configs | 10 | Pre-configured server integrations |
| ๐ฌ Video debugging | 1 | Analyze screen recordings for temporal UI bugs |
| ๐ง Adaptive Fix | โ | Agent-based or direct fix from dashboard |
| ๐ Workflow examples | 4 | End-to-end multi-agent workflow guides |
| ๐ค Handoff templates | 4 | Structured agent-to-agent context passing |
---
## ๐ฎ Agent Dashboard
ERNE includes a real-time dashboard with 6 pages, pixel-art agent HQ, and adaptive fix integration.
```bash
erne dashboard # Start on auto-detected port, open browser
erne dashboard --port 4444 # Custom port
erne start # Init + dashboard in one command
```
### Command Center
Health score, issues summary, agent status, system health checks.
### Issues โ Agent Fix
Severity filtering, Agent Fix buttons (auto-detects Claude Code), "Needs planning" for complex issues, real-time fix output.
### Tasks โ Worker & Providers
6 provider integrations (ClickUp, GitHub, Linear, Jira, GitLab, Local), Kanban board, interactive setup guides.
### Agents โ Pixel Art HQ
13 animated agents in 4 rooms, real-time status, custom naming, activity history.
### Project โ Stack & Docs
Stack detection, MCP servers, generated documentation (12 doc types), recommendations.
### Commands
23 commands including /erne-debug-video, click to copy.
---
## ๐ฌ Video Debugging
Analyze screen recordings to find temporal UI bugs that screenshots cannot capture.
```bash
/erne-debug-video recording.mp4
```
Catches: animation glitches, race conditions, gesture issues, scroll jank, keyboard overlap, navigation transitions.
- Extracts key frames via ffmpeg scene detection (any format: mp4, mov, webm, avi, mkv, gif)
- Claude analyzes frames as a timeline with frame references
- No additional API keys needed โ uses Claude you already have
---
## ๐ 29 Knowledge Rules (Auto-Updating)
ERNE ships with 29 comprehensive rule files covering the entire React Native ecosystem:
| Category | Rules | Coverage |
| ---------------- | ----- | ---------------------------------------------------------------------------------- |
| Core | 10 | Expo SDK 55, RN 0.84, React 19.2, navigation, patterns, styling, testing, security |
| Expo Packages | 4 | 40+ packages: audio, video, camera, file-system, sqlite, notifications, location |
| Software Mansion | 5 | Reanimated v4, Gesture Handler, Skia, SVG, Screens |
| Callstack | 5 | Native bottom tabs, RNTL, on-device AI, Reassure, Voltra |
| Cutting-edge | 5 | ExecuTorch (on-device LLM), Audio API, Enriched (rich text), Freeze, Screens |
Rules auto-update weekly via GitHub Action โ checks npm for new SDK/RN versions, analyzes changelogs with Claude API, and opens a PR.
---
## ๐ฏ Multi-Agent Orchestration
ERNE supports coordinated multi-agent workflows through the pipeline orchestrator:
```bash
/orchestrate "build user profile screen"
```
**Pipeline phases:**
```
๐๏ธ Plan architect decomposes the task
โ
โก Implement senior-developer + feature-builder (parallel)
โ
๐งช Test tdd-guide writes and runs tests
โ
๐ Review code-reviewer validates with evidence
โ
๐ Validate performance-profiler checks performance
```
Features retry logic (max 3 attempts), escalation to user on persistent failures, and structured [handoff templates](docs/handoff-templates.md) for context passing between agents. See [Pipeline Documentation](docs/pipeline.md) for details.
---
## ๐ค Agents
Each agent has a distinct personality, quantified success metrics, and memory integration for cross-session learning.
| Agent | Emoji | Domain | Room |
| --------------------------- | ----- | ------------------------------------------------------ | ----------- |
| **architect** | ๐๏ธ | System design and project structure | Development |
| **senior-developer** | ๐จโ๐ป | End-to-end feature implementation, screens, hooks, API | Development |
| **feature-builder** | โก | Focused implementation units, works in parallel | Development |
| **native-bridge-builder** | ๐ | Turbo Modules and native platform APIs | Development |
| **expo-config-resolver** | โ๏ธ | Expo configuration and build issues | Development |
| **ui-designer** | ๐จ | Accessible, performant UI components | Development |
| **code-reviewer** | ๐ | Code quality with evidence-based approval | Code Review |
| **upgrade-assistant** | ๐ฆ | Version migration guidance | Code Review |
| **tdd-guide** | ๐ฆ | Test-driven development workflow | Testing |
| **performance-profiler** | ๐๏ธ | FPS diagnostics and bundle optimization | Testing |
| **pipeline-orchestrator** | ๐ฏ | Multi-agent workflow coordination | Conference |
| **visual-debugger** | ๐ฌ | Screenshot-based UI debugging | Development |
| **documentation-generator** | ๐ | Auto-generate project documentation | Development |
---
## ๐ง Context Optimization
ERNE includes a built-in context intelligence system (auto-enabled with dashboard) that compresses tool outputs by **97-100%**, indexes content with FTS5 search, and manages your context budget. See [BENCHMARK.md](BENCHMARK.md) for the full 21-scenario breakdown.
> **Pairs well with [context-mem](https://github.com/JubaKitiashvili/context-mem)** โ ERNE gives your AI deep React Native knowledge, context-mem gives it persistent memory across sessions. Together: an AI assistant that knows RN best practices AND remembers your project patterns. `npm i context-mem && npx context-mem init`
---
## ๐ฐ Token Efficiency
ERNE minimizes token usage through two complementary systems: **architecture-level savings** (what gets loaded into context) and **runtime context optimization** (how tool outputs and session state are compressed).
### Architecture savings
| Mechanism | How it works | Savings |
| -------------------------- | --------------------------------------------------------------------- | ------- |
| **Profile-gated hooks** | Minimal profile runs 4 hooks instead of 16 | ~31% |
| **Conditional rules** | Only loads rules matching your project type (Expo, bare RN, native) | ~26% |
| **On-demand skills** | Skills load only when their command is invoked, not always in context | ~12% |
| **Subagent isolation** | Fresh agent per task with only its own definition + relevant rules | ~12% |
| **Task-specific commands** | 23 focused prompts instead of one monolithic instruction set | ~13% |
| **Context-based behavior** | Modes change behavior dynamically without loading new rulesets | ~3% |
### Runtime context optimization (benchmark-verified)
| Mechanism | How it works | Savings |
| ---------------------- | ------------------------------------------------------------------------ | ---------------------- |
| **Content summarizer** | Auto-detects 14 content types, produces statistical summaries | **97โ100%** per output |
| **Index + Search** | FTS5 BM25 retrieval returns only relevant chunks, code preserved exactly | **80%** per search |
| **Smart truncation** | 4-tier fallback: Structured โ Pattern โ Head/Tail โ Hash | 85โ100% per output |
| **Session snapshots** | Captures full session state in <2KB | ~50% vs log replay |
| **Budget enforcement** | Throttling at 80% prevents runaway token usage | Prevents overflow |
**Result:** Architecture saves **60โ67%** on what enters context. Runtime optimization achieves **97โ100%** compression on tool outputs (verified across 21 benchmark scenarios with 537 KB of real data). In a full debugging session, **99% of tool output tokens are eliminated** โ leaving 99.6% of your context window free for actual problem solving. See [BENCHMARK.md](BENCHMARK.md) for complete results.
---
## ๐ก๏ธ Hook Profiles
| Profile | Hooks | Use Case |
| ---------- | ----- | ---------------------------------------------------------------------------- |
| `minimal` | 4 | โก Fast iteration, vibe coding โ maximum speed, minimum friction |
| `standard` | 12 | โ๏ธ Balanced quality + speed (recommended) โ catches real issues |
| `strict` | 16 | ๐ Production-grade enforcement โ full security, accessibility, perf budgets |
Change profile: set `ERNE_PROFILE` env var, add `` to CLAUDE.md, or use `/vibe` context.
---
## โก Commands
| Category | Commands |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Core** | `/erne-plan`, `/erne-code-review`, `/erne-tdd`, `/erne-build-fix`, `/erne-perf`, `/erne-upgrade`, `/erne-native-module`, `/erne-navigate`, `/erne-code`, `/erne-feature` |
| **Extended** | `/erne-animate`, `/erne-deploy`, `/erne-component`, `/erne-debug`, `/erne-debug-visual`, `/erne-debug-video`, `/erne-quality-gate` |
| **Orchestration** | `/erne-orchestrate`, `/erne-worker` |
| **Maintenance** | `/erne-update`, `/erne-learn`, `/erne-retrospective`, `/erne-setup-device` |
---
## ๐ฅ๏ธ IDE & Editor Support
ERNE generates adaptive config files for multiple IDEs, but the **full agent experience requires Claude Code**:
| Feature | Claude Code | Cursor / Windsurf / Copilot / Codex |
| ------------------------------- | :---------: | :---------------------------------: |
| Adaptive rules & config | โ
| โ
|
| Stack detection (15 dimensions) | โ
| โ
|
| 23 slash commands | โ
| โ |
| 13 specialized agents | โ
| โ |
| Pipeline orchestration | โ
| โ |
| Hook profiles | โ
| โ |
| Agent dashboard | โ
| โ |
| Cross-session memory | โ
| โ |
**Generated config files:**
| File | IDE / Tool |
| --------------------------------- | --------------------------------------- |
| `CLAUDE.md` | Claude Code (full experience) |
| `AGENTS.md` | Codex, Windsurf, Cursor, GitHub Copilot |
| `GEMINI.md` | Gemini CLI |
| `.cursorrules` | Cursor |
| `.windsurfrules` | Windsurf |
| `.github/copilot-instructions.md` | GitHub Copilot |
---
## ๐๏ธ Architecture
```
Claude Code Hooks โโโถ run-with-flags.js โโโถ Profile gate โโโถ Hook scripts
โ
โโโโโโโโโโโโดโโโโโโโโโโโ
โ Only hooks for โ
โ active profile โ
โ are executed โ
โโโโโโโโโโโโโโโโโโโโโโโ
erne dashboard โโโถ HTTP + WS Server โโโถ Browser Canvas
โฒ
Claude Code PreToolUse โโค (Agent pattern)
Claude Code PostToolUse โ
```
**Key design principles:**
- ๐ชถ **Zero runtime dependencies** for the harness itself (ws package only for dashboard)
- ๐ฏ **Conditional loading** โ rules, skills, and hooks load based on project type and profile
- ๐งน **Fresh subagent per task** โ no context pollution between agent invocations
- ๐ **Silent failure** โ hooks never block Claude Code if something goes wrong
---
## ๐ค Contributing
We welcome contributions from everyone โ from typo fixes to new agents and skills.
| I want to... | Start here |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| ๐ Report a bug | [Bug Report](https://github.com/JubaKitiashvili/everything-react-native-expo/issues/new?template=bug_report.md) |
| ๐ก Request a feature | [Feature Request](https://github.com/JubaKitiashvili/everything-react-native-expo/issues/new?template=feature_request.md) |
| ๐ Propose a new skill | [Skill Proposal](https://github.com/JubaKitiashvili/everything-react-native-expo/issues/new?template=new_skill.md) |
| ๐ Submit a PR | [Contributing Guide](CONTRIBUTING.md) |
```bash
git checkout -b feat/your-feature
npm run validate && npm test # Must pass before PR
```
---
## ๐ค Partnerships
Skills, agents, and MCP configs are open source โ anyone can add them via PR. Partnerships are for deeper collaboration:
| Partnership Type | What It Means |
| -------------------- | ---------------------------------------------------------------------------------------------------- |
| **Co-Maintenance** | You keep your library's ERNE skill up to date as your API evolves |
| **Early Access** | We update ERNE before your breaking changes ship, so users never hit stale guidance |
| **Joint Promotion** | Your docs recommend ERNE for AI-assisted development, we feature you on [erne.dev](https://erne.dev) |
| **Domain Expertise** | Co-develop specialized agents that require deep knowledge of your platform |
If you maintain a React Native library, Expo tool, or developer service โ [let's talk](https://github.com/JubaKitiashvili/everything-react-native-expo/issues/new?template=partnership.md).
---
## ๐ฆ Available On
- [npm](https://www.npmjs.com/package/erne-universal) โ `npx erne-universal init`
- [SkillsMP](https://skillsmp.com) โ Auto-indexed from GitHub
- [BuildWithClaude](https://buildwithclaude.com) โ Plugin directory
- [VoltAgent/awesome-agent-skills](https://github.com/VoltAgent/awesome-agent-skills) โ Curated skills list
---
## ๐ Documentation
| Doc | Description |
| ------------------------------------------------ | ------------------------------------ |
| [Getting Started](docs/getting-started.md) | Installation and first run |
| [Agents Guide](docs/agents.md) | All 13 agents with domains and usage |
| [Commands Reference](docs/commands.md) | All 23 slash commands |
| [Hooks & Profiles](docs/hooks-profiles.md) | Hook system and 3 profiles |
| [Creating Skills](docs/creating-skills.md) | Author your own skills |
| [Pipeline & Orchestration](docs/pipeline.md) | Multi-agent workflow coordination |
| [Memory Integration](docs/memory-integration.md) | Cross-session learning with MCP |
| [Handoff Templates](docs/handoff-templates.md) | Structured agent-to-agent context |
| [Contributing](CONTRIBUTING.md) | How to contribute |
---
## ๐ License
MIT License โ use freely, commercially or personally.
---
**๐๏ธ ERNE โ Your React Native AI Dream Team ๐๏ธ**
[โญ Star this repo](https://github.com/JubaKitiashvili/everything-react-native-expo) ยท [๐ด Fork it](https://github.com/JubaKitiashvili/everything-react-native-expo/fork) ยท [๐ Report an issue](https://github.com/JubaKitiashvili/everything-react-native-expo/issues) ยท [๐ erne.dev](https://erne.dev)
Made with โค๏ธ for the React Native community