🏗️ ERNE — Everything React Native & Expo

The complete AI coding agent harness for React Native and Expo — 11 specialized agents, adaptive stack detection, multi-agent orchestration, and a pixel-art dashboard. Every config is generated to match your exact project setup.

⚡ Quick Start

Prerequisite: Claude Code is required for the full experience (11 agents, pipeline orchestration, dashboard, hooks). Other IDEs receive adaptive rules and configuration — see IDE Support.

npx erne-universal init

This will:

1. 🔍 Deep-scan 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. 🎚️ Let you choose a hook profile (minimal / standard / strict)
3. 🔌 Select MCP integrations (simulator control, GitHub, etc.)
4. ⚙️ Generate adaptive configuration — selects from 24 variant templates matched to your exact stack (Zustand vs Redux, Expo Router vs React Navigation, NativeWind vs StyleSheet, etc.)

📦 What's Included

🎮 Agent Dashboard

ERNE includes a real-time pixel-art dashboard with 4 tabs, a context sidebar, and animated office visualization.

erne dashboard              # Start on port 3333, open browser
erne dashboard --port 4444  # Custom port
erne dashboard --no-open    # Don't open browser
erne start                  # Init project + dashboard in background

HQ — Pixel-Art Office

• 🏢 4 office rooms — Development, Code Review, Testing, and Conference
• 🎨 11 animated agent sprites with walking, typing, and done animations
• 💬 Thought bubbles showing the current task above working agents
• 🖥️ Animated monitor screens (green code when working, screensaver when idle)
• 🔔 Toast notifications for agent start/complete events
• 📊 Bottom stats bar with session duration, tasks completed, working/planning counts
• 👤 Agent detail overlay with full activity history (click any agent)
• 🎯 Pipeline orchestrator coordination view in conference room
• 🔄 Real-time WebSocket updates with auto-reconnect

My App — Project Intelligence

• 📋 App overview with framework detection, health grade, and stack chips
• 🔌 10 MCP integration statuses with requirements
• 🔍 Project audit with score, findings (with FIX buttons), and strengths
• ⚡ Quick actions — run tests, lint, start dev, build iOS/Android, pod install
• 💡 Smart recommendations based on audit findings
• 🛠️ Environment checks for all dev tools (Node, Xcode, CocoaPods, etc.)

Ecosystem — Release Radar

• 📰 Live release feed for React Native ecosystem packages
• 🏷️ Tags: NEW, BREAK, security patches
• 🔍 Filter by category: Updates, Trending, Tips, Security
• 📊 Quick stats sidebar

Insights — Project Analytics

• 📈 KPI cards: Audit Score, Outdated Deps, Agent Tasks (with deltas)
• 📊 Agent utilization breakdown with horizontal bar chart

Context Sidebar

The sidebar auto-enables with the dashboard and provides 6 collapsible panels:

• 🖥️ System Info — project metadata, environment checks, git branch
• 🔍 Project Audit — 22-point score with one-click FIX buttons and strength checks
• 📋 Agent Activity — real-time task history with timestamps
• 💾 Context Savings — live savings percentage, KB saved, and event timeline
• 📚 Knowledge Base — FTS5-powered search across 5 categories (pattern, decision, error, api, component)
• 💰 Context Budget — set session/agent token limits, choose overflow strategy (truncate / warn / stop)

Context optimization runs automatically — no flags or configuration needed. See Context Optimization for details.

🎯 Multi-Agent Orchestration

ERNE supports coordinated multi-agent workflows through the pipeline orchestrator:

/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 for context passing between agents. See Pipeline Documentation for details.

🤖 Agents

Each agent has a distinct personality, quantified success metrics, and memory integration for cross-session learning.

🧠 Context Optimization

ERNE includes a built-in context intelligence system that reduces tool output bloat by 97–100%, preserves exact code examples via FTS5 search, and manages your context budget — all auto-enabled with the dashboard.

erne dashboard   # Context system starts automatically

Benchmark-verified savings

Real numbers: 537 KB of tool outputs → 2.6 KB of context. That's 0.4% of a 200K context window instead of 44.5%. See BENCHMARK.md for the full 21-scenario breakdown.

How it works

Tool Output ──▶ Smart Summarizer ──▶ 97-100% compression (14 content types)
                     │
Raw Docs ──▶ FTS5 Index+Search ──▶ 80% savings, exact code preserved
                     │
Session Events ──▶ Session Tracker ──▶ Error→Fix correlation
                     │
Knowledge ──▶ 3-Layer Search (FTS5 → Trigram → Levenshtein)
                     │
Session End ──▶ Snapshot (<2KB) ──▶ Next session restores context

Dashboard sidebar panels

The context sidebar (toggle with the chevron button) shows 6 live panels:

• System Info — project metadata, environment health, git branch
• Project Audit — 22-point audit with score, one-click FIX buttons, and strengths
• Agent Activity — real-time task history with timestamps
• Context Savings — live savings percentage, KB saved, and event timeline
• Knowledge Base — searchable entries with category filters (pattern, decision, error, api, component)
• Context Budget — configure session limits and overflow strategy directly from the UI

If the context system is disabled, the sidebar shows an Enable Context button to activate it at runtime.

💰 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

Runtime context optimization (benchmark-verified)

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 for complete results.

🛡️ Hook Profiles

Change profile: set ERNE_PROFILE env var, add <!-- Hook Profile: standard --> to CLAUDE.md, or use /vibe context.

⚡ Commands

🖥️ IDE & Editor Support

ERNE generates adaptive config files for multiple IDEs, but the full agent experience requires Claude Code:

Generated config files:

🏗️ 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.

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:

If you maintain a React Native library, Expo tool, or developer service — let's talk.

📦 Available On

• npm — npx erne-universal init
• SkillsMP — Auto-indexed from GitHub
• BuildWithClaude — Plugin directory
• VoltAgent/awesome-agent-skills — Curated skills list

📖 Documentation

📜 License

MIT License — use freely, commercially or personally.