oh-my-orq
v1.1.7
Published
Multi-agent orchestration framework for AI-powered application generation — 28 specialized agents with shared memory, token optimization, and usage dashboard
Maintainers
sjstar007Readme
⚡ oh-my-orq
Multi-Agent Orchestration Framework for AI-Powered Application Generation
30 specialized AI agents working together to build any application from scratch — featuring shared project memory, continuous codebase learning, 14-feature token optimization, Model Context Protocol (MCP) support, Hermes notification agent, visual themes, and a live web dashboard.
✨ Features
- 🧠 30 Specialized Agents — Apex-1, Atlas, Forge, Nova, Aegis, Sync, Link, Hermes, and more
- 🎭 Smart AI Backend Routing — Auto-selects best AI model (GPT/Claude/Gemini) per task & complexity
- ⚡ Delegation Protocol — Structured
[DELEGATE TO: <agent>]inter-agent communication syntax - 🧠 Shared Memory (Project Cortex) — Persistent, project-scoped SQLite/JSON memory surviving IDE restarts
- 🧠 Continuous Learning Engine — Auto-detects codebase conventions (
ES6/CommonJS,camelCase/snake_case, async & error patterns) - ☤ Hermes Autonomous Messaging — Desktop notifications, Slack/Discord webhooks, and inter-agent message logs
- 🗜️ 14-Feature Token Optimization:
- Delta Mode — Re-reads send unified diffs instead of full files (saves 85-95%)
- Code Skeletons — Large file re-reads return AST-style signatures & imports
- Output Compressor — Condenses
pytest,npm test,git log,grepoutput - Progressive Disclosure (
expand) — Tool outputs > 4KB are archived to disk with retrieval pointers - Compaction Checkpoints & Intel Digest — Auto-restores state after IDE context compaction
- Loop Detector — Alerts when agents get stuck in failing tool retry loops
- Keep-Warm Cache Pinger — Keeps API prompt caches alive
- Quality Scoring & Coach Mode (
orq coach) — Real-time S–F context health grades and 30-day token waste audits
- 🔌 Model Context Protocol (MCP) Support — Pre-configured MCP integration for GitHub, PostgreSQL, Filesystem, and Web Search
- 🎨 Visual Theme Engine — Presets for
default-dark,cyberpunk,dracula,nord - 📊 Token Usage Dashboard — Beautiful web dashboard showing usage per model with pricing & budget monitor
- 🔧 Cross-Platform CLI — Works on Windows, macOS, Linux
- 📦 One-Command Install —
npx oh-my-orq
🏗️ Architecture & Internal Wireframe
- Internal Wireframe & Interaction Map — Detailed block diagrams showing how Agents, Hooks, Shared Storage (Cortex), MCP Gateway, and Hermes interact.
- Architecture & IDE Usage Guide — Execution sequence diagrams, flowcharts, and Antigravity / VS Code integration steps.
🤖 Full Agent Catalog (30 Specialized Agents)
🏔️ 1. Orchestration & Planning (3 Agents)
| Agent Name | Role / Title | Assigned Model | Primary Specialty |
| :--- | :--- | :--- | :--- |
| Apex-1 | Master Orchestrator | Claude Opus 4.8 | Project decomposition, delegation, integration & quality loops |
| Vector | Strategic Planner | Claude Sonnet 5 | 3–7 stage task breakdown, resource & token estimation |
| Aura | Plan Consultant | Claude Sonnet 5 | Plan validation, risk detection, and optimization review |
🏛️ 2. Architecture & Technical Strategy (3 Agents)
| Agent Name | Role / Title | Assigned Model | Primary Specialty |
| :--- | :--- | :--- | :--- |
| Atlas | System Nexus | GPT-5.6 Sol / Opus | System design, tech stack selection, Mermaid diagrams |
| Nexus | Database & API Designer | Claude Sonnet 5 | SQL schemas, OpenAPI specs, REST/GraphQL design |
| Lexicon | Technical Decision Maker | Claude Sonnet 5 | Build vs. buy analysis, trade-off matrices, ROI evaluation |
⚒️ 3. Software Development & Engineering (4 Agents)
| Agent Name | Role / Title | Assigned Model | Primary Specialty |
| :--- | :--- | :--- | :--- |
| Forge | Backend Implementation Expert | Claude Sonnet 5 | Production backend code, SOLID principles, API endpoints |
| Nova | UI/UX & Frontend Specialist | Gemini 2.5 Pro | Modern responsive UI, CSS grid/glassmorphism, Google Fonts |
| Prism | Code Quality Improver | Claude Sonnet 5 | Code smell detection, DRY enforcement, function extraction |
| Pulse | Optimization Specialist | Claude Opus 4.8 | Profiling, database indexing, caching, Core Web Vitals |
🧪 4. Testing, QA & Security (3 Agents)
| Agent Name | Role / Title | Assigned Model | Primary Specialty |
| :--- | :--- | :--- | :--- |
| Aegis | Automated Testing Expert | GPT-5.6 Sol | Unit & integration tests, Jest/pytest, 80%+ coverage target |
| Echo | Manual Testing Specialist | Claude Haiku 4.5 | Test case creation, exploratory testing plans, bug filing |
| Cyber | Security Auditor | Claude Opus 4.8 | OWASP Top 10 audits, input sanitization, secret detection |
📚 5. Research & Documentation (4 Agents)
| Agent Name | Role / Title | Assigned Model | Primary Specialty |
| :--- | :--- | :--- | :--- |
| Veritas | Research Specialist | Claude Haiku 4.5 | Documentation finding, code examples, library research |
| Tracker | Code Navigator | Claude Haiku 4.5 | High-speed ripgrep/grep search, symbol lookup |
| Quill | Technical Writer | Claude Sonnet 5 | README generation, JSDoc, API docs, visual guides |
| Intel | Multi-Repo Analyst | Claude Sonnet 5 | Cross-repository pattern extraction & industry benchmarking |
📊 6. Data & Analytics (5 Agents)
| Agent Name | Role / Title | Assigned Model | Primary Specialty |
| :--- | :--- | :--- | :--- |
| Sigma-Low | Fast Data Tracker | Claude Haiku 4.5 | Quick data loading, descriptive stats, basic cleaning |
| Sigma | Standard Statistical Analyst | Claude Sonnet 5 | Hypothesis testing, regression analysis, quality gates |
| Sigma-High | Advanced Research Specialist | Claude Opus 4.8 | Machine learning, causal inference, time-series forecasting |
| Flow | ETL Pipeline Expert | Claude Sonnet 5 | Data validation, transform pipelines, ETL automation |
| Query | Database Query Specialist | Claude Sonnet 5 | Complex SQL, EXPLAIN ANALYZE, window functions |
🛠️ 7. Tools, Messaging, MCP & DevOps (8 Agents)
| Agent Name | Role / Title | Assigned Model | Primary Specialty |
| :--- | :--- | :--- | :--- |
| Viper | Bug Hunter | GPT-5.6 Sol | Error log analysis, stack trace reading, targeted quick fixes |
| Sync | Version Control & GitHub Expert | Claude Haiku 4.5 | Atomic commits, branch rebase, git pull/push, PR creation |
| Link | Model Context Protocol Specialist | Claude Sonnet 5 | Interfacing with GitHub, PostgreSQL, Web Search MCP servers |
| Hermes | Autonomous Messenger | Claude Haiku 4.5 | System notifications, Slack/Discord webhooks, message logs |
| Matrix | Deployment Specialist | Claude Opus 4.8 | Docker containerization, CI/CD pipelines, cloud deployment |
| Automata | Browser Automation Expert | Claude Sonnet 5 | E2E browser testing, page object models, web scraping |
| Vision | Visual Analysis Expert | Claude Opus 4.8 | UI screenshot reviews, diagram parsing, OCR text extraction |
| Orq-01 | Framework Demo Agent | Claude Haiku 4.5 | Framework tutorials, installation verification & examples |
🚀 Quick Start & Installation
# Global Installation (Required)
npm i -g oh-my-orq
# Instant Setup via NPX
npx oh-my-orq💬 IDE Slash Commands & Multi-Agent Orchestration
Simply type any of these slash commands in your IDE chat (Antigravity, Cursor, VS Code):
| Slash Command | Orchestrator Agent | Action / Execution Flow |
| :--- | :--- | :--- |
| /orq <prompt> | Apex-1 | Full autonomous execution pipeline (/orq-plan → /orq-implement → /orq-review) |
| /orq-plan <prompt> | Apex-1 → Vector, Aura, Atlas, Nexus | Strategic 3–7 stage planning, architectural review & API spec design |
| /orq-implement <prompt> | Apex-1 → Forge, Nova, Link, Sync | Backend logic, frontend UI/UX, MCP integration & git commits |
| /orq-review <prompt> | Apex-1 → Prism, Pulse, Aegis, Cyber | Code quality refactoring, profiling, automated testing & OWASP audit |
📦 Agent Installation Commands
# Install All 30 Agents (Global / Antigravity IDE)
orq install all
# Install All 30 Agents into Current Project (.agents/skills)
orq install all --project
# Install Master Orchestrator Agent Only (Apex-1 orchestrates all subagents)
orq install apex-1
# Install Master Orchestrator into Current Project (.agents/skills)
orq install apex-1 --project📋 CLI Commands
# Agent Catalog
orq list # List all 30 agents and their specialties
# Agent Management
orq install <agent|all|apex-1> [--project] # Install all, apex-1, or specific agent
orq remove <agent> # Remove an agent
# Messaging & Notifications (Hermes)
orq notify "<message>" # Send desktop / system notification via Hermes
# Learning & Optimization
orq learn # Scan codebase & extract continuous learning patterns
orq coach # Run Token Coach audit & context health grade
orq expand [id] # Retrieve or list archived progressive disclosure outputs
orq compact-restore [session] # Generate post-compaction Context Intel Digest
orq theme [name] # List or switch visual themes (cyberpunk, dracula, nord)
# Memory & Dashboard
orq memory save "..." # Save a project memory
orq memory recall "..." # Search memories
orq tokens # Show token usage summary
orq dashboard # Open web dashboard🔌 Model Context Protocol (MCP)
AgentForge includes native MCP support via the link agent and mcp/mcp_config.json:
- GitHub MCP: Pull requests, issue management, code tree search
- Postgres MCP: Schema inspection and parameterized database queries
- Filesystem MCP: Local storage navigation
- Web Search MCP: Real-time documentation search
cp mcp/mcp_config.json ~/.gemini/antigravity/mcp_config.json🤝 Contributing
We welcome contributions! See CONTRIBUTING.md for guidelines on adding Agent Skills, MCP Servers, Themes, and Workflows.
📄 License
MIT License — see LICENSE for details.