<div align="center">

```
 █████╗ ██╗   ██╗██████╗ ██╗   ██╗ ██████╗ ███╗   ██╗
██╔══██╗██║   ██║██╔══██╗╚██╗ ██╔╝██╔═══██╗████╗  ██║
███████║██║   ██║██████╔╝ ╚████╔╝ ██║   ██║██╔██╗ ██║
██╔══██║██║   ██║██╔══██╗  ╚██╔╝  ██║   ██║██║╚██╗██║
██║  ██║╚██████╔╝██║  ██║   ██║   ╚██████╔╝██║ ╚████║
╚═╝  ╚═╝ ╚═════╝ ╚═╝  ╚═╝   ╚═╝    ╚═════╝ ╚═╝  ╚═══╝
```

**The AI agent OS for vibe coders.**
MCP server + CLI audit suite for Claude Code, Cursor, Windsurf, Lovable & Cline.

[![npm](https://img.shields.io/npm/v/vibeauryon?color=6366f1&label=vibeauryon&style=flat-square)](https://www.npmjs.com/package/vibeauryon)
[![npm downloads](https://img.shields.io/npm/dm/vibeauryon?color=6366f1&style=flat-square)](https://www.npmjs.com/package/vibeauryon)
[![npm downloads total](https://img.shields.io/npm/dt/vibeauryon?color=6366f1&label=total%20downloads&style=flat-square)](https://www.npmjs.com/package/vibeauryon)
[![license](https://img.shields.io/badge/license-MIT-6366f1?style=flat-square)](https://vibecodings.com.br)

```bash
npx vibeauryon@latest
```

[**→ Free Token**](https://vibecodings.com.br/auryon) · [**→ Go Pro**](https://vibecodings.com.br) · [**→ Docs**](https://vibecodings.com.br)

</div>

---

## What is VibeAuryon?

You built the whole app with AI. It looks great, works great, deployed. But:

- 🔑 There's an OpenAI API key hardcoded in the repo
- 🔓 Three admin routes have no authentication
- 📉 Google gives your site a 43 performance score
- 🔍 You don't appear in any search results
- ✍️ Your main CTA says "Learn More"

**VibeAuryon** fixes all of this. It's a hub that installs and orchestrates 5 specialized AI agents that audit every layer of your product — security, copy, design, SEO and speed. Plus a full MCP OS for your code agent with 76+ tools, 8 dev personas and persistent project memory.

---

## The 5 Agents

```
┌─────────────────────────────────────────────────────────┐
│                    VIBEAURYON HUB                       │
│                                                         │
│   🔐 CIPHER     Security & vulnerabilities              │
│   ✏️  AETHRAS    Copy & conversion                       │
│   🎨 CHROMA     Design tokens & visual identity         │
│   📈 SYNTHEX    SEO & visibility                        │
│   ⚡ VIVAX      Speed & performance                     │
│                                                         │
│   Each agent: score 0–100 + critical findings + skills  │
└─────────────────────────────────────────────────────────┘
```

| Agent | What it finds | Install |
|-------|--------------|---------|
| 🔐 **CIPHER** | Exposed API keys, unauth routes, real CVEs | `npx vibecipher` |
| ✏️ **AETHRAS** | Weak CTAs, lorem ipsum, generic headlines | `npx vibeaethras` |
| 🎨 **CHROMA** | WCAG contrast fails, hardcoded colors, inconsistent palette | `npx vibechroma` |
| 📈 **SYNTHEX** | Sitemap, meta tags, Open Graph, missing H1 | `npx vibesynthex` |
| ⚡ **VIVAX** | Real LCP, CLS, TBT via Google PageSpeed API | `npx vibevivax` |

---

## MCP Server — Works inside your code agent

VibeAuryon installs a full MCP (Model Context Protocol) server inside Claude Code, Cursor, Windsurf, Cline, Lovable, GitHub Copilot, Gemini CLI or Codex:

```
┌──────────────────────────────────────────────────────────┐
│    YOUR CODE AGENT                                       │
│    Claude Code · Cursor · Windsurf · Cline · Lovable    │
└─────────────────────┬────────────────────────────────────┘
                      │  MCP Protocol
                      ▼
┌──────────────────────────────────────────────────────────┐
│                  VIBEAURYON OS                           │
│                                                          │
│  ┌────────────┐  ┌─────────────┐  ┌──────────────────┐  │
│  │ 170+ Codes │  │  8 Personas │  │  4 Workflows     │  │
│  │  ready     │  │  dev senior │  │  SDC·QA·Spec·BF  │  │
│  └────────────┘  └─────────────┘  └──────────────────┘  │
│                                                          │
│  ┌────────────┐  ┌─────────────┐  ┌──────────────────┐  │
│  │  Missions  │  │   Memory    │  │   76+ Tools      │  │
│  │  & Tasks   │  │  persistent │  │   ready to use   │  │
│  └────────────┘  └─────────────┘  └──────────────────┘  │
└─────────────────────┬────────────────────────────────────┘
                      │
                      ▼
┌──────────────────────────────────────────────────────────┐
│           .vibeauryon/ (Project Runtime)                 │
│   missions/  tasks/  memory/  decisions/  metrics/       │
└──────────────────────────────────────────────────────────┘
```

---

## Install in 30 seconds

```bash
# Run the installer
npx vibeauryon@latest

# Connect your account
npx vibeauryon@latest login

# Choose your code agent
# → Claude Code / Cursor / Windsurf / Cline / Lovable / Copilot / Gemini CLI / Codex
```

Done. Your agent now has VibeAuryon active.

> Short alias: `npx auryon`

---

## 76+ Slash Commands

```bash
# Code quality
/vibe-review       # Code review: bugs, edge cases, security
/vibe-test         # Generate Jest/Vitest/Playwright tests
/vibe-audit        # Tech debt, console leaks, secrets, large files
/vibe-security     # Scan: XSS, SQLi, hardcoded secrets
/vibe-speed        # Performance: LCP, INP, CLS, TTI

# Development
/vibe-dev          # Implementation without TypeScript errors
/vibe-bug          # Structured debug with hypotheses and checklist
/vibe-refactor     # Refactor suggestions with before/after
/vibe-explain      # Explains code like a senior dev
/vibe-commit       # Conventional Commits generated from diff

# Planning
/vibe-spec         # Idea → executable spec in 6 phases
/vibe-story        # User story with testable Acceptance Criteria
/vibe-architect    # Complexity assessment + trade-off docs
/vibe-adr          # Architecture Decision Record
/vibe-pr           # Full PR description from the diff

# Management
/vibe-mission      # Start mission with tasks and tracking
/vibe-backlog      # Feature backlog with priorities
/vibe-metrics      # Dev metrics dashboard
/vibe-memory       # View/record project memory
/vibe-workflow     # Select the right workflow for each situation
```

---

## 8 Dev Personas & Squads

```
PERSONAS                         SQUADS
─────────────────────            ──────────────────────────────
🧑‍💻 Dev      → implementation    🚀 Fullstack   → full feature
🧪 QA       → quality           🔍 QA-Focused  → max quality
🏛️ Architect → decisions         ⚡ Minimal     → quick bug fix
📋 PM        → product           🎨 Design      → UI/UX first
📊 Data      → database          🚢 Release     → safe deploy
🎨 UX        → experience
⚙️ DevOps    → infra
🔬 Analyst   → research
```

---

## Free vs PRO

```
┌──────────────────────────────┬─────────────────────────────────────┐
│            FREE              │                PRO                  │
├──────────────────────────────┼─────────────────────────────────────┤
│  ✅ Free token via email     │  ✅ Everything in Free              │
│  ✅ Full audit suite         │  ✅ 170+ VibeCodes components       │
│  ✅ 12 skills per agent      │  ✅ 30 skills per agent             │
│  ✅ Score + real criticals   │  ✅ 76+ specialized tools           │
│  ✅ No credit card needed    │  ✅ 8 senior dev personas           │
│  ✅ No time limit            │  ✅ Live URL analysis               │
│                              │  ✅ Audit history                   │
│                              │  ✅ Missions, Tasks, ADR Engine     │
│                              │  ✅ Persistent project memory       │
├──────────────────────────────┼─────────────────────────────────────┤
│  vibecodings.com.br/auryon   │  vibecodings.com.br                 │
└──────────────────────────────┴─────────────────────────────────────┘
```

---

## Supported Code Agents

| Agent | Status |
|-------|--------|
| Claude Code | ✅ Supported |
| Cursor | ✅ Supported |
| Windsurf | ✅ Supported |
| Lovable | ✅ Supported |
| Cline / Roo Code | ✅ Supported |
| GitHub Copilot | ✅ Supported |
| Gemini CLI | ✅ Supported |
| OpenAI Codex | ✅ Supported |

---

## How it works

```
npx vibeauryon
  ↓
┌──────────────────────────────────────────────────────────┐
│  Select an agent to audit your project:                  │
│                                                          │
│  ❯ 🔐 CIPHER   — Security & vulnerabilities             │
│    ✏️  AETHRAS  — Copy & conversion                      │
│    🎨 CHROMA   — Design & visual identity               │
│    📈 SYNTHEX  — SEO & visibility                       │
│    ⚡ VIVAX    — Speed & performance                    │
│    ⚙️  Configure account                                 │
└──────────────────────────────────────────────────────────┘
  ↓
Select agent → run analysis → score + findings list
  ↓
Report saved in .vibeauryon/
```

---

<div align="center">

**Start free — no credit card required**

```bash
npx vibeauryon
```

[vibecodings.com.br](https://vibecodings.com.br)

---

Made with ♥ by [VibeCodes](https://vibecodings.com.br)

</div>
