oh-my-antigravity

🚀 Oh My Antigravity (OMA)

Multi-Agent Orchestration Framework for Google Antigravity IDE

⚠️ Status: Early Beta - Core features working, contributions welcome!

🎯 What Is This?

Oh My Antigravity is a multi-agent orchestration framework that transforms Antigravity IDE into a powerful AI development environment with specialized agents.

Key Features

• 🧠 28 Specialized Agents - Oracle, CodeSmith, Pixel, Tester, and more
• 🎭 Smart AI Routing - Auto-selects best AI backend (Codex/Claude/Gemini)
• ⚡ Delegation Protocol - Clear syntax for agent collaboration
• 🔧 Cross-Platform CLI - Works on Windows, macOS, Linux
• 📦 One-Command Install - npx oh-my-antigravity

🚀 Quick Start

Installation

# NPM (recommended)
npx oh-my-antigravity

# Or clone and install
git clone https://github.com/YOUR_USERNAME/oh-my-antigravity.git
cd oh-my-antigravity

# Windows
.\lib\install.ps1

# macOS/Linux
bash lib/install.sh

Basic Usage

# 🎯 Direct Helper (Default)
# Just tell OMA what to do. Sisyphus will plan and execute it (in parallel if possible).
oma "Analyze the project and design a new logo"

# List available skills
oma list

# Install skills globally
oma install sisyphus
oma install oracle

🧠 Project Cortex (Long-Term Memory)

OMA remembers what you did. It stores key project information, decisions, and architectural patterns in a persistent local database.

• Persistent: Memories survive across sessions.
• Project-Scoped: Each project has its own isolated memory.
• Smart Recalls: Sisyphus automatically recalls relevant memories before starting a task.

💻 Commands

Core

• oma list: List all available agents/skills
• oma install <agent>: Install an agent (Global)
• oma install <agent> --project: Install an agent (Project-scoped)
• oma remove <agent>: Remove an agent
• oma update: Update OMA to the latest version

🚀 SubAgents (The Legion)

• oma spawn <agent> "<task>": Spawn an isolated SubAgent for a specific task
  • Example: oma spawn oracle "Research best practices for Next.js auth"
• oma session list: List active/past SubAgent sessions
• oma session result <id>: Get the result of a session

🧠 Memory (Cortex)

• oma memory save "<info>": Save a piece of information
  • Example: oma memory save "Use TailwindCSS v3.4 for this project"
• oma memory recall <query>: Search memories
• oma memory list: Show recent memories

🧠 Core Agents

Orchestrator

• Sisyphus - Master orchestrator, delegates complex tasks

Architecture & Planning

• Prometheus - Strategic planner (Claude Opus)
• Oracle - System architect (Codex)
• Architect - Database/API designer

Development

• CodeSmith - Backend developer (Claude Code)
• Pixel - Frontend/UI specialist (Gemini 3.0 Pro)
• Refactorer - Code quality improver

Quality Assurance

• Tester - Test writer (Codex)
• Debugger - Bug hunter (Codex)
• Security Guard - Security auditor

Data & Research

• Scientist (Low/Mid/High) - Data analysis tiers
• Data Wizard - ETL pipelines
• SQL Master - Database expert
• Librarian - Research & documentation

See all 28 agents →

🎯 AI Backend Routing

OMA automatically selects the best AI for each task:

Task	Agent	AI Backend	Why
Planning	Prometheus	Claude Opus 4.5	Strategic thinking
Architecture	Oracle	Codex	Complex design
Frontend	Pixel	Gemini 3.0 Pro	UI/UX excellence
Backend	CodeSmith	Claude Code	Fast implementation
Debugging	Debugger	Codex	Detailed analysis
Testing	Tester	Codex	Thorough coverage

📖 Documentation

• Agent Catalog - All 28 agents and their specialties
• Delegation Protocol - How agents work together
• AI Backend Mapping - When to use which AI
• CLI Integration - SubAgent spawning guide

🏗️ Project Status

✅ Working

• ✅ 28 agent skill definitions
• ✅ CLI tools (oma, oma-spawn, oma-session)
• ✅ Delegation protocol
• ✅ Documentation

🚧 In Progress

• 🚧 SubAgent config files (5/28 complete)
• 🚧 External CLI integration (Codex/Claude/Gemini)
• 🚧 VS Code extension
• 🚧 NPM package

📋 Planned

• Long-term memory
• Auto-update system
• Community skill sharing

🤝 Contributing

We welcome contributions! This project is in early beta and needs:

• SubAgent configuration files
• CLI integration testing
• Documentation improvements
• Bug reports and feature requests

See CONTRIBUTING.md for guidelines.

📁 Structure

oh-my-antigravity/
├── skills/              28 specialized agent definitions
│   ├── sisyphus/
│   ├── oracle/
│   └── ...
├── subagents/          SubAgent configurations (WIP)
├── workflows/          Slash commands
├── docs/               Documentation
├── bin/                CLI tools
│   ├── oma.ps1        Windows CLI
│   ├── oma            Unix CLI
│   ├── oma-spawn.ps1  SubAgent spawner
│   └── oma-session.ps1 Session manager
└── lib/               Installers

🆚 Comparison

Feature	OMA	Others
Agents	28	4-12
AI Routing	✅ Multi-backend	❌ Single
Delegation	✅ Explicit syntax	⚠️ Implicit
Documentation	✅ Complete	⚠️ Partial
GUI	🚧 VS Code ext	❌

🙏 Acknowledgements

We deeply admire and have drawn inspiration from:

• Oh My Claude Code: Pioneered the concept of agent personas.
• Oh My OpenCode: Demonstrated excellent orchestration patterns.

📜 License

MIT © Oh My Antigravity Team

🔗 Links

• Issues
• Discussions

Made with ❤️ for the Antigravity community

⭐ Star us on GitHub • 🐛 Report bugs • 💡 Request features