oh-my-agent 2.4.2 → 2.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +26 -24
- package/bin/cli.js +285 -270
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -27,17 +27,17 @@ flowchart TD
|
|
|
27
27
|
direction TB
|
|
28
28
|
W0["/brainstorm"]
|
|
29
29
|
W1["/coordinate"]
|
|
30
|
-
W1b["/
|
|
30
|
+
W1b["/ultrawork"]
|
|
31
31
|
W2["/orchestrate"]
|
|
32
32
|
W3["/plan"]
|
|
33
33
|
W4["/review"]
|
|
34
34
|
W5["/debug"]
|
|
35
|
+
W6["/deepinit"]
|
|
35
36
|
end
|
|
36
37
|
|
|
37
38
|
subgraph Orchestration["Orchestration"]
|
|
38
39
|
direction TB
|
|
39
40
|
PM[pm-agent]
|
|
40
|
-
WF[workflow-guide]
|
|
41
41
|
ORC[orchestrator]
|
|
42
42
|
end
|
|
43
43
|
|
|
@@ -77,7 +77,7 @@ flowchart TD
|
|
|
77
77
|
| Tool / IDE | Skills Source | Interop Mode | Notes |
|
|
78
78
|
|------------|---------------|--------------|-------|
|
|
79
79
|
| Antigravity | `.agents/skills/` | Native | Primary source-of-truth layout |
|
|
80
|
-
| Claude Code | `.claude/skills/`
|
|
80
|
+
| Claude Code | `.claude/skills/` + `.claude/agents/` | Native + Adapter | Symlinks for domain skills + native workflow skills, subagents, and CLAUDE.md |
|
|
81
81
|
| OpenCode | `.agents/skills/` | Native-compatible | Uses the same project-level skill source |
|
|
82
82
|
| Amp | `.agents/skills/` | Native-compatible | Shares the same project-level source |
|
|
83
83
|
| Codex CLI | `.agents/skills/` | Native-compatible | Works from the same project skill source |
|
|
@@ -86,6 +86,17 @@ flowchart TD
|
|
|
86
86
|
|
|
87
87
|
See [SUPPORTED_AGENTS.md](https://github.com/first-fluke/oh-my-agent/blob/main/docs/SUPPORTED_AGENTS.md) for the current support matrix and interoperability notes.
|
|
88
88
|
|
|
89
|
+
### Claude Code Native Integration
|
|
90
|
+
|
|
91
|
+
Claude Code has first-class native integration beyond symlinks:
|
|
92
|
+
|
|
93
|
+
- **`CLAUDE.md`** — project identity, architecture, and rules (auto-loaded by Claude Code)
|
|
94
|
+
- **`.claude/skills/`** — 12 workflow skills mapped from `.agents/workflows/` (e.g., `/orchestrate`, `/coordinate`, `/ultrawork`)
|
|
95
|
+
- **`.claude/agents/`** — 7 subagent definitions spawned via Task tool (backend-impl, frontend-impl, mobile-impl, db-impl, qa-reviewer, debug-investigator, pm-planner)
|
|
96
|
+
- **Native loop patterns** — Review Loop, Issue Remediation Loop, and Phase Gate Loop using synchronous Task tool results instead of CLI polling
|
|
97
|
+
|
|
98
|
+
Domain skills (backend-agent, frontend-agent, etc.) remain as symlinks from `.agents/skills/`. Workflow skills are native SKILL.md files that reference the corresponding `.agents/workflows/*.md` source of truth.
|
|
99
|
+
|
|
89
100
|
## The `.agents` Spec
|
|
90
101
|
|
|
91
102
|
`oh-my-agent` treats `.agents/` as a portable project convention for agent skills, workflows, and shared context.
|
|
@@ -105,7 +116,6 @@ A collection of **Agent Skills** enabling collaborative multi-agent development.
|
|
|
105
116
|
| Agent | Specialization | Triggers |
|
|
106
117
|
|-------|---------------|----------|
|
|
107
118
|
| **Brainstorm** | Design-first ideation before planning | "brainstorm", "ideate", "explore idea" |
|
|
108
|
-
| **Workflow Guide** | Coordinates complex multi-agent projects | "multi-domain", "complex project" |
|
|
109
119
|
| **PM Agent** | Requirements analysis, task decomposition, architecture | "plan", "break down", "what should we build" |
|
|
110
120
|
| **Frontend Agent** | React/Next.js, TypeScript, Tailwind CSS | "UI", "component", "styling" |
|
|
111
121
|
| **Backend Agent** | FastAPI, PostgreSQL, JWT authentication | "API", "database", "authentication" |
|
|
@@ -123,10 +133,16 @@ A collection of **Agent Skills** enabling collaborative multi-agent development.
|
|
|
123
133
|
### Prerequisites
|
|
124
134
|
|
|
125
135
|
- **AI IDE** (Antigravity, Claude Code, Codex, Gemini, etc.)
|
|
126
|
-
- **Bun** (for CLI and dashboards)
|
|
127
|
-
- **uv** (for Serena setup)
|
|
128
136
|
|
|
129
|
-
### Option 1:
|
|
137
|
+
### Option 1: One-Line Install (Recommended)
|
|
138
|
+
|
|
139
|
+
```bash
|
|
140
|
+
curl -fsSL https://raw.githubusercontent.com/first-fluke/oh-my-agent/main/cli/install.sh | bash
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
Automatically detects and installs missing dependencies (bun, uv), then launches the interactive setup.
|
|
144
|
+
|
|
145
|
+
### Option 2: Manual Install
|
|
130
146
|
|
|
131
147
|
```bash
|
|
132
148
|
# Install bun if you don't have it:
|
|
@@ -149,7 +165,7 @@ Select your project type and skills will be installed to `.agents/skills/`, with
|
|
|
149
165
|
| 📱 Mobile | brainstorm, mobile, pm, qa, debug, commit |
|
|
150
166
|
| 🚀 DevOps | brainstorm, tf-infra, dev-workflow, pm, qa, debug, commit |
|
|
151
167
|
|
|
152
|
-
### Option
|
|
168
|
+
### Option 3: Global Installation (For Orchestrator)
|
|
153
169
|
|
|
154
170
|
To use the core tools globally or run the SubAgent Orchestrator:
|
|
155
171
|
|
|
@@ -166,20 +182,6 @@ You'll also need at least one CLI tool:
|
|
|
166
182
|
| Codex | `bun install --global @openai/codex` | `codex auth` |
|
|
167
183
|
| Qwen | `bun install --global @qwen-code/qwen` | `qwen auth` |
|
|
168
184
|
|
|
169
|
-
### Option 3: Integrate into Existing Project
|
|
170
|
-
|
|
171
|
-
**Recommended (CLI):**
|
|
172
|
-
|
|
173
|
-
Run the following command in your project root to automatically install/update skills and workflows:
|
|
174
|
-
|
|
175
|
-
```bash
|
|
176
|
-
bunx oh-my-agent
|
|
177
|
-
```
|
|
178
|
-
|
|
179
|
-
> **Tip:** Run `bunx oh-my-agent doctor` after installation to verify everything is set up correctly (including global workflows).
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
185
|
### 2. Chat
|
|
184
186
|
|
|
185
187
|
**Explicit coordination** (user-triggered workflow):
|
|
@@ -189,11 +191,11 @@ bunx oh-my-agent
|
|
|
189
191
|
→ Step-by-step: PM planning → agent spawning → QA review
|
|
190
192
|
```
|
|
191
193
|
|
|
192
|
-
**Complex project** (workflow
|
|
194
|
+
**Complex project** (/coordinate workflow)::
|
|
193
195
|
|
|
194
196
|
```
|
|
195
197
|
"Build a TODO app with user authentication"
|
|
196
|
-
→
|
|
198
|
+
→ /coordinate → PM Agent plans → agents spawned in Agent Manager
|
|
197
199
|
```
|
|
198
200
|
|
|
199
201
|
**Simple task** (single agent auto-activates):
|