apex

APEX - Stop Your AI From Making The Same Mistakes Twice

APEX gives AI assistants memory, learning, and pattern recognition for 40-55% faster development

# See APEX in action - no installation required!
npx @benredmond/apex start

🌍 Universal Compatibility

APEX now works everywhere - no compilation, no native module errors, just intelligence:

• ✅ Works on Node.js 14+ - Supports all modern Node versions
• 📦 93% smaller package - Reduced from 66.8MB to ~5MB
• 🚀 Zero compilation required - No build tools or Python needed
• 🎯 Automatic optimization - Uses the fastest available SQLite adapter
• 🛡️ Always works - Graceful fallback ensures compatibility

The Problem

Your AI coding assistant is powerful, but it:

• 🔄 Repeats the same mistakes
• 🤷 Doesn't learn from your codebase
• 📋 Lacks memory between sessions
• 🎯 Misses patterns that could save hours

The Solution

APEX transforms your AI assistant into an intelligent development partner that learns and improves:

Without APEX: AI suggests generic solution → Often wrong → You fix it → AI forgets
With APEX:    AI recalls what worked → Applies proven patterns → Prevents past failures → Gets smarter

Why APEX?

🎯 Four Key Differentiators

1. Universal Compatibility - Works on any Node.js 14+ without compilation
2. Zero-Runtime Intelligence - No background processes, no performance impact
3. Pattern Evolution - Discovers, validates, and promotes patterns automatically
4. Failure Prevention - Learns from mistakes to prevent repetition

💬 Real Developer Experience

"After 50 tasks, APEX prevented every single MongoDB async/await error that used to waste 30 minutes each time. The pattern system is like having a senior developer's knowledge built into my AI." - APEX User

Getting Started

No compilation required! APEX works instantly on any system with Node.js 14+:

🚀 Try It Now (Recommended)

# Run this in any project - works instantly, no build tools needed
npx @benredmond/apex start

# That's it! APEX is now active in your AI assistant

📦 Install Globally

# Install once, use everywhere
npm install -g @benredmond/apex
apex start

🛠️ CLI Commands

apex start              # Initialize APEX in your project
apex patterns list      # View available patterns
apex patterns search    # Find patterns by text
apex tasks list         # View tasks
apex tasks stats        # Task metrics
apex doctor             # System health check
apex mcp install        # Setup MCP integration

🚀 Workflow Commands (Claude Code Plugin)

/apex:research <task>     # Gather intelligence via parallel agents
/apex:plan <task-id>      # Transform research into architecture
/apex:implement <task-id> # Build and validate code
/apex:ship <task-id>      # Review, commit, and reflect
/apex:execute <task>      # Run full workflow (research → plan → implement → ship)
/apex:debug <task-id>     # Systematic debugging with pattern learning
/apex:review-pr           # Adversarial code review

Your First APEX Workflow

Let's fix a bug using APEX intelligence:

# 1. In your project
npx @benredmond/apex start

# 2. In Claude Code, run the full workflow
/apex:execute "Fix authentication test timeout error"

Or step-by-step for more control:

/apex:research "Fix authentication test timeout error"  # Creates task, gathers intel
/apex:plan T001                                         # Design the fix
/apex:implement T001                                    # Build and test
/apex:ship T001                                         # Review, commit, reflect

What APEX Does Behind the Scenes

🔍 RESEARCH... Spawning parallel agents for intelligence gathering
📚 PATTERNS... Found 3 relevant patterns from database
🏗️ PLAN... Designing architecture with 5 mandatory artifacts
🔨 IMPLEMENT... Building with pattern-guided development
✅ VALIDATE... Running tests until green
🔎 REVIEW... Adversarial code review via specialized agents
📝 REFLECT... Updating pattern trust scores based on outcome

Core Concepts

🧠 APEX Intelligence Engine

Think of APEX as your AI's long-term memory and pattern recognition system:

Your Code → APEX Learns → AI Remembers → Better Suggestions → Less Debugging