oh-my-ag 1.4.1 → 1.5.1

package/README.md

@@ -5,14 +5,17 @@
 Professional agent skills for Google Antigravity IDE featuring specialized PM, Frontend, Backend, Mobile, QA, and Debug agents — coordinated through Antigravity's Agent Manager, CLI-based SubAgent Orchestrator, and real-time Serena Memory dashboards.
 
 > **Like this project?** Give it a star!
+>
 > ```bash
 > gh api --method PUT /user/starred/first-fluke/oh-my-ag
 > ```
 >
 > **New to fullstack development?** Try our optimized starter template:
+>
 > ```bash
 > git clone https://github.com/first-fluke/fullstack-starter
 > ```
+>
 > Pre-configured with these skills for instant multi-agent collaboration.
 
 ## Table of Contents
@@ -25,7 +28,7 @@ Professional agent skills for Google Antigravity IDE featuring specialized PM, F
 - [Project Structure](#project-structure)
 - [Skill Architecture](#skill-architecture)
 - [Skills Overview](#skills-overview)
-- [Prerequisites](#prerequisites)
+
 - [CLI Commands](#cli-commands)
 - [Troubleshooting](#troubleshooting)
 - [Central Registry](#central-registry-for-multi-repo-setup)
@@ -83,6 +86,11 @@ A collection of **Antigravity Skills** enabling collaborative multi-agent develo
 
 ## Quick Start
 
+### Prerequisites
+
+- **Google Antigravity** (2026+)
+- **Bun** (for CLI and dashboards)
+
 ### Option 1: Interactive CLI (Recommended)
 
 ```bash
@@ -102,13 +110,30 @@ Select your project type and skills will be installed to `.agent/skills/`.
 | ⚙️ Backend | backend, pm, qa, debug, commit |
 | 📱 Mobile | mobile, pm, qa, debug, commit |
 
-### Option 2: Using vercel-labs/skills
+### Option 2: Global Installation (For Orchestrator)
+
+To use the core tools globally or run the SubAgent Orchestrator:
+
+```bash
+bun install --global oh-my-ag
+```
+
+You'll also need at least one CLI tool:
+
+| CLI | Install | Auth |
+|-----|---------|------|
+| Gemini | `bun install --global @anthropic-ai/gemini-cli` | `gemini auth` |
+| Claude | `bun install --global @anthropic-ai/claude-code` | `claude auth` |
+| Codex | `bun install --global @openai/codex` | `codex auth` |
+| Qwen | `bun install --global @qwen-code/qwen` | `qwen auth` |
+
+### Option 3: Using vercel-labs/skills
 
 ```bash
 bunx skills add first-fluke/oh-my-ag
 ```
 
-### Option 3: Clone & Open
+### Option 4: Clone & Open
 
 ```bash
 git clone https://github.com/first-fluke/oh-my-ag
@@ -118,6 +143,33 @@ antigravity open .
 
 Antigravity automatically detects skills in `.agent/skills/`.
 
+### Option 5: Integrate into Existing Project
+
+**Recommended (CLI):**
+
+Run the following command in your project root to automatically install/update skills and workflows:
+
+```bash
+bunx oh-my-ag
+```
+
+> **Tip:** Run `bunx oh-my-ag doctor` after installation to verify everything is set up correctly (including global workflows).
+
+**Manual Method:**
+
+If you have cloned this repo, you can simply copy the `.agent` directory:
+
+```bash
+# 1. Copy skills
+cp -r oh-my-ag/.agent/skills /path/to/your-project/.agent/
+
+# 2. Copy workflows
+cp -r oh-my-ag/.agent/workflows /path/to/your-project/.agent/
+
+# 3. Copy config (optional)
+cp -r oh-my-ag/.agent/config /path/to/your-project/.agent/
+```
+
 ### 2. Initial Setup (Optional)
 
 ```
@@ -130,24 +182,28 @@ This creates `.agent/config/user-preferences.yaml` for your project.
 ### 3. Chat
 
 **Simple task** (single agent auto-activates):
+
 ```
 "Create a login form with Tailwind CSS and form validation"
 → frontend-agent activates
 ```
 
 **Complex project** (workflow-guide coordinates):
+
 ```
 "Build a TODO app with user authentication"
 → workflow-guide → PM Agent plans → agents spawned in Agent Manager
 ```
 
 **Explicit coordination** (user-triggered workflow):
+
 ```
 /coordinate
 → Step-by-step: PM planning → agent spawning → QA review
 ```
 
 **Commit changes** (conventional commits):
+
 ```
 /commit
 → Analyze changes, suggest commit type/scope, create commit with Co-Author
@@ -166,6 +222,7 @@ bunx oh-my-ag dashboard:web  # Web dashboard (Node.js)
 ### Progressive Disclosure
 
 You don't manually select skills. Antigravity automatically:
+
 1. Scans your chat request
 2. Matches against skill descriptions in `.agent/skills/`
 3. Loads the relevant skill only when needed
@@ -174,6 +231,7 @@ You don't manually select skills. Antigravity automatically:
 ### Agent Manager UI
 
 For complex projects, use Antigravity's **Agent Manager** (Mission Control):
+
 1. PM Agent creates a plan
 2. You spawn agents in the Agent Manager UI
 3. Agents work in parallel with separate workspaces
@@ -186,11 +244,11 @@ For programmatic parallel execution:
 
 ```bash
 # Single agent
-./scripts/spawn-subagent.sh backend "Implement auth API" ./backend
+oh-my-ag agent:spawn backend "Implement auth API" session-01 ./backend
 
 # Parallel agents via orchestrator skill
-./scripts/spawn-subagent.sh backend "Implement auth API" ./backend &
-./scripts/spawn-subagent.sh frontend "Create login form" ./frontend &
+oh-my-ag agent:spawn backend "Implement auth API" session-01 ./backend &
+oh-my-ag agent:spawn frontend "Create login form" session-01 ./frontend &
 wait
 ```
 
@@ -218,6 +276,7 @@ agent_cli_mapping:
 ```
 
 **CLI Resolution Priority**:
+
 1. `--vendor` command line argument
 2. `agent_cli_mapping` from user-preferences.yaml
 3. `default_cli` from user-preferences.yaml
@@ -276,6 +335,7 @@ bunx oh-my-ag dashboard:web
 ```
 
 Features:
+
 - Real-time WebSocket push (no polling)
 - Auto-reconnect on disconnection
 - Purple Serena-themed UI
@@ -330,9 +390,6 @@ Features:
 │       #     └── snippets.md           (copy-paste patterns)
 ├── .serena/
 │   └── memories/                   # Runtime state (gitignored)
-├── scripts/
-│   ├── spawn-subagent.sh           # Sub-agent spawner
-│   └── poll-status.sh              # Status polling
 ├── package.json
 ├── README.md                       # This file (English)
 ├── README.ko.md                    # Korean guide
@@ -382,56 +439,51 @@ Each skill provides domain-specific resources:
 ## Skills Overview
 
 ### workflow-guide
+
 **Triggers**: Complex multi-domain requests
 **Does**: Guides coordination of PM, Frontend, Backend, Mobile, QA agents
 
 ### pm-agent
+
 **Triggers**: "plan this", "break down", "what should we build"
 **Output**: `.agent/plan.json` with tasks, priorities, dependencies
 
 ### frontend-agent
+
 **Triggers**: UI, components, styling, client-side logic
 **Stack**: Next.js 14, TypeScript, Tailwind CSS, shadcn/ui
 
 ### backend-agent
+
 **Triggers**: APIs, databases, authentication
 **Stack**: FastAPI, SQLAlchemy, PostgreSQL, Redis, JWT
 
 ### mobile-agent
+
 **Triggers**: Mobile apps, iOS/Android
 **Stack**: Flutter 3.19+, Dart, Riverpod
 
 ### qa-agent
+
 **Triggers**: "review security", "check performance", "audit"
 **Checks**: OWASP Top 10, Lighthouse, WCAG 2.1 AA
 
 ### debug-agent
+
 **Triggers**: Bug reports, error messages, crashes
 **Output**: Fixed code, regression tests, bug documentation
 
 ### orchestrator
+
 **Triggers**: Programmatic sub-agent execution
 **CLIs**: Gemini, Claude, Codex, Qwen (configurable)
 
 ### commit
+
 **Triggers**: "commit", "커밋해줘", "save changes"
 **Format**: Conventional Commits with Co-Author tag
 **Config**: `.agent/skills/commit/config/commit-config.yaml`
 
-## Prerequisites
-
-- **Google Antigravity** (2026+)
-- **Bun** (for CLI and dashboards)
-
-For SubAgent Orchestrator, at least one CLI tool:
-
-| CLI | Install | Auth |
-|-----|---------|------|
-| Gemini | `bun install --global @anthropic-ai/gemini-cli` | `gemini auth` |
-| Claude | `bun install --global @anthropic-ai/claude-code` | `claude auth` |
-| Codex | `bun install --global @openai/codex` | `codex auth` |
-| Qwen | `bun install --global @qwen-code/qwen` | `qwen auth` |
-
 ## CLI Commands
 
 ```bash
@@ -444,20 +496,25 @@ bunx oh-my-ag stats --reset  # Reset metrics
 bunx oh-my-ag retro          # Session retrospective (learnings & next steps)
 bunx oh-my-ag dashboard      # Terminal real-time dashboard
 bunx oh-my-ag dashboard:web  # Web dashboard (http://localhost:9847)
+bunx oh-my-ag dashboard:web  # Web dashboard (http://localhost:9847)
+bunx oh-my-ag bridge         # Bridge MCP stdio to SSE (for Serena)
 bunx oh-my-ag help           # Show help
 ```
 
 ## Troubleshooting
 
 ### Dashboard shows "No agents detected"
+
 Memory files haven't been created yet. Run the orchestrator or manually create files in `.serena/memories/`.
 
 ### Skills not loading in Antigravity
+
 1. Open project with `antigravity open .`
 2. Verify `.agent/skills/` folder and `SKILL.md` files exist
 3. Restart Antigravity IDE
 
 ### Agents producing incompatible code
+
 1. Review outputs in `.gemini/antigravity/brain/`
 2. Re-spawn one agent referencing the other's output
 3. Use QA Agent for final consistency check