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

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 that visualizes all 11 agents working in an animated office environment.

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

Features:

• 🏢 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

🎯 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.

💰 Token Efficiency

ERNE's architecture is designed to minimize token usage through six layered mechanisms:

Result: Typical workflows use 60–67% fewer tokens compared to a naive all-in-context approach.

🛡️ 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 works with every major AI coding assistant out of the box:

All config files are generated adaptively based on your project's detected stack.

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