@cloudpftc/opencode-orchestrator 3.6.0 → 3.6.1
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/.opencode/helpers/auto-memory-hook.mjs +104 -0
- package/.opencode/helpers/hook-handler.cjs +223 -0
- package/.opencode/helpers/intelligence.cjs +197 -0
- package/.opencode/helpers/memory.js +83 -0
- package/.opencode/helpers/post-commit +16 -0
- package/.opencode/helpers/pre-commit +26 -0
- package/.opencode/helpers/router.js +66 -0
- package/.opencode/helpers/session.js +127 -0
- package/.opencode/helpers/statusline.cjs +774 -0
- package/.opencode/settings.json +319 -0
- package/package.json +1 -1
- package/v3/@claude-flow/cli/README.md +391 -534
- package/v3/@claude-flow/cli/dist/src/commands/benchmark.js +2 -2
- package/v3/@claude-flow/cli/dist/src/commands/claims.js +1 -1
- package/v3/@claude-flow/cli/dist/src/commands/config.js +1 -1
- package/v3/@claude-flow/cli/dist/src/commands/daemon.js +3 -3
- package/v3/@claude-flow/cli/dist/src/commands/deployment.js +1 -1
- package/v3/@claude-flow/cli/dist/src/commands/doctor.js +1 -1
- package/v3/@claude-flow/cli/dist/src/commands/embeddings.js +1 -1
- package/v3/@claude-flow/cli/dist/src/commands/hooks.js +1 -1
- package/v3/@claude-flow/cli/dist/src/commands/init.js +9 -9
- package/v3/@claude-flow/cli/dist/src/commands/neural.js +1 -1
- package/v3/@claude-flow/cli/dist/src/commands/performance.js +1 -1
- package/v3/@claude-flow/cli/dist/src/commands/plugins.js +1 -1
- package/v3/@claude-flow/cli/dist/src/commands/providers.js +1 -1
- package/v3/@claude-flow/cli/dist/src/commands/security.js +1 -1
- package/v3/@claude-flow/cli/dist/src/commands/start.js +10 -10
- package/v3/@claude-flow/cli/dist/src/commands/status.js +2 -2
- package/v3/@claude-flow/cli/dist/src/commands/transfer-store.js +1 -1
- package/v3/@claude-flow/cli/dist/src/memory/memory-initializer.d.ts +1 -1
- package/v3/@claude-flow/cli/dist/src/memory/memory-initializer.js +1 -1
- package/v3/@claude-flow/cli/dist/src/plugins/store/discovery.js +1 -1
- package/v3/@claude-flow/cli/dist/src/runtime/headless.js +3 -3
- package/v3/@claude-flow/cli/dist/src/services/claim-service.js +1 -1
- package/v3/@claude-flow/cli/dist/src/types.d.ts +1 -1
- package/v3/@claude-flow/cli/dist/src/types.js +1 -1
- package/v3/@claude-flow/cli/package.json +1 -1
- package/v3/@claude-flow/cli/dist/src/init/claudemd-generator.d.ts +0 -25
- package/v3/@claude-flow/cli/dist/src/init/claudemd-generator.js +0 -486
|
@@ -1,40 +1,40 @@
|
|
|
1
|
-
#
|
|
1
|
+
# OpenCode Orchestrator v3.5: Enterprise AI Orchestration Platform
|
|
2
2
|
|
|
3
3
|
<div align="center">
|
|
4
4
|
|
|
5
|
-

|
|
6
6
|
|
|
7
7
|
|
|
8
8
|
|
|
9
|
-
[](https://github.com/pedrocosta95/opencode-orchestrator)
|
|
10
10
|
|
|
11
|
-
[](https://github.com/pedrocosta95/opencode-orchestrator)
|
|
12
12
|
[](https://www.npmjs.com/package/claude-flow)
|
|
13
13
|
[](https://www.npmjs.com/package/claude-flow)
|
|
14
14
|
[](https://ruv.io)
|
|
15
15
|
[](https://discord.com/invite/dfxmpwkG2D)
|
|
16
|
-
[](https://github.com/opencode-ai/opencode)
|
|
17
17
|
[](https://opensource.org/licenses/MIT)
|
|
18
18
|
---
|
|
19
19
|
[](https://x.com/ruv)
|
|
20
20
|
[](https://www.linkedin.com/in/reuvencohen/)
|
|
21
21
|
[](https://www.youtube.com/@ReuvenCohen)
|
|
22
22
|
|
|
23
|
-
# **Production-ready multi-agent AI orchestration for
|
|
23
|
+
# **Production-ready multi-agent AI orchestration for OpenCode**
|
|
24
24
|
*Deploy 60+ specialized agents in coordinated swarms with self-learning capabilities, fault-tolerant consensus, and enterprise-grade security.*
|
|
25
25
|
|
|
26
26
|
</div>
|
|
27
27
|
|
|
28
|
-
> **Why
|
|
28
|
+
> **Why OpenCode Orchestrator?** OpenCode Orchestrator (formerly Claude Flow/Ruflo) — named by Ruv, who loves Rust, flow states, and building things that feel inevitable. The "Ru" is the Ruv. The "flo" is the flow. Underneath, WASM kernels written in Rust power the policy engine, embeddings, and proof system. This version is built for OpenCode - the open source AI coding assistant.
|
|
29
29
|
|
|
30
30
|
## Getting into the Flow
|
|
31
31
|
|
|
32
|
-
|
|
32
|
+
OpenCode Orchestrator is a comprehensive AI agent orchestration framework that integrates with OpenCode to provide powerful multi-agent development capabilities. It enables teams to deploy, coordinate, and optimize specialized AI agents working together on complex software engineering tasks.
|
|
33
33
|
|
|
34
34
|
### Self-Learning/Self-Optimizing Agent Architecture
|
|
35
35
|
|
|
36
36
|
```
|
|
37
|
-
User →
|
|
37
|
+
User → OpenCode Orchestrator (CLI/MCP) → Router → Swarm → Agents → Memory → LLM Providers
|
|
38
38
|
↑ ↓
|
|
39
39
|
└──── Learning Loop ←──────┘
|
|
40
40
|
```
|
|
@@ -126,7 +126,7 @@ flowchart TB
|
|
|
126
126
|
style RESOURCES fill:#1a1a2e,stroke:#0f3460
|
|
127
127
|
```
|
|
128
128
|
|
|
129
|
-
**RuVector Components** (included with
|
|
129
|
+
**RuVector Components** (included with OpenCode Orchestrator):
|
|
130
130
|
|
|
131
131
|
| Component | Purpose | Performance |
|
|
132
132
|
|-----------|---------|-------------|
|
|
@@ -142,8 +142,8 @@ flowchart TB
|
|
|
142
142
|
| **9 RL Algorithms** | Q-Learning, SARSA, A2C, PPO, DQN, Decision Transformer, etc. | Task-specific learning |
|
|
143
143
|
|
|
144
144
|
```bash
|
|
145
|
-
# Use RuVector via
|
|
146
|
-
npx
|
|
145
|
+
# Use RuVector via OpenCode Orchestrator
|
|
146
|
+
npx opencode-orchestrator@latest hooks intelligence --status
|
|
147
147
|
```
|
|
148
148
|
|
|
149
149
|
</details>
|
|
@@ -151,14 +151,24 @@ npx ruflo@latest hooks intelligence --status
|
|
|
151
151
|
### Get Started Fast
|
|
152
152
|
|
|
153
153
|
```bash
|
|
154
|
-
#
|
|
155
|
-
|
|
154
|
+
# Clone the repository
|
|
155
|
+
git clone https://github.com/pedrocosta95/opencode-orchestrator.git
|
|
156
|
+
cd opencode-orchestrator
|
|
156
157
|
|
|
157
|
-
#
|
|
158
|
-
|
|
158
|
+
# Install dependencies
|
|
159
|
+
npm install
|
|
159
160
|
|
|
160
|
-
#
|
|
161
|
-
|
|
161
|
+
# Build the project (if needed)
|
|
162
|
+
npm run build
|
|
163
|
+
|
|
164
|
+
# Add as MCP server to OpenCode
|
|
165
|
+
opencode mcp add cloudpftc-orchestrator "npx @cloudpftc/opencode-orchestrator@latest mcp serve"
|
|
166
|
+
|
|
167
|
+
# Or link locally for development
|
|
168
|
+
opencode mcp add cloudpftc-orchestrator "node $(pwd)/bin/cli.js mcp serve"
|
|
169
|
+
|
|
170
|
+
# Initialize a new project
|
|
171
|
+
npx @cloudpftc/opencode-orchestrator@latest init --wizard
|
|
162
172
|
```
|
|
163
173
|
|
|
164
174
|
---
|
|
@@ -172,7 +182,7 @@ npx ruflo@latest init --wizard
|
|
|
172
182
|
|
|
173
183
|
🔌 **Works With Any LLM** - Switch between Claude, GPT, Gemini, Cohere, or local models like Llama. Automatic failover if one provider is unavailable. Smart routing picks the cheapest option that meets quality requirements.
|
|
174
184
|
|
|
175
|
-
⚡ **Plugs Into
|
|
185
|
+
⚡ **Plugs Into OpenCode** - Native integration via MCP (Model Context Protocol). Use opencode-orchestrator commands directly in your OpenCode sessions with full tool access.
|
|
176
186
|
|
|
177
187
|
🔒 **Production-Ready Security** - Built-in protection against prompt injection, input validation, path traversal prevention, command injection blocking, and safe credential handling.
|
|
178
188
|
|
|
@@ -185,11 +195,11 @@ npx ruflo@latest init --wizard
|
|
|
185
195
|
<details>
|
|
186
196
|
<summary>🔄 <strong>Core Flow</strong> — How requests move through the system</summary>
|
|
187
197
|
|
|
188
|
-
Every request flows through four layers: from your CLI or
|
|
198
|
+
Every request flows through four layers: from your CLI or OpenCode interface, through intelligent routing, to specialized agents, and finally to LLM providers for reasoning.
|
|
189
199
|
|
|
190
200
|
| Layer | Components | What It Does |
|
|
191
201
|
|-------|------------|--------------|
|
|
192
|
-
| User |
|
|
202
|
+
| User | OpenCode, CLI | Your interface to control and run commands |
|
|
193
203
|
| Orchestration | MCP Server, Router, Hooks | Routes requests to the right agents |
|
|
194
204
|
| Agents | 60+ types | Specialized workers (coder, tester, reviewer...) |
|
|
195
205
|
| Providers | Anthropic, OpenAI, Google, Ollama | AI models that power reasoning |
|
|
@@ -262,9 +272,9 @@ Background daemons handle security audits, performance optimization, and session
|
|
|
262
272
|
</details>
|
|
263
273
|
|
|
264
274
|
<details>
|
|
265
|
-
<summary>🎯 <strong>Task Routing</strong> — Extend your
|
|
275
|
+
<summary>🎯 <strong>Task Routing</strong> — Extend your OpenCode subscription by 250%</summary>
|
|
266
276
|
|
|
267
|
-
Smart routing skips expensive LLM calls when possible. Simple edits use WASM (free), medium tasks use cheaper models. This can extend your
|
|
277
|
+
Smart routing skips expensive LLM calls when possible. Simple edits use WASM (free), medium tasks use cheaper models. This can extend your OpenCode usage by 250% or save significantly on direct API costs.
|
|
268
278
|
|
|
269
279
|
| Complexity | Handler | Speed |
|
|
270
280
|
|------------|---------|-------|
|
|
@@ -350,7 +360,7 @@ const config = optimizer.getOptimalConfig(agentCount);
|
|
|
350
360
|
<details>
|
|
351
361
|
<summary>🛡️ <strong>Anti-Drift Swarm Configuration</strong> — Prevent goal drift in multi-agent work</summary>
|
|
352
362
|
|
|
353
|
-
Complex swarms can drift from their original goals.
|
|
363
|
+
Complex swarms can drift from their original goals. OpenCode Orchestrator V3 includes anti-drift defaults that prevent agents from going off-task.
|
|
354
364
|
|
|
355
365
|
**Recommended Configuration:**
|
|
356
366
|
|
|
@@ -392,9 +402,9 @@ swarm_init({
|
|
|
392
402
|
|
|
393
403
|
</details>
|
|
394
404
|
|
|
395
|
-
###
|
|
405
|
+
### OpenCode: With vs Without OpenCode Orchestrator
|
|
396
406
|
|
|
397
|
-
| Capability |
|
|
407
|
+
| Capability | OpenCode Alone | OpenCode + OpenCode Orchestrator |
|
|
398
408
|
|------------|-------------------|---------------------------|
|
|
399
409
|
| **Agent Collaboration** | Agents work in isolation, no shared context | Agents collaborate via swarms with shared memory and consensus |
|
|
400
410
|
| **Coordination** | Manual orchestration between tasks | Queen-led hierarchy with 5 consensus algorithms (Raft, Byzantine, Gossip) |
|
|
@@ -420,14 +430,14 @@ swarm_init({
|
|
|
420
430
|
- **Node.js 20+** (required)
|
|
421
431
|
- **npm 9+** / **pnpm** / **bun** package manager
|
|
422
432
|
|
|
423
|
-
**IMPORTANT**:
|
|
433
|
+
**IMPORTANT**: OpenCode must be installed first:
|
|
424
434
|
|
|
425
435
|
```bash
|
|
426
|
-
# 1. Install
|
|
427
|
-
npm install -g
|
|
436
|
+
# 1. Install OpenCode globally
|
|
437
|
+
npm install -g opencode-ai
|
|
428
438
|
|
|
429
|
-
# 2.
|
|
430
|
-
|
|
439
|
+
# 2. Verify installation
|
|
440
|
+
opencode --version
|
|
431
441
|
```
|
|
432
442
|
|
|
433
443
|
### Installation
|
|
@@ -435,11 +445,11 @@ claude --dangerously-skip-permissions
|
|
|
435
445
|
#### One-Line Install (Recommended)
|
|
436
446
|
|
|
437
447
|
```bash
|
|
438
|
-
#
|
|
439
|
-
|
|
448
|
+
# Install globally via npm
|
|
449
|
+
npm install -g @cloudpftc/opencode-orchestrator@latest
|
|
440
450
|
|
|
441
|
-
#
|
|
442
|
-
|
|
451
|
+
# Or use npx (no install needed)
|
|
452
|
+
npx @cloudpftc/opencode-orchestrator@latest --help
|
|
443
453
|
```
|
|
444
454
|
|
|
445
455
|
<details>
|
|
@@ -449,7 +459,7 @@ curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/claude-flow@main/scripts/install.s
|
|
|
449
459
|
|--------|-------------|
|
|
450
460
|
| `--global`, `-g` | Install globally (`npm install -g`) |
|
|
451
461
|
| `--minimal`, `-m` | Skip optional deps (faster, ~15s) |
|
|
452
|
-
| `--setup-mcp` | Auto-configure MCP server for
|
|
462
|
+
| `--setup-mcp` | Auto-configure MCP server for OpenCode |
|
|
453
463
|
| `--doctor`, `-d` | Run diagnostics after install |
|
|
454
464
|
| `--no-init` | Skip project initialization (init runs by default) |
|
|
455
465
|
| `--full`, `-f` | Full setup: global + MCP + doctor |
|
|
@@ -458,10 +468,10 @@ curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/claude-flow@main/scripts/install.s
|
|
|
458
468
|
**Examples:**
|
|
459
469
|
```bash
|
|
460
470
|
# Minimal global install (fastest)
|
|
461
|
-
|
|
471
|
+
npm install -g opencode-orchestrator@latest --omit=optional
|
|
462
472
|
|
|
463
473
|
# With MCP auto-setup
|
|
464
|
-
|
|
474
|
+
opencode-orchestrator init --setup-mcp
|
|
465
475
|
|
|
466
476
|
# Full setup with diagnostics
|
|
467
477
|
curl ... | bash -s -- --full
|
|
@@ -481,14 +491,14 @@ curl ... | bash -s -- --full
|
|
|
481
491
|
|
|
482
492
|
```bash
|
|
483
493
|
# Quick start (no install needed)
|
|
484
|
-
npx
|
|
494
|
+
npx opencode-orchestrator@latest init
|
|
485
495
|
|
|
486
496
|
# Or install globally
|
|
487
|
-
npm install -g
|
|
488
|
-
|
|
497
|
+
npm install -g opencode-orchestrator@latest
|
|
498
|
+
opencode-orchestrator init
|
|
489
499
|
|
|
490
500
|
# With Bun (faster)
|
|
491
|
-
bunx
|
|
501
|
+
bunx opencode-orchestrator@latest init
|
|
492
502
|
```
|
|
493
503
|
|
|
494
504
|
#### Install Profiles
|
|
@@ -500,204 +510,52 @@ bunx ruflo@latest init
|
|
|
500
510
|
|
|
501
511
|
```bash
|
|
502
512
|
# Minimal install (skip ML/embeddings)
|
|
503
|
-
npm install -g
|
|
504
|
-
```
|
|
505
|
-
|
|
506
|
-
<details>
|
|
507
|
-
<summary>🤖 <strong>OpenAI Codex CLI Support</strong> — Full Codex integration with self-learning</summary>
|
|
508
|
-
|
|
509
|
-
Ruflo supports both **Claude Code** and **OpenAI Codex CLI** via the [@claude-flow/codex](https://www.npmjs.com/package/@claude-flow/codex) package, following the [Agentics Foundation](https://agentics.org) standard.
|
|
510
|
-
|
|
511
|
-
### Quick Start for Codex
|
|
512
|
-
|
|
513
|
-
```bash
|
|
514
|
-
# Initialize for Codex CLI (creates AGENTS.md instead of CLAUDE.md)
|
|
515
|
-
npx ruflo@latest init --codex
|
|
516
|
-
|
|
517
|
-
# Full Codex setup with all 137+ skills
|
|
518
|
-
npx ruflo@latest init --codex --full
|
|
519
|
-
|
|
520
|
-
# Initialize for both platforms (dual mode)
|
|
521
|
-
npx ruflo@latest init --dual
|
|
522
|
-
```
|
|
523
|
-
|
|
524
|
-
### Platform Comparison
|
|
525
|
-
|
|
526
|
-
| Feature | Claude Code | OpenAI Codex |
|
|
527
|
-
|---------|-------------|--------------|
|
|
528
|
-
| Config File | `CLAUDE.md` | `AGENTS.md` |
|
|
529
|
-
| Skills Dir | `.claude/skills/` | `.agents/skills/` |
|
|
530
|
-
| Skill Syntax | `/skill-name` | `$skill-name` |
|
|
531
|
-
| Settings | `settings.json` | `config.toml` |
|
|
532
|
-
| MCP | Native | Via `codex mcp add` |
|
|
533
|
-
| Default Model | claude-sonnet | gpt-5.3 |
|
|
534
|
-
|
|
535
|
-
### Key Concept: Execution Model
|
|
536
|
-
|
|
537
|
-
```
|
|
538
|
-
┌─────────────────────────────────────────────────────────────────┐
|
|
539
|
-
│ CLAUDE-FLOW = ORCHESTRATOR (tracks state, stores memory) │
|
|
540
|
-
│ CODEX = EXECUTOR (writes code, runs commands, implements) │
|
|
541
|
-
└─────────────────────────────────────────────────────────────────┘
|
|
542
|
-
```
|
|
543
|
-
|
|
544
|
-
**Codex does the work. Claude-flow coordinates and learns.**
|
|
545
|
-
|
|
546
|
-
### Dual-Mode Integration (Claude Code + Codex)
|
|
547
|
-
|
|
548
|
-
Run Claude Code for interactive development and spawn headless Codex workers for parallel background tasks:
|
|
549
|
-
|
|
550
|
-
```
|
|
551
|
-
┌─────────────────────────────────────────────────────────────────┐
|
|
552
|
-
│ CLAUDE CODE (interactive) ←→ CODEX WORKERS (headless) │
|
|
553
|
-
│ - Main conversation - Parallel background execution │
|
|
554
|
-
│ - Complex reasoning - Bulk code generation │
|
|
555
|
-
│ - Architecture decisions - Test execution │
|
|
556
|
-
│ - Final integration - File processing │
|
|
557
|
-
└─────────────────────────────────────────────────────────────────┘
|
|
558
|
-
```
|
|
559
|
-
|
|
560
|
-
```bash
|
|
561
|
-
# Spawn parallel Codex workers from Claude Code
|
|
562
|
-
claude -p "Analyze src/auth/ for security issues" --session-id "task-1" &
|
|
563
|
-
claude -p "Write unit tests for src/api/" --session-id "task-2" &
|
|
564
|
-
claude -p "Optimize database queries in src/db/" --session-id "task-3" &
|
|
565
|
-
wait # Wait for all to complete
|
|
566
|
-
```
|
|
567
|
-
|
|
568
|
-
| Dual-Mode Feature | Benefit |
|
|
569
|
-
|-------------------|---------|
|
|
570
|
-
| Parallel Execution | 4-8x faster for bulk tasks |
|
|
571
|
-
| Cost Optimization | Route simple tasks to cheaper workers |
|
|
572
|
-
| Context Preservation | Shared memory across platforms |
|
|
573
|
-
| Best of Both | Interactive + batch processing |
|
|
574
|
-
|
|
575
|
-
### Dual-Mode CLI Commands (NEW)
|
|
576
|
-
|
|
577
|
-
```bash
|
|
578
|
-
# List collaboration templates
|
|
579
|
-
npx @claude-flow/codex dual templates
|
|
580
|
-
|
|
581
|
-
# Run feature development swarm (architect → coder → tester → reviewer)
|
|
582
|
-
npx @claude-flow/codex dual run --template feature --task "Add user auth"
|
|
583
|
-
|
|
584
|
-
# Run security audit swarm (scanner → analyzer → fixer)
|
|
585
|
-
npx @claude-flow/codex dual run --template security --task "src/auth/"
|
|
586
|
-
|
|
587
|
-
# Run refactoring swarm (analyzer → planner → refactorer → validator)
|
|
588
|
-
npx @claude-flow/codex dual run --template refactor --task "src/legacy/"
|
|
589
|
-
```
|
|
590
|
-
|
|
591
|
-
### Pre-Built Collaboration Templates
|
|
592
|
-
|
|
593
|
-
| Template | Pipeline | Platforms |
|
|
594
|
-
|----------|----------|-----------|
|
|
595
|
-
| **feature** | architect → coder → tester → reviewer | Claude + Codex |
|
|
596
|
-
| **security** | scanner → analyzer → fixer | Codex + Claude |
|
|
597
|
-
| **refactor** | analyzer → planner → refactorer → validator | Claude + Codex |
|
|
598
|
-
|
|
599
|
-
### MCP Integration for Codex
|
|
600
|
-
|
|
601
|
-
When you run `init --codex`, the MCP server is automatically registered:
|
|
602
|
-
|
|
603
|
-
```bash
|
|
604
|
-
# Verify MCP is registered
|
|
605
|
-
codex mcp list
|
|
606
|
-
|
|
607
|
-
# If not present, add manually:
|
|
608
|
-
codex mcp add ruflo -- npx ruflo mcp start
|
|
513
|
+
npm install -g opencode-orchestrator@latest --omit=optional
|
|
609
514
|
```
|
|
610
515
|
|
|
611
|
-
### Self-Learning Workflow
|
|
612
|
-
|
|
613
|
-
```
|
|
614
|
-
1. LEARN: memory_search(query="task keywords") → Find similar patterns
|
|
615
|
-
2. COORD: swarm_init(topology="hierarchical") → Set up coordination
|
|
616
|
-
3. EXECUTE: YOU write code, run commands → Codex does real work
|
|
617
|
-
4. REMEMBER: memory_store(key, value, namespace="patterns") → Save for future
|
|
618
516
|
```
|
|
619
517
|
|
|
620
|
-
The **Intelligence Loop** (ADR-050) automates this cycle through hooks. Each session automatically:
|
|
621
|
-
- Builds a knowledge graph from memory entries (PageRank + Jaccard similarity)
|
|
622
|
-
- Injects ranked context into every route decision
|
|
623
|
-
- Tracks edit patterns and generates new insights
|
|
624
|
-
- Boosts confidence for useful patterns, decays unused ones
|
|
625
|
-
- Saves snapshots so you can track improvement with `node .claude/helpers/hook-handler.cjs stats`
|
|
626
|
-
|
|
627
|
-
### MCP Tools for Learning
|
|
628
|
-
|
|
629
|
-
| Tool | Purpose | When to Use |
|
|
630
|
-
|------|---------|-------------|
|
|
631
|
-
| `memory_search` | Semantic vector search | BEFORE starting any task |
|
|
632
|
-
| `memory_store` | Save patterns with embeddings | AFTER completing successfully |
|
|
633
|
-
| `swarm_init` | Initialize coordination | Start of complex tasks |
|
|
634
|
-
| `agent_spawn` | Register agent roles | Multi-agent workflows |
|
|
635
|
-
| `neural_train` | Train on patterns | Periodic improvement |
|
|
636
|
-
|
|
637
|
-
### 137+ Skills Available
|
|
638
|
-
|
|
639
|
-
| Category | Examples |
|
|
640
|
-
|----------|----------|
|
|
641
|
-
| **V3 Core** | `$v3-security-overhaul`, `$v3-memory-unification`, `$v3-performance-optimization` |
|
|
642
|
-
| **AgentDB** | `$agentdb-vector-search`, `$agentdb-optimization`, `$agentdb-learning` |
|
|
643
|
-
| **Swarm** | `$swarm-orchestration`, `$swarm-advanced`, `$hive-mind-advanced` |
|
|
644
|
-
| **GitHub** | `$github-code-review`, `$github-workflow-automation`, `$github-multi-repo` |
|
|
645
|
-
| **SPARC** | `$sparc-methodology`, `$sparc:architect`, `$sparc:coder`, `$sparc:tester` |
|
|
646
|
-
| **Flow Nexus** | `$flow-nexus-neural`, `$flow-nexus-swarm`, `$flow-nexus:workflow` |
|
|
647
|
-
| **Dual-Mode** | `$dual-spawn`, `$dual-coordinate`, `$dual-collect` |
|
|
648
|
-
|
|
649
|
-
### Vector Search Details
|
|
650
|
-
|
|
651
|
-
- **Embedding Dimensions**: 384
|
|
652
|
-
- **Search Algorithm**: HNSW (sub-millisecond)
|
|
653
|
-
- **Similarity Scoring**: 0-1 (higher = better)
|
|
654
|
-
- Score > 0.7: Strong match, use pattern
|
|
655
|
-
- Score 0.5-0.7: Partial match, adapt
|
|
656
|
-
- Score < 0.5: Weak match, create new
|
|
657
|
-
|
|
658
|
-
</details>
|
|
659
|
-
|
|
660
518
|
### Basic Usage
|
|
661
519
|
|
|
662
520
|
```bash
|
|
663
521
|
# Initialize project
|
|
664
|
-
npx
|
|
522
|
+
npx opencode-orchestrator@latest init
|
|
665
523
|
|
|
666
|
-
# Start MCP server for
|
|
667
|
-
npx
|
|
524
|
+
# Start MCP server for OpenCode integration
|
|
525
|
+
npx opencode-orchestrator@latest mcp start
|
|
668
526
|
|
|
669
527
|
# Run a task with agents
|
|
670
|
-
npx
|
|
528
|
+
npx opencode-orchestrator@latest --agent coder --task "Implement user authentication"
|
|
671
529
|
|
|
672
530
|
# List available agents
|
|
673
|
-
npx
|
|
531
|
+
npx opencode-orchestrator@latest --list
|
|
674
532
|
```
|
|
675
533
|
|
|
676
534
|
### Upgrading
|
|
677
535
|
|
|
678
536
|
```bash
|
|
679
537
|
# Update helpers and statusline (preserves your data)
|
|
680
|
-
npx
|
|
538
|
+
npx opencode-orchestrator@v3alpha init upgrade
|
|
681
539
|
|
|
682
540
|
# Update AND add any missing skills/agents/commands
|
|
683
|
-
npx
|
|
541
|
+
npx opencode-orchestrator@v3alpha init upgrade --add-missing
|
|
684
542
|
```
|
|
685
543
|
|
|
686
544
|
The `--add-missing` flag automatically detects and installs new skills, agents, and commands that were added in newer versions, without overwriting your existing customizations.
|
|
687
545
|
|
|
688
|
-
###
|
|
546
|
+
### OpenCode MCP Integration
|
|
689
547
|
|
|
690
|
-
Add
|
|
548
|
+
Add opencode-orchestrator as an MCP server for seamless integration:
|
|
691
549
|
|
|
692
550
|
```bash
|
|
693
|
-
# Add
|
|
694
|
-
|
|
551
|
+
# Add opencode-orchestrator MCP server to OpenCode
|
|
552
|
+
opencode mcp add opencode-orchestrator -- npx -y opencode-orchestrator@latest mcp start
|
|
695
553
|
|
|
696
554
|
# Verify installation
|
|
697
|
-
|
|
555
|
+
opencode mcp list
|
|
698
556
|
```
|
|
699
557
|
|
|
700
|
-
Once added,
|
|
558
|
+
Once added, OpenCode can use all 175+ opencode-orchestrator MCP tools directly:
|
|
701
559
|
- `swarm_init` - Initialize agent swarms
|
|
702
560
|
- `agent_spawn` - Spawn specialized agents
|
|
703
561
|
- `memory_search` - Search patterns with HNSW vector search
|
|
@@ -708,13 +566,13 @@ Once added, Claude Code can use all 175+ ruflo MCP tools directly:
|
|
|
708
566
|
## What is it exactly? Agents that learn, build and work perpetually.
|
|
709
567
|
|
|
710
568
|
<details>
|
|
711
|
-
<summary>🆚 <strong>Why
|
|
569
|
+
<summary>🆚 <strong>Why OpenCode Orchestrator v3?</strong></summary>
|
|
712
570
|
|
|
713
|
-
|
|
571
|
+
OpenCode Orchestrator v3 introduces **self-learning neural capabilities** that no other agent orchestration framework offers. While competitors require manual agent configuration and static routing, OpenCode Orchestrator learns from every task execution, prevents catastrophic forgetting of successful patterns, and intelligently routes work to specialized experts.
|
|
714
572
|
|
|
715
573
|
#### 🧠 Neural & Learning
|
|
716
574
|
|
|
717
|
-
| Feature |
|
|
575
|
+
| Feature | OpenCode Orchestrator v3 | CrewAI | LangGraph | AutoGen | Manus |
|
|
718
576
|
|---------|----------------|--------|-----------|---------|-------|
|
|
719
577
|
| **Self-Learning** | ✅ SONA + EWC++ | ⛔ | ⛔ | ⛔ | ⛔ |
|
|
720
578
|
| **Prevents Forgetting** | ✅ EWC++ consolidation | ⛔ | ⛔ | ⛔ | ⛔ |
|
|
@@ -725,7 +583,7 @@ Ruflo v3 introduces **self-learning neural capabilities** that no other agent or
|
|
|
725
583
|
|
|
726
584
|
#### 💾 Memory & Embeddings
|
|
727
585
|
|
|
728
|
-
| Feature |
|
|
586
|
+
| Feature | OpenCode Orchestrator v3 | CrewAI | LangGraph | AutoGen | Manus |
|
|
729
587
|
|---------|----------------|--------|-----------|---------|-------|
|
|
730
588
|
| **Vector Memory** | ✅ HNSW (sub-ms search) | ⛔ | Via plugins | ⛔ | ⛔ |
|
|
731
589
|
| **Knowledge Graph** | ✅ PageRank + communities | ⛔ | ⛔ | ⛔ | ⛔ |
|
|
@@ -740,7 +598,7 @@ Ruflo v3 introduces **self-learning neural capabilities** that no other agent or
|
|
|
740
598
|
|
|
741
599
|
#### 🐝 Swarm & Coordination
|
|
742
600
|
|
|
743
|
-
| Feature |
|
|
601
|
+
| Feature | OpenCode Orchestrator v3 | CrewAI | LangGraph | AutoGen | Manus |
|
|
744
602
|
|---------|----------------|--------|-----------|---------|-------|
|
|
745
603
|
| **Swarm Topologies** | ✅ 4 types | 1 | 1 | 1 | 1 |
|
|
746
604
|
| **Consensus Protocols** | ✅ 5 (Raft, BFT, etc.) | ⛔ | ⛔ | ⛔ | ⛔ |
|
|
@@ -750,7 +608,7 @@ Ruflo v3 introduces **self-learning neural capabilities** that no other agent or
|
|
|
750
608
|
|
|
751
609
|
#### 🔧 Developer Experience
|
|
752
610
|
|
|
753
|
-
| Feature |
|
|
611
|
+
| Feature | OpenCode Orchestrator v3 | CrewAI | LangGraph | AutoGen | Manus |
|
|
754
612
|
|---------|----------------|--------|-----------|---------|-------|
|
|
755
613
|
| **MCP Integration** | ✅ Native (170+ tools) | ⛔ | ⛔ | ⛔ | ⛔ |
|
|
756
614
|
| **Skills System** | ✅ 42+ pre-built | ⛔ | ⛔ | ⛔ | Limited |
|
|
@@ -760,7 +618,7 @@ Ruflo v3 introduces **self-learning neural capabilities** that no other agent or
|
|
|
760
618
|
|
|
761
619
|
#### 🛡️ Security & Platform
|
|
762
620
|
|
|
763
|
-
| Feature |
|
|
621
|
+
| Feature | OpenCode Orchestrator v3 | CrewAI | LangGraph | AutoGen | Manus |
|
|
764
622
|
|---------|----------------|--------|-----------|---------|-------|
|
|
765
623
|
| **Threat Detection** | ✅ AIDefence (<10ms) | ⛔ | ⛔ | ⛔ | ⛔ |
|
|
766
624
|
| **Cloud Platform** | ✅ Flow Nexus | ⛔ | ⛔ | ⛔ | ⛔ |
|
|
@@ -774,7 +632,7 @@ Ruflo v3 introduces **self-learning neural capabilities** that no other agent or
|
|
|
774
632
|
<details>
|
|
775
633
|
<summary>🚀 <strong>Key Differentiators</strong> — Self-learning, memory optimization, fault tolerance</summary>
|
|
776
634
|
|
|
777
|
-
What makes
|
|
635
|
+
What makes OpenCode Orchestrator different from other agent frameworks? These 10 capabilities work together to create a system that learns from experience, runs efficiently on any hardware, and keeps working even when things go wrong.
|
|
778
636
|
|
|
779
637
|
| | Feature | What It Does | Technical Details |
|
|
780
638
|
|---|---------|--------------|-------------------|
|
|
@@ -794,7 +652,7 @@ What makes Ruflo different from other agent frameworks? These 10 capabilities wo
|
|
|
794
652
|
<details>
|
|
795
653
|
<summary>💰 <strong>Intelligent 3-Tier Model Routing</strong> — Save 75% on API costs, extend Claude Max 2.5x</summary>
|
|
796
654
|
|
|
797
|
-
Not every task needs the most powerful (and expensive) model.
|
|
655
|
+
Not every task needs the most powerful (and expensive) model. OpenCode Orchestrator analyzes each request and automatically routes it to the cheapest handler that can do the job well. Simple code transforms skip the LLM entirely using WebAssembly. Medium tasks use faster, cheaper models. Only complex architecture decisions use Opus.
|
|
798
656
|
|
|
799
657
|
**Cost & Usage Benefits:**
|
|
800
658
|
|
|
@@ -820,7 +678,7 @@ Not every task needs the most powerful (and expensive) model. Ruflo analyzes eac
|
|
|
820
678
|
<details>
|
|
821
679
|
<summary>📋 <strong>Spec-Driven Development</strong> — Build complete specs, implement without drift</summary>
|
|
822
680
|
|
|
823
|
-
Complex projects fail when implementation drifts from the original plan.
|
|
681
|
+
Complex projects fail when implementation drifts from the original plan. OpenCode Orchestrator solves this with a spec-first approach: define your architecture through ADRs (Architecture Decision Records), organize code into DDD bounded contexts, and let the system enforce compliance as agents work. The result is implementations that match specifications — even across multi-agent swarms working in parallel.
|
|
824
682
|
|
|
825
683
|
**How It Prevents Drift:**
|
|
826
684
|
|
|
@@ -863,7 +721,7 @@ Complex projects fail when implementation drifts from the original plan. Ruflo s
|
|
|
863
721
|
- **ADR-008**: Vitest testing framework (10x faster than Jest)
|
|
864
722
|
- **ADR-009**: Hybrid Memory Backend (SQLite + HNSW)
|
|
865
723
|
- **ADR-026**: Intelligent 3-tier model routing
|
|
866
|
-
- **ADR-048**: Auto Memory Bridge (
|
|
724
|
+
- **ADR-048**: Auto Memory Bridge (OpenCode ↔ AgentDB bidirectional sync)
|
|
867
725
|
- **ADR-049**: Self-Learning Memory with GNN (LearningBridge, MemoryGraph, AgentMemoryScope)
|
|
868
726
|
|
|
869
727
|
</details>
|
|
@@ -878,7 +736,7 @@ Complex projects fail when implementation drifts from the original plan. Ruflo s
|
|
|
878
736
|
```mermaid
|
|
879
737
|
flowchart TB
|
|
880
738
|
subgraph User["👤 User Layer"]
|
|
881
|
-
CC[
|
|
739
|
+
CC[OpenCode]
|
|
882
740
|
CLI[CLI Commands]
|
|
883
741
|
end
|
|
884
742
|
|
|
@@ -1012,14 +870,14 @@ flowchart LR
|
|
|
1012
870
|
| **LearningBridge** | Connects insights to SONA/ReasoningBank neural pipeline | 0.12 ms/insight |
|
|
1013
871
|
| **MemoryGraph** | PageRank + label propagation knowledge graph | 2.78 ms build (1k nodes) |
|
|
1014
872
|
| **AgentMemoryScope** | 3-scope agent memory (project/local/user) with cross-agent transfer | 1.25 ms transfer |
|
|
1015
|
-
| **AutoMemoryBridge** | Bidirectional sync:
|
|
873
|
+
| **AutoMemoryBridge** | Bidirectional sync: OpenCode auto memory files ↔ AgentDB | ADR-048 |
|
|
1016
874
|
|
|
1017
875
|
</details>
|
|
1018
876
|
|
|
1019
877
|
<details>
|
|
1020
878
|
<summary>🧠 <strong>AgentDB v3 Controllers</strong> — 20+ intelligent memory controllers</summary>
|
|
1021
879
|
|
|
1022
|
-
|
|
880
|
+
OpenCode Orchestrator V3 integrates AgentDB v3 (3.0.0-alpha.10) providing 20+ memory controllers accessible via MCP tools and the CLI.
|
|
1023
881
|
|
|
1024
882
|
**Core Memory:**
|
|
1025
883
|
|
|
@@ -1170,18 +1028,18 @@ flowchart TB
|
|
|
1170
1028
|
|
|
1171
1029
|
## 🔌 Setup & Configuration
|
|
1172
1030
|
|
|
1173
|
-
Connect
|
|
1031
|
+
Connect OpenCode Orchestrator to your development environment.
|
|
1174
1032
|
|
|
1175
1033
|
<details>
|
|
1176
|
-
<summary>🔌 <strong>MCP Setup</strong> — Connect
|
|
1034
|
+
<summary>🔌 <strong>MCP Setup</strong> — Connect OpenCode Orchestrator to Any AI Environment</summary>
|
|
1177
1035
|
|
|
1178
|
-
|
|
1036
|
+
OpenCode Orchestrator runs as an MCP (Model Context Protocol) server, allowing you to connect it to any MCP-compatible AI client. This means you can use OpenCode Orchestrator's 60+ agents, swarm coordination, and self-learning capabilities from Claude Desktop, VS Code, Cursor, Windsurf, ChatGPT, and more.
|
|
1179
1037
|
|
|
1180
1038
|
### Quick Add Command
|
|
1181
1039
|
|
|
1182
1040
|
```bash
|
|
1183
|
-
# Start
|
|
1184
|
-
npx
|
|
1041
|
+
# Start OpenCode Orchestrator MCP server in any environment
|
|
1042
|
+
npx opencode-orchestrator@v3alpha mcp start
|
|
1185
1043
|
```
|
|
1186
1044
|
|
|
1187
1045
|
<details open>
|
|
@@ -1196,9 +1054,9 @@ npx ruflo@v3alpha mcp start
|
|
|
1196
1054
|
```json
|
|
1197
1055
|
{
|
|
1198
1056
|
"mcpServers": {
|
|
1199
|
-
"
|
|
1057
|
+
"opencode-orchestrator": {
|
|
1200
1058
|
"command": "npx",
|
|
1201
|
-
"args": ["
|
|
1059
|
+
"args": ["opencode-orchestrator@v3alpha", "mcp", "start"],
|
|
1202
1060
|
"env": {
|
|
1203
1061
|
"ANTHROPIC_API_KEY": "sk-ant-..."
|
|
1204
1062
|
}
|
|
@@ -1214,22 +1072,22 @@ Restart Claude Desktop after saving. Look for the MCP indicator (hammer icon) in
|
|
|
1214
1072
|
</details>
|
|
1215
1073
|
|
|
1216
1074
|
<details>
|
|
1217
|
-
<summary>⌨️ <strong>
|
|
1075
|
+
<summary>⌨️ <strong>OpenCode (CLI)</strong></summary>
|
|
1218
1076
|
|
|
1219
1077
|
```bash
|
|
1220
1078
|
# Add via CLI (recommended)
|
|
1221
|
-
|
|
1079
|
+
opencode mcp add opencode-orchestrator -- npx opencode-orchestrator@latest mcp start
|
|
1222
1080
|
|
|
1223
1081
|
# Or add with environment variables
|
|
1224
|
-
|
|
1082
|
+
opencode mcp add opencode-orchestrator \
|
|
1225
1083
|
--env ANTHROPIC_API_KEY=sk-ant-... \
|
|
1226
|
-
-- npx
|
|
1084
|
+
-- npx opencode-orchestrator@latest mcp start
|
|
1227
1085
|
|
|
1228
1086
|
# Verify installation
|
|
1229
|
-
|
|
1087
|
+
opencode mcp list
|
|
1230
1088
|
```
|
|
1231
1089
|
|
|
1232
|
-
*Sources: [
|
|
1090
|
+
*Sources: [OpenCode MCP Docs](https://opencode.ai/docs)*
|
|
1233
1091
|
|
|
1234
1092
|
</details>
|
|
1235
1093
|
|
|
@@ -1250,9 +1108,9 @@ Create `.vscode/mcp.json` in your project:
|
|
|
1250
1108
|
```json
|
|
1251
1109
|
{
|
|
1252
1110
|
"mcpServers": {
|
|
1253
|
-
"
|
|
1111
|
+
"opencode-orchestrator": {
|
|
1254
1112
|
"command": "npx",
|
|
1255
|
-
"args": ["
|
|
1113
|
+
"args": ["opencode-orchestrator@v3alpha", "mcp", "start"],
|
|
1256
1114
|
"env": {
|
|
1257
1115
|
"ANTHROPIC_API_KEY": "sk-ant-..."
|
|
1258
1116
|
}
|
|
@@ -1277,9 +1135,9 @@ Create `.cursor/mcp.json` in your project (or global config):
|
|
|
1277
1135
|
```json
|
|
1278
1136
|
{
|
|
1279
1137
|
"mcpServers": {
|
|
1280
|
-
"
|
|
1138
|
+
"opencode-orchestrator": {
|
|
1281
1139
|
"command": "npx",
|
|
1282
|
-
"args": ["
|
|
1140
|
+
"args": ["opencode-orchestrator@v3alpha", "mcp", "start"],
|
|
1283
1141
|
"env": {
|
|
1284
1142
|
"ANTHROPIC_API_KEY": "sk-ant-..."
|
|
1285
1143
|
}
|
|
@@ -1304,9 +1162,9 @@ Create `.cursor/mcp.json` in your project (or global config):
|
|
|
1304
1162
|
```json
|
|
1305
1163
|
{
|
|
1306
1164
|
"mcpServers": {
|
|
1307
|
-
"
|
|
1165
|
+
"opencode-orchestrator": {
|
|
1308
1166
|
"command": "npx",
|
|
1309
|
-
"args": ["
|
|
1167
|
+
"args": ["opencode-orchestrator@v3alpha", "mcp", "start"],
|
|
1310
1168
|
"env": {
|
|
1311
1169
|
"ANTHROPIC_API_KEY": "sk-ant-..."
|
|
1312
1170
|
}
|
|
@@ -1333,11 +1191,11 @@ Click **Refresh** in the MCP settings to connect. Windsurf supports up to 100 MC
|
|
|
1333
1191
|
|
|
1334
1192
|
**Remote Server Setup:**
|
|
1335
1193
|
|
|
1336
|
-
For ChatGPT, you need a remote MCP server (not local stdio). Deploy
|
|
1194
|
+
For ChatGPT, you need a remote MCP server (not local stdio). Deploy opencode-orchestrator to a server with HTTP transport:
|
|
1337
1195
|
|
|
1338
1196
|
```bash
|
|
1339
1197
|
# Start with HTTP transport
|
|
1340
|
-
npx
|
|
1198
|
+
npx opencode-orchestrator@v3alpha mcp start --transport http --port 3000
|
|
1341
1199
|
```
|
|
1342
1200
|
|
|
1343
1201
|
Then add the server URL in ChatGPT Connectors settings.
|
|
@@ -1353,7 +1211,7 @@ Google AI Studio supports MCP natively since May 2025, with managed MCP servers
|
|
|
1353
1211
|
|
|
1354
1212
|
**Using MCP SuperAssistant Extension:**
|
|
1355
1213
|
1. Install [MCP SuperAssistant](https://chrome.google.com/webstore) Chrome extension
|
|
1356
|
-
2. Configure your
|
|
1214
|
+
2. Configure your opencode-orchestrator MCP server
|
|
1357
1215
|
3. Use with Google AI Studio, Gemini, and other AI platforms
|
|
1358
1216
|
|
|
1359
1217
|
**Native SDK Integration:**
|
|
@@ -1366,9 +1224,9 @@ const ai = new GoogleGenAI({ apiKey: 'YOUR_API_KEY' });
|
|
|
1366
1224
|
// MCP definitions are natively supported in the Gen AI SDK
|
|
1367
1225
|
const mcpConfig = {
|
|
1368
1226
|
servers: [{
|
|
1369
|
-
name: '
|
|
1227
|
+
name: 'opencode-orchestrator',
|
|
1370
1228
|
command: 'npx',
|
|
1371
|
-
args: ['
|
|
1229
|
+
args: ['opencode-orchestrator@v3alpha', 'mcp', 'start']
|
|
1372
1230
|
}]
|
|
1373
1231
|
};
|
|
1374
1232
|
```
|
|
@@ -1389,9 +1247,9 @@ JetBrains AI Assistant supports MCP for IntelliJ IDEA, PyCharm, WebStorm, and ot
|
|
|
1389
1247
|
|
|
1390
1248
|
```json
|
|
1391
1249
|
{
|
|
1392
|
-
"name": "
|
|
1250
|
+
"name": "opencode-orchestrator",
|
|
1393
1251
|
"command": "npx",
|
|
1394
|
-
"args": ["
|
|
1252
|
+
"args": ["opencode-orchestrator@v3alpha", "mcp", "start"]
|
|
1395
1253
|
}
|
|
1396
1254
|
```
|
|
1397
1255
|
|
|
@@ -1621,13 +1479,13 @@ The Hive Mind system implements queen-led hierarchical coordination where strate
|
|
|
1621
1479
|
|
|
1622
1480
|
**CLI Commands:**
|
|
1623
1481
|
```bash
|
|
1624
|
-
npx
|
|
1625
|
-
npx
|
|
1626
|
-
npx
|
|
1627
|
-
npx
|
|
1628
|
-
npx
|
|
1629
|
-
npx
|
|
1630
|
-
npx
|
|
1482
|
+
npx opencode-orchestrator hive-mind init # Initialize hive mind
|
|
1483
|
+
npx opencode-orchestrator hive-mind spawn "Build API" # Spawn with objective
|
|
1484
|
+
npx opencode-orchestrator hive-mind spawn "..." --queen-type strategic --consensus byzantine
|
|
1485
|
+
npx opencode-orchestrator hive-mind status # Check status
|
|
1486
|
+
npx opencode-orchestrator hive-mind metrics # Performance metrics
|
|
1487
|
+
npx opencode-orchestrator hive-mind memory # Collective memory stats
|
|
1488
|
+
npx opencode-orchestrator hive-mind sessions # List active sessions
|
|
1631
1489
|
```
|
|
1632
1490
|
|
|
1633
1491
|
**Performance:** Fast batch spawning with parallel agent coordination
|
|
@@ -1641,8 +1499,8 @@ Native integration with Claude Code's experimental Agent Teams feature for spawn
|
|
|
1641
1499
|
|
|
1642
1500
|
**Enable Agent Teams:**
|
|
1643
1501
|
```bash
|
|
1644
|
-
# Automatically enabled with
|
|
1645
|
-
npx
|
|
1502
|
+
# Automatically enabled with opencode-orchestrator init
|
|
1503
|
+
npx opencode-orchestrator@latest init
|
|
1646
1504
|
|
|
1647
1505
|
# Or manually add to .claude/settings.json
|
|
1648
1506
|
{
|
|
@@ -1694,10 +1552,10 @@ TeamDelete()
|
|
|
1694
1552
|
|
|
1695
1553
|
```bash
|
|
1696
1554
|
# Handle idle teammate
|
|
1697
|
-
npx
|
|
1555
|
+
npx opencode-orchestrator@latest hooks teammate-idle --auto-assign true
|
|
1698
1556
|
|
|
1699
1557
|
# Handle task completion
|
|
1700
|
-
npx
|
|
1558
|
+
npx opencode-orchestrator@latest hooks task-completed --task-id <id> --train-patterns
|
|
1701
1559
|
```
|
|
1702
1560
|
|
|
1703
1561
|
**Display Modes:** `auto` (default), `in-process`, `tmux` (split-pane)
|
|
@@ -1774,14 +1632,14 @@ Build custom plugins with the fluent builder API. Create MCP tools, hooks, worke
|
|
|
1774
1632
|
|
|
1775
1633
|
### 📦 Available Optional Plugins
|
|
1776
1634
|
|
|
1777
|
-
Install these optional plugins to extend
|
|
1635
|
+
Install these optional plugins to extend OpenCode Orchestrator capabilities:
|
|
1778
1636
|
|
|
1779
1637
|
| Plugin | Version | Description | Install Command |
|
|
1780
1638
|
|--------|---------|-------------|-----------------|
|
|
1781
1639
|
| **@claude-flow/plugin-agentic-qe** | 3.0.0-alpha.2 | Quality Engineering with 58 AI agents across 12 DDD contexts. TDD, coverage analysis, security scanning, chaos engineering, accessibility testing. | `npm install @claude-flow/plugin-agentic-qe` |
|
|
1782
1640
|
| **@claude-flow/plugin-prime-radiant** | 0.1.4 | Mathematical AI interpretability with 6 engines: sheaf cohomology, spectral analysis, causal inference, quantum topology, category theory, HoTT proofs. | `npm install @claude-flow/plugin-prime-radiant` |
|
|
1783
|
-
| **@claude-flow/plugin-gastown-bridge** | 0.1.0 | Gas Town orchestrator integration with WASM-accelerated formula parsing (352x faster), Beads sync, convoy management, and graph analysis. 20 MCP tools. | `npx
|
|
1784
|
-
| **@claude-flow/teammate-plugin** | 1.0.0-alpha.1 | Native TeammateTool integration for Claude Code v2.1.19+. BMSSP WASM acceleration, rate limiting, circuit breaker, semantic routing. 21 MCP tools. | `npx
|
|
1641
|
+
| **@claude-flow/plugin-gastown-bridge** | 0.1.0 | Gas Town orchestrator integration with WASM-accelerated formula parsing (352x faster), Beads sync, convoy management, and graph analysis. 20 MCP tools. | `npx opencode-orchestrator@latest plugins install -n @claude-flow/plugin-gastown-bridge` |
|
|
1642
|
+
| **@claude-flow/teammate-plugin** | 1.0.0-alpha.1 | Native TeammateTool integration for Claude Code v2.1.19+. BMSSP WASM acceleration, rate limiting, circuit breaker, semantic routing. 21 MCP tools. | `npx opencode-orchestrator@latest plugins install -n @claude-flow/teammate-plugin` |
|
|
1785
1643
|
|
|
1786
1644
|
#### 🏥 Domain-Specific Plugins
|
|
1787
1645
|
|
|
@@ -1851,7 +1709,7 @@ npm install @claude-flow/plugin-agentic-qe
|
|
|
1851
1709
|
npm install @claude-flow/plugin-prime-radiant
|
|
1852
1710
|
|
|
1853
1711
|
# Install Gas Town Bridge plugin (WASM-accelerated orchestration)
|
|
1854
|
-
npx
|
|
1712
|
+
npx opencode-orchestrator@latest plugins install -n @claude-flow/plugin-gastown-bridge
|
|
1855
1713
|
|
|
1856
1714
|
# Install domain-specific plugins
|
|
1857
1715
|
npm install @claude-flow/plugin-healthcare-clinical
|
|
@@ -1870,7 +1728,7 @@ npm install @claude-flow/plugin-quantum-optimizer
|
|
|
1870
1728
|
npm install @claude-flow/plugin-hyperbolic-reasoning
|
|
1871
1729
|
|
|
1872
1730
|
# List all installed plugins
|
|
1873
|
-
npx
|
|
1731
|
+
npx opencode-orchestrator plugins list --installed
|
|
1874
1732
|
```
|
|
1875
1733
|
|
|
1876
1734
|
</details>
|
|
@@ -2039,8 +1897,8 @@ Workers run automatically based on context, or dispatch manually via MCP tools.
|
|
|
2039
1897
|
| **TestGaps** | `testgaps` | Test coverage analysis | Code changes without tests |
|
|
2040
1898
|
|
|
2041
1899
|
```bash
|
|
2042
|
-
npx
|
|
2043
|
-
npx
|
|
1900
|
+
npx opencode-orchestrator@v3alpha worker dispatch --trigger audit --context "./src"
|
|
1901
|
+
npx opencode-orchestrator@v3alpha worker status
|
|
2044
1902
|
```
|
|
2045
1903
|
|
|
2046
1904
|
</details>
|
|
@@ -2264,7 +2122,7 @@ npx ruflo@v3alpha worker status
|
|
|
2264
2122
|
| Feature | Description | Performance |
|
|
2265
2123
|
|---------|-------------|-------------|
|
|
2266
2124
|
| **Multi-Provider** | Agentic-Flow (ONNX), OpenAI, Transformers.js, Mock | 4 providers |
|
|
2267
|
-
| **Auto-Install** | `
|
|
2125
|
+
| **Auto-Install** | `opencode-orchestrator embeddings init` or `createEmbeddingServiceAsync()` | Zero config |
|
|
2268
2126
|
| **75x Faster** | Agentic-flow ONNX SIMD vs Transformers.js | 3ms vs 230ms |
|
|
2269
2127
|
| **Hyperbolic Space** | Poincaré ball model for hierarchical data | Exponential capacity |
|
|
2270
2128
|
| **Dimensions** | 384 to 3072 configurable | Quality vs speed tradeoff |
|
|
@@ -2274,13 +2132,13 @@ npx ruflo@v3alpha worker status
|
|
|
2274
2132
|
|
|
2275
2133
|
```bash
|
|
2276
2134
|
# Initialize ONNX embeddings with hyperbolic config
|
|
2277
|
-
|
|
2135
|
+
opencode-orchestrator embeddings init
|
|
2278
2136
|
|
|
2279
2137
|
# Use larger model for higher quality
|
|
2280
|
-
|
|
2138
|
+
opencode-orchestrator embeddings init --model all-mpnet-base-v2
|
|
2281
2139
|
|
|
2282
2140
|
# Semantic search
|
|
2283
|
-
|
|
2141
|
+
opencode-orchestrator embeddings search -q "authentication patterns"
|
|
2284
2142
|
```
|
|
2285
2143
|
|
|
2286
2144
|
| Mode | Adaptation | Quality | Memory | Use Case |
|
|
@@ -2317,22 +2175,22 @@ ruflo embeddings search -q "authentication patterns"
|
|
|
2317
2175
|
|
|
2318
2176
|
```bash
|
|
2319
2177
|
# Initialize RuVector in PostgreSQL
|
|
2320
|
-
|
|
2178
|
+
opencode-orchestrator ruvector init --database mydb --user admin
|
|
2321
2179
|
|
|
2322
2180
|
# Check connection and schema status
|
|
2323
|
-
|
|
2181
|
+
opencode-orchestrator ruvector status --verbose
|
|
2324
2182
|
|
|
2325
2183
|
# Run pending migrations
|
|
2326
|
-
|
|
2184
|
+
opencode-orchestrator ruvector migrate --up
|
|
2327
2185
|
|
|
2328
2186
|
# Performance benchmark
|
|
2329
|
-
|
|
2187
|
+
opencode-orchestrator ruvector benchmark --iterations 1000
|
|
2330
2188
|
|
|
2331
2189
|
# Optimize indices and vacuum
|
|
2332
|
-
|
|
2190
|
+
opencode-orchestrator ruvector optimize --analyze
|
|
2333
2191
|
|
|
2334
2192
|
# Backup vector data
|
|
2335
|
-
|
|
2193
|
+
opencode-orchestrator ruvector backup --output ./backup.sql
|
|
2336
2194
|
```
|
|
2337
2195
|
|
|
2338
2196
|
| Migration | Purpose | Features |
|
|
@@ -2364,13 +2222,13 @@ ruflo ruvector backup --output ./backup.sql
|
|
|
2364
2222
|
|
|
2365
2223
|
**Quick Commands:**
|
|
2366
2224
|
```bash
|
|
2367
|
-
npx
|
|
2368
|
-
npx
|
|
2369
|
-
npx
|
|
2370
|
-
npx
|
|
2225
|
+
npx opencode-orchestrator hive-mind init # Initialize
|
|
2226
|
+
npx opencode-orchestrator hive-mind spawn "Build API" --queen-type tactical # Spawn swarm
|
|
2227
|
+
npx opencode-orchestrator hive-mind spawn "Research AI" --consensus byzantine --claude
|
|
2228
|
+
npx opencode-orchestrator hive-mind status # Check status
|
|
2371
2229
|
```
|
|
2372
2230
|
|
|
2373
|
-
**
|
|
2231
|
+
**OpenCode Orchestrator Skill:** `/hive-mind-advanced` — Full hive mind orchestration
|
|
2374
2232
|
|
|
2375
2233
|
**Performance:** Fast batch spawning with token reduction via intelligent routing
|
|
2376
2234
|
|
|
@@ -2486,13 +2344,13 @@ Claude Code pipes JSON session data via **stdin** to the statusline script after
|
|
|
2486
2344
|
|
|
2487
2345
|
**Output Format:**
|
|
2488
2346
|
```
|
|
2489
|
-
▊
|
|
2347
|
+
▊ OpenCode Orchestrator V3 ● ruvnet │ ⎇ main │ Opus 4.6 | ●42% ctx | $0.15
|
|
2490
2348
|
🏗️ DDD [●●●●○] 4/5 ⚡ HNSW 150x 🤖 ◉ [12/8] 👥 3 🟢 CVE 3/3 💾 512MB 🧠 15% 📦 AgentDB ●1.2K vectors
|
|
2491
2349
|
```
|
|
2492
2350
|
|
|
2493
2351
|
| Indicator | Description | Source |
|
|
2494
2352
|
|-----------|-------------|--------|
|
|
2495
|
-
| `▊
|
|
2353
|
+
| `▊ OpenCode Orchestrator V3` | Project header | Always shown |
|
|
2496
2354
|
| `● ruvnet` | GitHub user | `gh api user` CLI |
|
|
2497
2355
|
| `⎇ main` | Current git branch | `git branch --show-current` |
|
|
2498
2356
|
| `Opus 4.6` | Claude model name | Stdin JSON `model.display_name` |
|
|
@@ -2510,7 +2368,7 @@ Claude Code pipes JSON session data via **stdin** to the statusline script after
|
|
|
2510
2368
|
|
|
2511
2369
|
**Setup (Automatic):**
|
|
2512
2370
|
|
|
2513
|
-
Run `npx
|
|
2371
|
+
Run `npx opencode-orchestrator@latest init` — this generates `.claude/settings.json` with the correct statusline config and creates the helper script at `.claude/helpers/statusline.cjs`.
|
|
2514
2372
|
|
|
2515
2373
|
The generated config uses a **fast local script** (no `npx` cold-start):
|
|
2516
2374
|
```json
|
|
@@ -2528,7 +2386,7 @@ The generated config uses a **fast local script** (no `npx` cold-start):
|
|
|
2528
2386
|
|
|
2529
2387
|
If your statusline is not updating, run the upgrade command to regenerate helpers and fix the config:
|
|
2530
2388
|
```bash
|
|
2531
|
-
npx
|
|
2389
|
+
npx opencode-orchestrator@latest init --update --settings
|
|
2532
2390
|
```
|
|
2533
2391
|
|
|
2534
2392
|
This removes invalid config fields and regenerates the statusline helper with stdin support.
|
|
@@ -2578,19 +2436,19 @@ Cross-platform TypeScript-based daemon service with auto-scheduling:
|
|
|
2578
2436
|
**Commands:**
|
|
2579
2437
|
```bash
|
|
2580
2438
|
# Start daemon (auto-runs on SessionStart hooks)
|
|
2581
|
-
npx
|
|
2439
|
+
npx opencode-orchestrator@v3alpha daemon start
|
|
2582
2440
|
|
|
2583
2441
|
# Check status with worker history
|
|
2584
|
-
npx
|
|
2442
|
+
npx opencode-orchestrator@v3alpha daemon status
|
|
2585
2443
|
|
|
2586
2444
|
# Manually trigger a worker
|
|
2587
|
-
npx
|
|
2445
|
+
npx opencode-orchestrator@v3alpha daemon trigger map
|
|
2588
2446
|
|
|
2589
2447
|
# Enable/disable workers
|
|
2590
|
-
npx
|
|
2448
|
+
npx opencode-orchestrator@v3alpha daemon enable map audit optimize
|
|
2591
2449
|
|
|
2592
2450
|
# Stop daemon
|
|
2593
|
-
npx
|
|
2451
|
+
npx opencode-orchestrator@v3alpha daemon stop
|
|
2594
2452
|
```
|
|
2595
2453
|
|
|
2596
2454
|
**Daemon Status Output:**
|
|
@@ -2664,7 +2522,7 @@ Shell-based daemons for monitoring (Linux/macOS only):
|
|
|
2664
2522
|
<details>
|
|
2665
2523
|
<summary>⌨️ <strong>V3 CLI Commands</strong> — 26 commands with 140+ subcommands</summary>
|
|
2666
2524
|
|
|
2667
|
-
Complete command-line interface for all
|
|
2525
|
+
Complete command-line interface for all OpenCode Orchestrator operations.
|
|
2668
2526
|
|
|
2669
2527
|
**Core Commands:**
|
|
2670
2528
|
|
|
@@ -2706,25 +2564,25 @@ Complete command-line interface for all Ruflo operations.
|
|
|
2706
2564
|
|
|
2707
2565
|
```bash
|
|
2708
2566
|
# Initialize project with wizard
|
|
2709
|
-
npx
|
|
2567
|
+
npx opencode-orchestrator@v3alpha init --wizard
|
|
2710
2568
|
|
|
2711
2569
|
# Start daemon with background workers
|
|
2712
|
-
npx
|
|
2570
|
+
npx opencode-orchestrator@v3alpha daemon start
|
|
2713
2571
|
|
|
2714
2572
|
# Spawn an agent with specific type
|
|
2715
|
-
npx
|
|
2573
|
+
npx opencode-orchestrator@v3alpha agent spawn -t coder --name my-coder
|
|
2716
2574
|
|
|
2717
2575
|
# Initialize swarm with V3 mode
|
|
2718
|
-
npx
|
|
2576
|
+
npx opencode-orchestrator@v3alpha swarm init --v3-mode
|
|
2719
2577
|
|
|
2720
2578
|
# Search memory (HNSW-indexed, 150x faster)
|
|
2721
|
-
npx
|
|
2579
|
+
npx opencode-orchestrator@v3alpha memory search -q "authentication patterns"
|
|
2722
2580
|
|
|
2723
2581
|
# Run security scan
|
|
2724
|
-
npx
|
|
2582
|
+
npx opencode-orchestrator@v3alpha security scan --depth full
|
|
2725
2583
|
|
|
2726
2584
|
# Performance benchmark
|
|
2727
|
-
npx
|
|
2585
|
+
npx opencode-orchestrator@v3alpha performance benchmark --suite all
|
|
2728
2586
|
```
|
|
2729
2587
|
|
|
2730
2588
|
</details>
|
|
@@ -2732,7 +2590,7 @@ npx ruflo@v3alpha performance benchmark --suite all
|
|
|
2732
2590
|
<details>
|
|
2733
2591
|
<summary>🩺 <strong>Doctor Health Checks</strong> — System diagnostics with auto-fix</summary>
|
|
2734
2592
|
|
|
2735
|
-
Run `npx
|
|
2593
|
+
Run `npx opencode-orchestrator@v3alpha doctor` to diagnose and fix common issues.
|
|
2736
2594
|
|
|
2737
2595
|
**Health Checks Performed:**
|
|
2738
2596
|
|
|
@@ -2753,22 +2611,22 @@ Run `npx ruflo@v3alpha doctor` to diagnose and fix common issues.
|
|
|
2753
2611
|
|
|
2754
2612
|
```bash
|
|
2755
2613
|
# Run full diagnostics
|
|
2756
|
-
npx
|
|
2614
|
+
npx opencode-orchestrator@v3alpha doctor
|
|
2757
2615
|
|
|
2758
2616
|
# Run diagnostics with auto-fix
|
|
2759
|
-
npx
|
|
2617
|
+
npx opencode-orchestrator@v3alpha doctor --fix
|
|
2760
2618
|
|
|
2761
2619
|
# Check specific component
|
|
2762
|
-
npx
|
|
2620
|
+
npx opencode-orchestrator@v3alpha doctor --component memory
|
|
2763
2621
|
|
|
2764
2622
|
# Verbose output
|
|
2765
|
-
npx
|
|
2623
|
+
npx opencode-orchestrator@v3alpha doctor --verbose
|
|
2766
2624
|
```
|
|
2767
2625
|
|
|
2768
2626
|
**Output Example:**
|
|
2769
2627
|
|
|
2770
2628
|
```
|
|
2771
|
-
🩺
|
|
2629
|
+
🩺 OpenCode Orchestrator Doctor v3.0.0-alpha
|
|
2772
2630
|
|
|
2773
2631
|
✅ Node.js 20.11.0 (required: 20+)
|
|
2774
2632
|
✅ npm 10.2.4 (required: 9+)
|
|
@@ -2812,16 +2670,16 @@ The embeddings package (v3.0.0-alpha.12) provides high-performance vector embedd
|
|
|
2812
2670
|
|
|
2813
2671
|
```bash
|
|
2814
2672
|
# Initialize embeddings system
|
|
2815
|
-
npx
|
|
2673
|
+
npx opencode-orchestrator@v3alpha embeddings init
|
|
2816
2674
|
|
|
2817
2675
|
# Generate embedding for text
|
|
2818
|
-
npx
|
|
2676
|
+
npx opencode-orchestrator@v3alpha embeddings embed "authentication patterns"
|
|
2819
2677
|
|
|
2820
2678
|
# Batch embed multiple texts
|
|
2821
|
-
npx
|
|
2679
|
+
npx opencode-orchestrator@v3alpha embeddings batch --file texts.txt
|
|
2822
2680
|
|
|
2823
2681
|
# Search with semantic similarity
|
|
2824
|
-
npx
|
|
2682
|
+
npx opencode-orchestrator@v3alpha embeddings search "login flow" --top-k 5
|
|
2825
2683
|
```
|
|
2826
2684
|
|
|
2827
2685
|
**Programmatic:**
|
|
@@ -2858,59 +2716,59 @@ Real-world scenarios and pre-built workflows for common tasks.
|
|
|
2858
2716
|
|
|
2859
2717
|
| Scenario | What It Solves | How To Do It |
|
|
2860
2718
|
|----------|----------------|--------------|
|
|
2861
|
-
| **Code Review** | Get thorough reviews with security, performance, and style checks | `npx
|
|
2862
|
-
| **Test Generation** | Auto-generate unit, integration, and e2e tests for existing code | `npx
|
|
2863
|
-
| **Refactoring** | Safely restructure code while maintaining behavior | `npx
|
|
2864
|
-
| **Bug Fixing** | Diagnose and fix bugs with full context analysis | `npx
|
|
2719
|
+
| **Code Review** | Get thorough reviews with security, performance, and style checks | `npx opencode-orchestrator@v3alpha --agent reviewer --task "Review PR #123"` |
|
|
2720
|
+
| **Test Generation** | Auto-generate unit, integration, and e2e tests for existing code | `npx opencode-orchestrator@v3alpha --agent tester --task "Write tests for auth module"` |
|
|
2721
|
+
| **Refactoring** | Safely restructure code while maintaining behavior | `npx opencode-orchestrator@v3alpha --agent coder --task "Refactor user service to use repository pattern"` |
|
|
2722
|
+
| **Bug Fixing** | Diagnose and fix bugs with full context analysis | `npx opencode-orchestrator@v3alpha --agent coder --task "Fix race condition in checkout flow"` |
|
|
2865
2723
|
|
|
2866
2724
|
### 🔒 Security & Compliance
|
|
2867
2725
|
|
|
2868
2726
|
| Scenario | What It Solves | How To Do It |
|
|
2869
2727
|
|----------|----------------|--------------|
|
|
2870
|
-
| **Security Audit** | Find vulnerabilities before attackers do | `npx
|
|
2871
|
-
| **Dependency Scan** | Identify vulnerable packages and suggest upgrades | `npx
|
|
2872
|
-
| **Compliance Check** | Ensure code meets security standards | `npx
|
|
2728
|
+
| **Security Audit** | Find vulnerabilities before attackers do | `npx opencode-orchestrator@v3alpha --agent security-architect --task "Audit for OWASP Top 10"` |
|
|
2729
|
+
| **Dependency Scan** | Identify vulnerable packages and suggest upgrades | `npx opencode-orchestrator@v3alpha security scan --depth full` |
|
|
2730
|
+
| **Compliance Check** | Ensure code meets security standards | `npx opencode-orchestrator@v3alpha --agent security-architect --task "Check PCI-DSS compliance"` |
|
|
2873
2731
|
|
|
2874
2732
|
### 🐝 Multi-Agent Swarms
|
|
2875
2733
|
|
|
2876
2734
|
| Scenario | What It Solves | How To Do It |
|
|
2877
2735
|
|----------|----------------|--------------|
|
|
2878
|
-
| **Feature Development** | Coordinate multiple agents on complex features | `npx
|
|
2879
|
-
| **Large Refactors** | Parallel refactoring across many files without conflicts | `npx
|
|
2880
|
-
| **Codebase Migration** | Migrate frameworks, languages, or patterns systematically | `npx
|
|
2736
|
+
| **Feature Development** | Coordinate multiple agents on complex features | `npx opencode-orchestrator@v3alpha swarm init --topology hierarchical && npx opencode-orchestrator@v3alpha task orchestrate "Build user dashboard"` |
|
|
2737
|
+
| **Large Refactors** | Parallel refactoring across many files without conflicts | `npx opencode-orchestrator@v3alpha swarm init --topology mesh --max-agents 8` |
|
|
2738
|
+
| **Codebase Migration** | Migrate frameworks, languages, or patterns systematically | `npx opencode-orchestrator@v3alpha task orchestrate "Migrate from Express to Fastify" --strategy adaptive` |
|
|
2881
2739
|
|
|
2882
2740
|
### 📊 Performance & Optimization
|
|
2883
2741
|
|
|
2884
2742
|
| Scenario | What It Solves | How To Do It |
|
|
2885
2743
|
|----------|----------------|--------------|
|
|
2886
|
-
| **Performance Profiling** | Find and fix bottlenecks in your application | `npx
|
|
2887
|
-
| **Query Optimization** | Speed up slow database queries | `npx
|
|
2888
|
-
| **Memory Analysis** | Reduce memory usage and fix leaks | `npx
|
|
2744
|
+
| **Performance Profiling** | Find and fix bottlenecks in your application | `npx opencode-orchestrator@v3alpha --agent perf-analyzer --task "Profile API endpoints"` |
|
|
2745
|
+
| **Query Optimization** | Speed up slow database queries | `npx opencode-orchestrator@v3alpha hooks route "Optimize database queries"` |
|
|
2746
|
+
| **Memory Analysis** | Reduce memory usage and fix leaks | `npx opencode-orchestrator@v3alpha --agent perf-analyzer --task "Analyze memory usage patterns"` |
|
|
2889
2747
|
|
|
2890
2748
|
### 🔄 GitHub & DevOps
|
|
2891
2749
|
|
|
2892
2750
|
| Scenario | What It Solves | How To Do It |
|
|
2893
2751
|
|----------|----------------|--------------|
|
|
2894
|
-
| **PR Management** | Review, approve, and merge PRs efficiently | `npx
|
|
2895
|
-
| **Issue Triage** | Categorize, prioritize, and assign issues automatically | `npx
|
|
2896
|
-
| **Release Management** | Coordinate releases with changelogs and versioning | `npx
|
|
2897
|
-
| **CI/CD Optimization** | Speed up pipelines and reduce flaky tests | `npx
|
|
2752
|
+
| **PR Management** | Review, approve, and merge PRs efficiently | `npx opencode-orchestrator@v3alpha --agent pr-manager --task "Review open PRs"` |
|
|
2753
|
+
| **Issue Triage** | Categorize, prioritize, and assign issues automatically | `npx opencode-orchestrator@v3alpha --agent issue-tracker --task "Triage new issues"` |
|
|
2754
|
+
| **Release Management** | Coordinate releases with changelogs and versioning | `npx opencode-orchestrator@v3alpha --agent release-manager --task "Prepare v2.0 release"` |
|
|
2755
|
+
| **CI/CD Optimization** | Speed up pipelines and reduce flaky tests | `npx opencode-orchestrator@v3alpha --agent cicd-engineer --task "Optimize GitHub Actions workflow"` |
|
|
2898
2756
|
|
|
2899
2757
|
### 📋 Spec-Driven Development
|
|
2900
2758
|
|
|
2901
2759
|
| Scenario | What It Solves | How To Do It |
|
|
2902
2760
|
|----------|----------------|--------------|
|
|
2903
|
-
| **Generate Specs** | Create complete specifications before coding | `npx
|
|
2904
|
-
| **Validate Implementation** | Ensure code matches specifications | `npx
|
|
2905
|
-
| **Track Compliance** | Monitor spec adherence across the team | `npx
|
|
2761
|
+
| **Generate Specs** | Create complete specifications before coding | `npx opencode-orchestrator@v3alpha --agent architect --task "Create ADR for authentication system"` |
|
|
2762
|
+
| **Validate Implementation** | Ensure code matches specifications | `npx opencode-orchestrator@v3alpha hooks progress --detailed` |
|
|
2763
|
+
| **Track Compliance** | Monitor spec adherence across the team | `npx opencode-orchestrator@v3alpha progress sync` |
|
|
2906
2764
|
|
|
2907
2765
|
### 🧠 Learning & Intelligence
|
|
2908
2766
|
|
|
2909
2767
|
| Scenario | What It Solves | How To Do It |
|
|
2910
2768
|
|----------|----------------|--------------|
|
|
2911
|
-
| **Bootstrap Intelligence** | Train the system on your codebase patterns | `npx
|
|
2912
|
-
| **Optimize Routing** | Improve task-to-agent matching over time | `npx
|
|
2913
|
-
| **Transfer Learning** | Apply patterns learned from other projects | `npx
|
|
2769
|
+
| **Bootstrap Intelligence** | Train the system on your codebase patterns | `npx opencode-orchestrator@v3alpha hooks pretrain --depth deep` |
|
|
2770
|
+
| **Optimize Routing** | Improve task-to-agent matching over time | `npx opencode-orchestrator@v3alpha hooks route "<task>" --include-explanation` |
|
|
2771
|
+
| **Transfer Learning** | Apply patterns learned from other projects | `npx opencode-orchestrator@v3alpha hooks transfer <sourceProject>` |
|
|
2914
2772
|
|
|
2915
2773
|
</details>
|
|
2916
2774
|
|
|
@@ -2918,7 +2776,7 @@ Real-world scenarios and pre-built workflows for common tasks.
|
|
|
2918
2776
|
|
|
2919
2777
|
## 🧠 Infinite Context & Memory Optimization
|
|
2920
2778
|
|
|
2921
|
-
|
|
2779
|
+
OpenCode Orchestrator eliminates Claude Code's context window ceiling with a real-time memory management system that archives, optimizes, and restores conversation context automatically.
|
|
2922
2780
|
|
|
2923
2781
|
<details>
|
|
2924
2782
|
<summary>♾️ <strong>Context Autopilot</strong> — Never lose context to compaction again</summary>
|
|
@@ -2929,7 +2787,7 @@ Claude Code has a finite context window (~200K tokens). When full, it **compacts
|
|
|
2929
2787
|
|
|
2930
2788
|
### The Solution: Context Autopilot (ADR-051)
|
|
2931
2789
|
|
|
2932
|
-
|
|
2790
|
+
OpenCode Orchestrator intercepts the compaction lifecycle with three hooks that make context loss invisible:
|
|
2933
2791
|
|
|
2934
2792
|
```
|
|
2935
2793
|
Every Prompt Context Full After Compact
|
|
@@ -3032,7 +2890,7 @@ sqlite3 .claude-flow/data/transcript-archive.db \
|
|
|
3032
2890
|
|
|
3033
2891
|
## 💾 Storage: RVF (RuVector Format)
|
|
3034
2892
|
|
|
3035
|
-
|
|
2893
|
+
OpenCode Orchestrator uses RVF — a compact binary storage format that replaces the 18MB sql.js WASM dependency with pure TypeScript. No native compilation, no WASM downloads, works everywhere Node.js runs.
|
|
3036
2894
|
|
|
3037
2895
|
<details>
|
|
3038
2896
|
<summary>💾 <strong>RVF Storage</strong> — Binary format, vector search, migration, and auto-selection</summary>
|
|
@@ -3152,8 +3010,8 @@ CLAUDE_FLOW_MEMORY_BACKEND=hybrid # auto-selects RVF
|
|
|
3152
3010
|
CLAUDE_FLOW_MEMORY_PATH=./data/memory
|
|
3153
3011
|
|
|
3154
3012
|
# Or via CLI
|
|
3155
|
-
|
|
3156
|
-
|
|
3013
|
+
opencode-orchestrator memory init --force
|
|
3014
|
+
opencode-orchestrator config set memory.backend hybrid
|
|
3157
3015
|
```
|
|
3158
3016
|
|
|
3159
3017
|
</details>
|
|
@@ -3212,7 +3070,7 @@ When hooks run, they emit signals that guide routing decisions. Watch for these
|
|
|
3212
3070
|
|
|
3213
3071
|
**Example Hook Output:**
|
|
3214
3072
|
```bash
|
|
3215
|
-
$ npx
|
|
3073
|
+
$ npx opencode-orchestrator@v3alpha hooks pre-task --description "convert var to const in utils.ts"
|
|
3216
3074
|
|
|
3217
3075
|
[AGENT_BOOSTER_AVAILABLE] Intent: var-to-const
|
|
3218
3076
|
Recommendation: Use Edit tool directly
|
|
@@ -3330,8 +3188,8 @@ The stats command shows:
|
|
|
3330
3188
|
|
|
3331
3189
|
```bash
|
|
3332
3190
|
# Example: Edit with pattern learning
|
|
3333
|
-
npx
|
|
3334
|
-
npx
|
|
3191
|
+
npx opencode-orchestrator@v3alpha hooks pre-edit ./src/auth.ts
|
|
3192
|
+
npx opencode-orchestrator@v3alpha hooks post-edit ./src/auth.ts --success true --train-patterns
|
|
3335
3193
|
```
|
|
3336
3194
|
|
|
3337
3195
|
#### 🧠 Intelligence & Routing Hooks (8 hooks)
|
|
@@ -3349,10 +3207,10 @@ npx ruflo@v3alpha hooks post-edit ./src/auth.ts --success true --train-patterns
|
|
|
3349
3207
|
|
|
3350
3208
|
```bash
|
|
3351
3209
|
# Route a task with explanation
|
|
3352
|
-
npx
|
|
3210
|
+
npx opencode-orchestrator@v3alpha hooks route "refactor authentication to use JWT" --include-explanation
|
|
3353
3211
|
|
|
3354
3212
|
# Bootstrap intelligence from your codebase
|
|
3355
|
-
npx
|
|
3213
|
+
npx opencode-orchestrator@v3alpha hooks pretrain --depth deep --model-type moe
|
|
3356
3214
|
```
|
|
3357
3215
|
|
|
3358
3216
|
#### 📅 Session Management Hooks (4 hooks)
|
|
@@ -3366,10 +3224,10 @@ npx ruflo@v3alpha hooks pretrain --depth deep --model-type moe
|
|
|
3366
3224
|
|
|
3367
3225
|
```bash
|
|
3368
3226
|
# Start session with auto-daemon
|
|
3369
|
-
npx
|
|
3227
|
+
npx opencode-orchestrator@v3alpha hooks session-start --session-id "feature-auth" --start-daemon
|
|
3370
3228
|
|
|
3371
3229
|
# End session and export learnings
|
|
3372
|
-
npx
|
|
3230
|
+
npx opencode-orchestrator@v3alpha hooks session-end --export-metrics --persist-patterns
|
|
3373
3231
|
```
|
|
3374
3232
|
|
|
3375
3233
|
#### 🤖 Intelligence System Hooks (9 hooks)
|
|
@@ -3388,13 +3246,13 @@ npx ruflo@v3alpha hooks session-end --export-metrics --persist-patterns
|
|
|
3388
3246
|
|
|
3389
3247
|
```bash
|
|
3390
3248
|
# Start trajectory for complex task
|
|
3391
|
-
npx
|
|
3249
|
+
npx opencode-orchestrator@v3alpha hooks intelligence trajectory-start --task "implement OAuth2"
|
|
3392
3250
|
|
|
3393
3251
|
# Record successful action
|
|
3394
|
-
npx
|
|
3252
|
+
npx opencode-orchestrator@v3alpha hooks intelligence trajectory-step --action "created token service" --quality 0.9
|
|
3395
3253
|
|
|
3396
3254
|
# End trajectory and trigger learning
|
|
3397
|
-
npx
|
|
3255
|
+
npx opencode-orchestrator@v3alpha hooks intelligence trajectory-end --success true
|
|
3398
3256
|
|
|
3399
3257
|
# View intelligence diagnostics and improvement trends (ADR-050)
|
|
3400
3258
|
node .claude/helpers/hook-handler.cjs stats
|
|
@@ -3422,13 +3280,13 @@ Workers run automatically based on context, or dispatch manually.
|
|
|
3422
3280
|
|
|
3423
3281
|
```bash
|
|
3424
3282
|
# List all workers
|
|
3425
|
-
npx
|
|
3283
|
+
npx opencode-orchestrator@v3alpha hooks worker list
|
|
3426
3284
|
|
|
3427
3285
|
# Manually dispatch security audit
|
|
3428
|
-
npx
|
|
3286
|
+
npx opencode-orchestrator@v3alpha hooks worker dispatch --trigger audit --context "./src/auth"
|
|
3429
3287
|
|
|
3430
3288
|
# Check worker status
|
|
3431
|
-
npx
|
|
3289
|
+
npx opencode-orchestrator@v3alpha hooks worker status
|
|
3432
3290
|
```
|
|
3433
3291
|
|
|
3434
3292
|
### Model Routing Hooks (3 hooks)
|
|
@@ -3443,10 +3301,10 @@ Automatically selects haiku/sonnet/opus based on task complexity.
|
|
|
3443
3301
|
|
|
3444
3302
|
```bash
|
|
3445
3303
|
# Get model recommendation
|
|
3446
|
-
npx
|
|
3304
|
+
npx opencode-orchestrator@v3alpha hooks model-route --task "fix typo in README"
|
|
3447
3305
|
# → Recommends: haiku (simple task, low complexity)
|
|
3448
3306
|
|
|
3449
|
-
npx
|
|
3307
|
+
npx opencode-orchestrator@v3alpha hooks model-route --task "design distributed consensus system"
|
|
3450
3308
|
# → Recommends: opus (complex architecture, high reasoning)
|
|
3451
3309
|
```
|
|
3452
3310
|
|
|
@@ -3467,15 +3325,15 @@ npx ruflo@v3alpha hooks model-route --task "design distributed consensus system"
|
|
|
3467
3325
|
# ══════════════════════════════════════════════════════════════════
|
|
3468
3326
|
|
|
3469
3327
|
# Route task to best agent (with intelligence context injection)
|
|
3470
|
-
npx
|
|
3328
|
+
npx opencode-orchestrator@v3alpha hooks route "<task>" --include-explanation
|
|
3471
3329
|
|
|
3472
3330
|
# Start/end session with learning
|
|
3473
|
-
npx
|
|
3474
|
-
npx
|
|
3331
|
+
npx opencode-orchestrator@v3alpha hooks session-start --start-daemon
|
|
3332
|
+
npx opencode-orchestrator@v3alpha hooks session-end --persist-patterns
|
|
3475
3333
|
|
|
3476
3334
|
# View what the system has learned
|
|
3477
|
-
npx
|
|
3478
|
-
npx
|
|
3335
|
+
npx opencode-orchestrator@v3alpha hooks metrics
|
|
3336
|
+
npx opencode-orchestrator@v3alpha hooks intelligence stats
|
|
3479
3337
|
|
|
3480
3338
|
# Intelligence diagnostics — see if intelligence is improving
|
|
3481
3339
|
node .claude/helpers/hook-handler.cjs stats # Human-readable
|
|
@@ -3483,10 +3341,10 @@ node .claude/helpers/hook-handler.cjs stats --json # JSON for scripting
|
|
|
3483
3341
|
node .claude/helpers/intelligence.cjs stats # Direct access
|
|
3484
3342
|
|
|
3485
3343
|
# Bootstrap on new project
|
|
3486
|
-
npx
|
|
3344
|
+
npx opencode-orchestrator@v3alpha hooks pretrain --depth deep
|
|
3487
3345
|
|
|
3488
3346
|
# Dispatch background worker
|
|
3489
|
-
npx
|
|
3347
|
+
npx opencode-orchestrator@v3alpha hooks worker dispatch --trigger audit
|
|
3490
3348
|
```
|
|
3491
3349
|
|
|
3492
3350
|
</details>
|
|
@@ -3512,38 +3370,38 @@ Share learned patterns across projects, teams, and the community via the decentr
|
|
|
3512
3370
|
|
|
3513
3371
|
```bash
|
|
3514
3372
|
# Export learned patterns to file
|
|
3515
|
-
npx
|
|
3373
|
+
npx opencode-orchestrator@v3alpha memory export --format json --output ./patterns.json
|
|
3516
3374
|
|
|
3517
3375
|
# Export specific namespace
|
|
3518
|
-
npx
|
|
3376
|
+
npx opencode-orchestrator@v3alpha memory export --namespace "security" --output ./security-patterns.json
|
|
3519
3377
|
|
|
3520
3378
|
# Export with embeddings (larger file, faster import)
|
|
3521
|
-
npx
|
|
3379
|
+
npx opencode-orchestrator@v3alpha memory export --include-embeddings --output ./full-export.json
|
|
3522
3380
|
|
|
3523
3381
|
# Export agent configurations
|
|
3524
|
-
npx
|
|
3382
|
+
npx opencode-orchestrator@v3alpha config export --scope project --output ./agent-configs.json
|
|
3525
3383
|
|
|
3526
3384
|
# Export session state
|
|
3527
|
-
npx
|
|
3385
|
+
npx opencode-orchestrator@v3alpha session export --session-id "my-session" --output ./session.json
|
|
3528
3386
|
```
|
|
3529
3387
|
|
|
3530
3388
|
### Import Commands
|
|
3531
3389
|
|
|
3532
3390
|
```bash
|
|
3533
3391
|
# Import patterns from file
|
|
3534
|
-
npx
|
|
3392
|
+
npx opencode-orchestrator@v3alpha memory import --input ./patterns.json
|
|
3535
3393
|
|
|
3536
3394
|
# Import and merge with existing (don't overwrite)
|
|
3537
|
-
npx
|
|
3395
|
+
npx opencode-orchestrator@v3alpha memory import --input ./patterns.json --merge
|
|
3538
3396
|
|
|
3539
3397
|
# Import from another project
|
|
3540
|
-
npx
|
|
3398
|
+
npx opencode-orchestrator@v3alpha hooks transfer --source-path ../other-project
|
|
3541
3399
|
|
|
3542
3400
|
# Import agent configurations
|
|
3543
|
-
npx
|
|
3401
|
+
npx opencode-orchestrator@v3alpha config import --input ./agent-configs.json --scope project
|
|
3544
3402
|
|
|
3545
3403
|
# Restore session
|
|
3546
|
-
npx
|
|
3404
|
+
npx opencode-orchestrator@v3alpha session restore --session-id "my-session"
|
|
3547
3405
|
```
|
|
3548
3406
|
|
|
3549
3407
|
### Pattern Store (IPFS Marketplace)
|
|
@@ -3561,13 +3419,13 @@ Decentralized pattern marketplace for sharing and discovering community patterns
|
|
|
3561
3419
|
|
|
3562
3420
|
```bash
|
|
3563
3421
|
# Search for authentication patterns
|
|
3564
|
-
npx
|
|
3422
|
+
npx opencode-orchestrator@v3alpha transfer-store search --query "authentication" --min-rating 4.0
|
|
3565
3423
|
|
|
3566
3424
|
# Download a pattern
|
|
3567
|
-
npx
|
|
3425
|
+
npx opencode-orchestrator@v3alpha transfer-store download --id "auth-jwt-patterns-v2" --verify
|
|
3568
3426
|
|
|
3569
3427
|
# Publish your patterns
|
|
3570
|
-
npx
|
|
3428
|
+
npx opencode-orchestrator@v3alpha transfer-store publish --input ./my-patterns.json --category "security"
|
|
3571
3429
|
```
|
|
3572
3430
|
|
|
3573
3431
|
### Plugin Store
|
|
@@ -3585,22 +3443,22 @@ Discover and install community plugins from the **live IPFS registry** with 19 o
|
|
|
3585
3443
|
|
|
3586
3444
|
```bash
|
|
3587
3445
|
# List plugins with live ratings from Cloud Function
|
|
3588
|
-
npx
|
|
3446
|
+
npx opencode-orchestrator@v3alpha plugins list
|
|
3589
3447
|
|
|
3590
3448
|
# Filter by type
|
|
3591
|
-
npx
|
|
3449
|
+
npx opencode-orchestrator@v3alpha plugins list --type integration
|
|
3592
3450
|
|
|
3593
3451
|
# Rate a plugin
|
|
3594
|
-
npx
|
|
3452
|
+
npx opencode-orchestrator@v3alpha plugins rate --name @claude-flow/embeddings --rating 5
|
|
3595
3453
|
|
|
3596
3454
|
# Search for MCP tool plugins
|
|
3597
|
-
npx
|
|
3455
|
+
npx opencode-orchestrator@v3alpha transfer plugin-search --type "mcp-tool" --verified
|
|
3598
3456
|
|
|
3599
3457
|
# Get plugin info
|
|
3600
|
-
npx
|
|
3458
|
+
npx opencode-orchestrator@v3alpha transfer plugin-info --name "semantic-code-search"
|
|
3601
3459
|
|
|
3602
3460
|
# List official plugins
|
|
3603
|
-
npx
|
|
3461
|
+
npx opencode-orchestrator@v3alpha transfer plugin-official
|
|
3604
3462
|
```
|
|
3605
3463
|
|
|
3606
3464
|
#### Live IPFS Plugin Registry
|
|
@@ -3633,10 +3491,10 @@ Patterns and models are distributed via IPFS for decentralization and integrity.
|
|
|
3633
3491
|
|
|
3634
3492
|
```bash
|
|
3635
3493
|
# Resolve IPNS name to CID
|
|
3636
|
-
npx
|
|
3494
|
+
npx opencode-orchestrator@v3alpha transfer ipfs-resolve --name "/ipns/patterns.opencode-orchestrator.io"
|
|
3637
3495
|
|
|
3638
3496
|
# Detect PII before publishing
|
|
3639
|
-
npx
|
|
3497
|
+
npx opencode-orchestrator@v3alpha transfer detect-pii --content "$(cat ./patterns.json)"
|
|
3640
3498
|
```
|
|
3641
3499
|
|
|
3642
3500
|
### Model & Learning Pattern Import/Export
|
|
@@ -3659,7 +3517,7 @@ curl -X POST "https://api.pinata.cloud/pinning/pinJSONToIPFS" \
|
|
|
3659
3517
|
"name": "my-patterns",
|
|
3660
3518
|
"patterns": [...]
|
|
3661
3519
|
},
|
|
3662
|
-
"pinataMetadata": {"name": "
|
|
3520
|
+
"pinataMetadata": {"name": "opencode-orchestrator-learning-pattern"}
|
|
3663
3521
|
}'
|
|
3664
3522
|
|
|
3665
3523
|
# Import a pattern from IPFS CID
|
|
@@ -3701,13 +3559,13 @@ Import pre-trained learning patterns for common tasks. **90.5% average accuracy*
|
|
|
3701
3559
|
curl -s "https://gateway.pinata.cloud/ipfs/QmNr1yYMKi7YBaL8JSztQyuB5ZUaTdRMLxJC1pBpGbjsTc" | jq '.models[].name'
|
|
3702
3560
|
|
|
3703
3561
|
# Import all models
|
|
3704
|
-
npx
|
|
3562
|
+
npx opencode-orchestrator@v3alpha transfer import --cid QmNr1yYMKi7YBaL8JSztQyuB5ZUaTdRMLxJC1pBpGbjsTc
|
|
3705
3563
|
|
|
3706
3564
|
# Import specific category
|
|
3707
|
-
npx
|
|
3565
|
+
npx opencode-orchestrator@v3alpha neural import --model security-review-patterns --source ipfs
|
|
3708
3566
|
|
|
3709
3567
|
# Use patterns in routing
|
|
3710
|
-
npx
|
|
3568
|
+
npx opencode-orchestrator@v3alpha hooks route --task "review authentication code" --use-patterns
|
|
3711
3569
|
```
|
|
3712
3570
|
|
|
3713
3571
|
#### Benefits vs Fresh Install
|
|
@@ -3732,7 +3590,7 @@ npx ruflo@v3alpha hooks route --task "review authentication code" --use-patterns
|
|
|
3732
3590
|
|
|
3733
3591
|
```bash
|
|
3734
3592
|
# Install a pattern pack
|
|
3735
|
-
npx
|
|
3593
|
+
npx opencode-orchestrator@v3alpha transfer-store download --id "security-essentials" --apply
|
|
3736
3594
|
```
|
|
3737
3595
|
|
|
3738
3596
|
### RuVector WASM Neural Training
|
|
@@ -3750,25 +3608,25 @@ Real WASM-accelerated neural training using `@ruvector/learning-wasm` and `@ruve
|
|
|
3750
3608
|
|
|
3751
3609
|
```bash
|
|
3752
3610
|
# List available pre-trained models from IPFS registry
|
|
3753
|
-
npx
|
|
3611
|
+
npx opencode-orchestrator@v3alpha neural list
|
|
3754
3612
|
|
|
3755
3613
|
# List models by category
|
|
3756
|
-
npx
|
|
3614
|
+
npx opencode-orchestrator@v3alpha neural list --category security
|
|
3757
3615
|
|
|
3758
3616
|
# Train with WASM acceleration
|
|
3759
|
-
npx
|
|
3617
|
+
npx opencode-orchestrator@v3alpha neural train -p coordination -e 100 --wasm --flash --contrastive
|
|
3760
3618
|
|
|
3761
3619
|
# Train security patterns
|
|
3762
|
-
npx
|
|
3620
|
+
npx opencode-orchestrator@v3alpha neural train -p security --wasm --contrastive
|
|
3763
3621
|
|
|
3764
3622
|
# Benchmark WASM performance
|
|
3765
|
-
npx
|
|
3623
|
+
npx opencode-orchestrator@v3alpha neural benchmark -d 256 -i 1000
|
|
3766
3624
|
|
|
3767
3625
|
# Import pre-trained models
|
|
3768
|
-
npx
|
|
3626
|
+
npx opencode-orchestrator@v3alpha neural import --cid QmNr1yYMKi7YBaL8JSztQyuB5ZUaTdRMLxJC1pBpGbjsTc
|
|
3769
3627
|
|
|
3770
3628
|
# Export trained patterns to IPFS
|
|
3771
|
-
npx
|
|
3629
|
+
npx opencode-orchestrator@v3alpha neural export --ipfs --sign
|
|
3772
3630
|
```
|
|
3773
3631
|
|
|
3774
3632
|
#### Benchmark Results
|
|
@@ -4107,9 +3965,9 @@ Skills are **reusable workflows** that combine agents, hooks, and patterns into
|
|
|
4107
3965
|
/v3-security-overhaul
|
|
4108
3966
|
|
|
4109
3967
|
# Via CLI
|
|
4110
|
-
npx
|
|
4111
|
-
npx
|
|
4112
|
-
npx
|
|
3968
|
+
npx opencode-orchestrator@v3alpha skill run github-code-review
|
|
3969
|
+
npx opencode-orchestrator@v3alpha skill list
|
|
3970
|
+
npx opencode-orchestrator@v3alpha skill info sparc-methodology
|
|
4113
3971
|
```
|
|
4114
3972
|
|
|
4115
3973
|
### Creating Custom Skills
|
|
@@ -4166,21 +4024,21 @@ The Claims system manages **who is working on what** — whether human or agent.
|
|
|
4166
4024
|
|
|
4167
4025
|
| Command | What It Does | Example |
|
|
4168
4026
|
|---------|--------------|---------|
|
|
4169
|
-
| `issues list` | See all issues and their status | `npx
|
|
4170
|
-
| `issues claim` | Claim an issue for yourself/agent | `npx
|
|
4171
|
-
| `issues release` | Release your claim | `npx
|
|
4172
|
-
| `issues handoff` | Hand off to another worker | `npx
|
|
4173
|
-
| `issues status` | Update progress on claimed work | `npx
|
|
4174
|
-
| `issues stealable` | List abandoned/stuck issues | `npx
|
|
4175
|
-
| `issues steal` | Take over stealable issue | `npx
|
|
4176
|
-
| `issues load` | View agent workloads | `npx
|
|
4177
|
-
| `issues rebalance` | Redistribute work evenly | `npx
|
|
4178
|
-
| `issues board` | Visual board view | `npx
|
|
4027
|
+
| `issues list` | See all issues and their status | `npx opencode-orchestrator@v3alpha issues list` |
|
|
4028
|
+
| `issues claim` | Claim an issue for yourself/agent | `npx opencode-orchestrator@v3alpha issues claim #123 --as coder-1` |
|
|
4029
|
+
| `issues release` | Release your claim | `npx opencode-orchestrator@v3alpha issues release #123` |
|
|
4030
|
+
| `issues handoff` | Hand off to another worker | `npx opencode-orchestrator@v3alpha issues handoff #123 --to reviewer` |
|
|
4031
|
+
| `issues status` | Update progress on claimed work | `npx opencode-orchestrator@v3alpha issues status #123 --progress 75` |
|
|
4032
|
+
| `issues stealable` | List abandoned/stuck issues | `npx opencode-orchestrator@v3alpha issues stealable` |
|
|
4033
|
+
| `issues steal` | Take over stealable issue | `npx opencode-orchestrator@v3alpha issues steal #123` |
|
|
4034
|
+
| `issues load` | View agent workloads | `npx opencode-orchestrator@v3alpha issues load` |
|
|
4035
|
+
| `issues rebalance` | Redistribute work evenly | `npx opencode-orchestrator@v3alpha issues rebalance --dry-run` |
|
|
4036
|
+
| `issues board` | Visual board view | `npx opencode-orchestrator@v3alpha issues board` |
|
|
4179
4037
|
|
|
4180
4038
|
### Visual Board View
|
|
4181
4039
|
|
|
4182
4040
|
```bash
|
|
4183
|
-
npx
|
|
4041
|
+
npx opencode-orchestrator@v3alpha issues board
|
|
4184
4042
|
```
|
|
4185
4043
|
|
|
4186
4044
|
```
|
|
@@ -4202,13 +4060,13 @@ When you need to pass work to someone else:
|
|
|
4202
4060
|
|
|
4203
4061
|
```bash
|
|
4204
4062
|
# 1. Request handoff with context
|
|
4205
|
-
npx
|
|
4063
|
+
npx opencode-orchestrator@v3alpha issues handoff #123 \
|
|
4206
4064
|
--to security-architect \
|
|
4207
4065
|
--reason "Needs security review" \
|
|
4208
4066
|
--progress 80
|
|
4209
4067
|
|
|
4210
4068
|
# 2. Target accepts handoff
|
|
4211
|
-
npx
|
|
4069
|
+
npx opencode-orchestrator@v3alpha issues accept #123 --as security-architect
|
|
4212
4070
|
|
|
4213
4071
|
# 3. Work continues with full context
|
|
4214
4072
|
```
|
|
@@ -4217,7 +4075,7 @@ npx ruflo@v3alpha issues accept #123 --as security-architect
|
|
|
4217
4075
|
|
|
4218
4076
|
```bash
|
|
4219
4077
|
# View current load
|
|
4220
|
-
npx
|
|
4078
|
+
npx opencode-orchestrator@v3alpha issues load
|
|
4221
4079
|
|
|
4222
4080
|
# Output:
|
|
4223
4081
|
# Agent | Claims | Load | Status
|
|
@@ -4228,7 +4086,7 @@ npx ruflo@v3alpha issues load
|
|
|
4228
4086
|
# security-arch | 0 | 0% | 🟢 Available
|
|
4229
4087
|
|
|
4230
4088
|
# Auto-rebalance
|
|
4231
|
-
npx
|
|
4089
|
+
npx opencode-orchestrator@v3alpha issues rebalance
|
|
4232
4090
|
```
|
|
4233
4091
|
|
|
4234
4092
|
### MCP Tools
|
|
@@ -4289,14 +4147,14 @@ The Route system uses **Q-Learning** to automatically assign tasks to the best a
|
|
|
4289
4147
|
|
|
4290
4148
|
| Command | What It Does | Example |
|
|
4291
4149
|
|---------|--------------|---------|
|
|
4292
|
-
| `route task` | Get agent recommendation | `npx
|
|
4293
|
-
| `route explain` | Understand routing decision | `npx
|
|
4294
|
-
| `route coverage` | Route based on test coverage | `npx
|
|
4150
|
+
| `route task` | Get agent recommendation | `npx opencode-orchestrator@v3alpha route task "implement OAuth2"` |
|
|
4151
|
+
| `route explain` | Understand routing decision | `npx opencode-orchestrator@v3alpha route explain "task"` |
|
|
4152
|
+
| `route coverage` | Route based on test coverage | `npx opencode-orchestrator@v3alpha route coverage` |
|
|
4295
4153
|
|
|
4296
4154
|
### Example: Route a Task
|
|
4297
4155
|
|
|
4298
4156
|
```bash
|
|
4299
|
-
npx
|
|
4157
|
+
npx opencode-orchestrator@v3alpha route task "refactor authentication to use JWT"
|
|
4300
4158
|
|
|
4301
4159
|
# Output:
|
|
4302
4160
|
# ╔══════════════════════════════════════════════════════════════╗
|
|
@@ -4323,7 +4181,7 @@ npx ruflo@v3alpha route task "refactor authentication to use JWT"
|
|
|
4323
4181
|
Routes tasks to agents based on **test coverage gaps**:
|
|
4324
4182
|
|
|
4325
4183
|
```bash
|
|
4326
|
-
npx
|
|
4184
|
+
npx opencode-orchestrator@v3alpha route coverage
|
|
4327
4185
|
|
|
4328
4186
|
# Finds untested code and routes to tester agent:
|
|
4329
4187
|
# • src/auth/jwt.ts - 23% coverage → tester
|
|
@@ -4335,10 +4193,10 @@ npx ruflo@v3alpha route coverage
|
|
|
4335
4193
|
|
|
4336
4194
|
```bash
|
|
4337
4195
|
# Route via hooks (preferred)
|
|
4338
|
-
npx
|
|
4196
|
+
npx opencode-orchestrator@v3alpha hooks route "implement caching layer" --include-explanation
|
|
4339
4197
|
|
|
4340
4198
|
# Record outcome for learning
|
|
4341
|
-
npx
|
|
4199
|
+
npx opencode-orchestrator@v3alpha hooks post-task --task-id "task-123" --success true --agent coder
|
|
4342
4200
|
```
|
|
4343
4201
|
|
|
4344
4202
|
### How Q-Learning Improves Over Time
|
|
@@ -4358,12 +4216,12 @@ The system **remembers** what works and applies it to future similar tasks.
|
|
|
4358
4216
|
|
|
4359
4217
|
## 💻 Programmatic Usage
|
|
4360
4218
|
|
|
4361
|
-
Use
|
|
4219
|
+
Use OpenCode Orchestrator packages directly in your applications.
|
|
4362
4220
|
|
|
4363
4221
|
<details>
|
|
4364
|
-
<summary>💻 <strong>Programmatic SDK</strong> — Use
|
|
4222
|
+
<summary>💻 <strong>Programmatic SDK</strong> — Use OpenCode Orchestrator in Your Code</summary>
|
|
4365
4223
|
|
|
4366
|
-
Use
|
|
4224
|
+
Use OpenCode Orchestrator packages directly in your TypeScript/JavaScript applications.
|
|
4367
4225
|
|
|
4368
4226
|
### Installation
|
|
4369
4227
|
|
|
@@ -4372,7 +4230,7 @@ Use Ruflo packages directly in your TypeScript/JavaScript applications.
|
|
|
4372
4230
|
npm install @claude-flow/cli @claude-flow/memory @claude-flow/swarm
|
|
4373
4231
|
|
|
4374
4232
|
# Or install everything
|
|
4375
|
-
npm install
|
|
4233
|
+
npm install opencode-orchestrator@v3alpha
|
|
4376
4234
|
```
|
|
4377
4235
|
|
|
4378
4236
|
### Quick Examples
|
|
@@ -4409,21 +4267,21 @@ console.log(results);
|
|
|
4409
4267
|
**CLI Commands:**
|
|
4410
4268
|
```bash
|
|
4411
4269
|
# Initialize memory database
|
|
4412
|
-
npx
|
|
4270
|
+
npx opencode-orchestrator@latest memory init --force
|
|
4413
4271
|
|
|
4414
4272
|
# Store patterns
|
|
4415
|
-
npx
|
|
4416
|
-
npx
|
|
4273
|
+
npx opencode-orchestrator@latest memory store --key "pattern-auth" --value "JWT authentication with refresh tokens"
|
|
4274
|
+
npx opencode-orchestrator@latest memory store --key "pattern-cache" --value "Redis caching for API responses"
|
|
4417
4275
|
|
|
4418
4276
|
# Build HNSW index for 150x-12,500x faster search
|
|
4419
|
-
npx
|
|
4277
|
+
npx opencode-orchestrator@latest memory search --query "authentication" --build-hnsw
|
|
4420
4278
|
|
|
4421
4279
|
# Semantic search (uses HNSW if built)
|
|
4422
|
-
npx
|
|
4280
|
+
npx opencode-orchestrator@latest memory search --query "how to cache data" --limit 5
|
|
4423
4281
|
|
|
4424
4282
|
# List and manage entries
|
|
4425
|
-
npx
|
|
4426
|
-
npx
|
|
4283
|
+
npx opencode-orchestrator@latest memory list --namespace patterns
|
|
4284
|
+
npx opencode-orchestrator@latest memory stats
|
|
4427
4285
|
```
|
|
4428
4286
|
|
|
4429
4287
|
</details>
|
|
@@ -4657,35 +4515,35 @@ console.log(`Hit rate: ${(stats.hitRate * 100).toFixed(1)}%`);
|
|
|
4657
4515
|
|
|
4658
4516
|
```bash
|
|
4659
4517
|
# Generate embedding
|
|
4660
|
-
|
|
4518
|
+
opencode-orchestrator embeddings embed "Your text here"
|
|
4661
4519
|
|
|
4662
4520
|
# Batch embed from file
|
|
4663
|
-
|
|
4521
|
+
opencode-orchestrator embeddings batch documents.txt -o embeddings.json
|
|
4664
4522
|
|
|
4665
4523
|
# Similarity search
|
|
4666
|
-
|
|
4524
|
+
opencode-orchestrator embeddings search "query" --index ./vectors
|
|
4667
4525
|
|
|
4668
4526
|
# Document chunking
|
|
4669
|
-
|
|
4527
|
+
opencode-orchestrator embeddings chunk document.txt --strategy sentence --max-size 512
|
|
4670
4528
|
|
|
4671
4529
|
# Normalize embeddings
|
|
4672
|
-
|
|
4530
|
+
opencode-orchestrator embeddings normalize embeddings.json --type l2 -o normalized.json
|
|
4673
4531
|
|
|
4674
4532
|
# Convert to hyperbolic
|
|
4675
|
-
|
|
4533
|
+
opencode-orchestrator embeddings hyperbolic embeddings.json -o poincare.json
|
|
4676
4534
|
|
|
4677
4535
|
# Neural operations
|
|
4678
|
-
|
|
4679
|
-
|
|
4680
|
-
|
|
4536
|
+
opencode-orchestrator embeddings neural drift --baseline "context" --input "check"
|
|
4537
|
+
opencode-orchestrator embeddings neural store --id mem-1 --content "data"
|
|
4538
|
+
opencode-orchestrator embeddings neural recall "query" --top-k 5
|
|
4681
4539
|
|
|
4682
4540
|
# Model management
|
|
4683
|
-
|
|
4684
|
-
|
|
4541
|
+
opencode-orchestrator embeddings models list
|
|
4542
|
+
opencode-orchestrator embeddings models download all-MiniLM-L6-v2
|
|
4685
4543
|
|
|
4686
4544
|
# Cache management
|
|
4687
|
-
|
|
4688
|
-
|
|
4545
|
+
opencode-orchestrator embeddings cache stats
|
|
4546
|
+
opencode-orchestrator embeddings cache clear --older-than 7d
|
|
4689
4547
|
```
|
|
4690
4548
|
|
|
4691
4549
|
### Available Models
|
|
@@ -4752,7 +4610,7 @@ await hooks.endTrajectory(trajectory, { success: true });
|
|
|
4752
4610
|
|
|
4753
4611
|
## 🔗 Ecosystem & Integrations
|
|
4754
4612
|
|
|
4755
|
-
Core infrastructure packages powering
|
|
4613
|
+
Core infrastructure packages powering OpenCode Orchestrator's intelligence layer.
|
|
4756
4614
|
|
|
4757
4615
|
<details>
|
|
4758
4616
|
<summary>⚡ <strong>Agentic-Flow Integration</strong> — Core AI Infrastructure</summary>
|
|
@@ -4761,7 +4619,7 @@ Core infrastructure packages powering Ruflo's intelligence layer.
|
|
|
4761
4619
|
[](https://www.npmjs.com/package/agentic-flow)
|
|
4762
4620
|
[](https://github.com/ruvnet/agentic-flow)
|
|
4763
4621
|
|
|
4764
|
-
|
|
4622
|
+
OpenCode Orchestrator v3 is built on top of **[agentic-flow](https://github.com/ruvnet/agentic-flow)**, a production-ready AI agent orchestration platform. This deep integration provides 352x faster code transformations, learning memory, and geometric intelligence.
|
|
4765
4623
|
|
|
4766
4624
|
### Quick Start
|
|
4767
4625
|
|
|
@@ -5042,9 +4900,9 @@ claude mcp add agentic-flow -- npx agentic-flow mcp start
|
|
|
5042
4900
|
|
|
5043
4901
|
</details>
|
|
5044
4902
|
|
|
5045
|
-
### Integration with
|
|
4903
|
+
### Integration with OpenCode Orchestrator
|
|
5046
4904
|
|
|
5047
|
-
|
|
4905
|
+
OpenCode Orchestrator automatically leverages agentic-flow for:
|
|
5048
4906
|
|
|
5049
4907
|
| Feature | How It's Used |
|
|
5050
4908
|
|---------|---------------|
|
|
@@ -5055,7 +4913,7 @@ Ruflo automatically leverages agentic-flow for:
|
|
|
5055
4913
|
| **Embedding Search** | HNSW-indexed vector search (150x faster) |
|
|
5056
4914
|
|
|
5057
4915
|
```typescript
|
|
5058
|
-
//
|
|
4916
|
+
// OpenCode Orchestrator automatically uses agentic-flow optimizations
|
|
5059
4917
|
import { getTokenOptimizer } from '@claude-flow/integration';
|
|
5060
4918
|
|
|
5061
4919
|
const optimizer = await getTokenOptimizer();
|
|
@@ -5231,9 +5089,9 @@ jj.enableEncryption(key);
|
|
|
5231
5089
|
|
|
5232
5090
|
</details>
|
|
5233
5091
|
|
|
5234
|
-
###
|
|
5092
|
+
### OpenCode Orchestrator Skill
|
|
5235
5093
|
|
|
5236
|
-
|
|
5094
|
+
OpenCode Orchestrator includes a dedicated `/agentic-jujutsu` skill for AI-powered version control:
|
|
5237
5095
|
|
|
5238
5096
|
```bash
|
|
5239
5097
|
# Invoke the skill
|
|
@@ -5316,7 +5174,7 @@ npx agentic-jujutsu examples # Show usage examples
|
|
|
5316
5174
|
[](https://github.com/ruvnet/ruvector)
|
|
5317
5175
|
[](https://hub.docker.com/r/ruvnet/ruvector-postgres)
|
|
5318
5176
|
|
|
5319
|
-
**RuVector** is a high-performance distributed vector database combining vector search, graph queries, and self-learning neural networks. Written in Rust with Node.js/WASM bindings, it powers
|
|
5177
|
+
**RuVector** is a high-performance distributed vector database combining vector search, graph queries, and self-learning neural networks. Written in Rust with Node.js/WASM bindings, it powers OpenCode Orchestrator's intelligence layer with native speed.
|
|
5320
5178
|
|
|
5321
5179
|
### Key Capabilities
|
|
5322
5180
|
|
|
@@ -5398,7 +5256,7 @@ const compressed = ruvector.compress(embedding, 0.3); // 30% quality threshold
|
|
|
5398
5256
|
|
|
5399
5257
|
```bash
|
|
5400
5258
|
# Quick setup with CLI (recommended)
|
|
5401
|
-
npx
|
|
5259
|
+
npx opencode-orchestrator ruvector setup --output ./my-ruvector
|
|
5402
5260
|
cd my-ruvector && docker-compose up -d
|
|
5403
5261
|
|
|
5404
5262
|
# Or pull directly from Docker Hub
|
|
@@ -5406,12 +5264,12 @@ docker run -d \
|
|
|
5406
5264
|
--name ruvector-postgres \
|
|
5407
5265
|
-p 5432:5432 \
|
|
5408
5266
|
-e POSTGRES_USER=claude \
|
|
5409
|
-
-e POSTGRES_PASSWORD=
|
|
5267
|
+
-e POSTGRES_PASSWORD=opencode-orchestrator-test \
|
|
5410
5268
|
-e POSTGRES_DB=claude_flow \
|
|
5411
5269
|
ruvnet/ruvector-postgres
|
|
5412
5270
|
|
|
5413
5271
|
# Migrate existing memory to PostgreSQL
|
|
5414
|
-
npx
|
|
5272
|
+
npx opencode-orchestrator ruvector import --input memory-export.json
|
|
5415
5273
|
```
|
|
5416
5274
|
|
|
5417
5275
|
**RuVector PostgreSQL vs pgvector:**
|
|
@@ -5568,12 +5426,12 @@ await db.createHyperedge(['agent-1', 'agent-2', 'agent-3'], {
|
|
|
5568
5426
|
|
|
5569
5427
|
</details>
|
|
5570
5428
|
|
|
5571
|
-
### Integration with
|
|
5429
|
+
### Integration with OpenCode Orchestrator
|
|
5572
5430
|
|
|
5573
|
-
|
|
5431
|
+
OpenCode Orchestrator automatically uses RuVector when available:
|
|
5574
5432
|
|
|
5575
5433
|
```typescript
|
|
5576
|
-
//
|
|
5434
|
+
// OpenCode Orchestrator detects and uses native ruvector
|
|
5577
5435
|
import { getVectorStore } from '@claude-flow/memory';
|
|
5578
5436
|
|
|
5579
5437
|
const store = await getVectorStore();
|
|
@@ -5591,19 +5449,19 @@ const similarity = attention.attention(queries, keys, values);
|
|
|
5591
5449
|
|
|
5592
5450
|
```bash
|
|
5593
5451
|
# RuVector PostgreSQL Setup (generates Docker files + SQL)
|
|
5594
|
-
npx
|
|
5595
|
-
npx
|
|
5596
|
-
npx
|
|
5452
|
+
npx opencode-orchestrator ruvector setup # Output to ./ruvector-postgres
|
|
5453
|
+
npx opencode-orchestrator ruvector setup --output ./mydir # Custom directory
|
|
5454
|
+
npx opencode-orchestrator ruvector setup --print # Preview files
|
|
5597
5455
|
|
|
5598
5456
|
# Import from sql.js/JSON to PostgreSQL
|
|
5599
|
-
npx
|
|
5600
|
-
npx
|
|
5457
|
+
npx opencode-orchestrator ruvector import --input data.json # Direct import
|
|
5458
|
+
npx opencode-orchestrator ruvector import --input data.json --output sql # Dry-run (generate SQL)
|
|
5601
5459
|
|
|
5602
5460
|
# Other RuVector commands
|
|
5603
|
-
npx
|
|
5604
|
-
npx
|
|
5605
|
-
npx
|
|
5606
|
-
npx
|
|
5461
|
+
npx opencode-orchestrator ruvector status --verbose # Check connection
|
|
5462
|
+
npx opencode-orchestrator ruvector benchmark --vectors 10000 # Performance test
|
|
5463
|
+
npx opencode-orchestrator ruvector optimize --analyze # Optimization suggestions
|
|
5464
|
+
npx opencode-orchestrator ruvector backup --output backup.sql # Backup data
|
|
5607
5465
|
|
|
5608
5466
|
# Native ruvector CLI
|
|
5609
5467
|
npx ruvector status # Check installation
|
|
@@ -5630,11 +5488,11 @@ Cloud platform integration and deployment tools.
|
|
|
5630
5488
|
<details>
|
|
5631
5489
|
<summary>☁️ <strong>Flow Nexus</strong> — Cloud Platform Integration</summary>
|
|
5632
5490
|
|
|
5633
|
-
Flow Nexus is a **cloud platform** for deploying and scaling
|
|
5491
|
+
Flow Nexus is a **cloud platform** for deploying and scaling OpenCode Orchestrator beyond your local machine.
|
|
5634
5492
|
|
|
5635
5493
|
### What Flow Nexus Provides
|
|
5636
5494
|
|
|
5637
|
-
| Feature | Local
|
|
5495
|
+
| Feature | Local OpenCode Orchestrator | + Flow Nexus |
|
|
5638
5496
|
|---------|-------------------|--------------|
|
|
5639
5497
|
| **Swarm Scale** | 15 agents (local resources) | 100+ agents (cloud resources) |
|
|
5640
5498
|
| **Neural Training** | Limited by local GPU/CPU | Distributed GPU clusters |
|
|
@@ -5683,7 +5541,7 @@ Flow Nexus is a **cloud platform** for deploying and scaling Ruflo beyond your l
|
|
|
5683
5541
|
/flow-nexus-swarm
|
|
5684
5542
|
|
|
5685
5543
|
# Or via CLI
|
|
5686
|
-
npx
|
|
5544
|
+
npx opencode-orchestrator@v3alpha nexus swarm deploy \
|
|
5687
5545
|
--topology hierarchical \
|
|
5688
5546
|
--max-agents 50 \
|
|
5689
5547
|
--region us-east-1
|
|
@@ -5695,13 +5553,13 @@ Isolated execution environments for running untrusted code:
|
|
|
5695
5553
|
|
|
5696
5554
|
```bash
|
|
5697
5555
|
# Create sandbox
|
|
5698
|
-
npx
|
|
5556
|
+
npx opencode-orchestrator@v3alpha nexus sandbox create --language python
|
|
5699
5557
|
|
|
5700
5558
|
# Execute code safely
|
|
5701
|
-
npx
|
|
5559
|
+
npx opencode-orchestrator@v3alpha nexus sandbox exec --code "print('Hello')"
|
|
5702
5560
|
|
|
5703
5561
|
# Cleanup
|
|
5704
|
-
npx
|
|
5562
|
+
npx opencode-orchestrator@v3alpha nexus sandbox destroy
|
|
5705
5563
|
```
|
|
5706
5564
|
|
|
5707
5565
|
### Event-Driven Workflows
|
|
@@ -5727,10 +5585,10 @@ steps:
|
|
|
5727
5585
|
# 1. Sign up at flow-nexus.io
|
|
5728
5586
|
# 2. Get API key
|
|
5729
5587
|
# 3. Configure
|
|
5730
|
-
npx
|
|
5588
|
+
npx opencode-orchestrator@v3alpha nexus configure --api-key <key>
|
|
5731
5589
|
|
|
5732
5590
|
# 4. Deploy
|
|
5733
|
-
npx
|
|
5591
|
+
npx opencode-orchestrator@v3alpha nexus swarm deploy
|
|
5734
5592
|
```
|
|
5735
5593
|
|
|
5736
5594
|
</details>
|
|
@@ -5764,7 +5622,7 @@ Stream-Chain enables **sequential processing** where the output of one agent bec
|
|
|
5764
5622
|
/stream-chain
|
|
5765
5623
|
|
|
5766
5624
|
# Define pipeline
|
|
5767
|
-
npx
|
|
5625
|
+
npx opencode-orchestrator@v3alpha stream-chain create \
|
|
5768
5626
|
--name "feature-pipeline" \
|
|
5769
5627
|
--stages "researcher,architect,coder,tester,reviewer"
|
|
5770
5628
|
```
|
|
@@ -5806,11 +5664,11 @@ stages:
|
|
|
5806
5664
|
|
|
5807
5665
|
```bash
|
|
5808
5666
|
# Run the pipeline
|
|
5809
|
-
npx
|
|
5667
|
+
npx opencode-orchestrator@v3alpha stream-chain run feature-pipeline \
|
|
5810
5668
|
--input '{"requirements": "Add user dashboard with analytics"}'
|
|
5811
5669
|
|
|
5812
5670
|
# Monitor progress
|
|
5813
|
-
npx
|
|
5671
|
+
npx opencode-orchestrator@v3alpha stream-chain status feature-pipeline
|
|
5814
5672
|
```
|
|
5815
5673
|
|
|
5816
5674
|
### Use Cases
|
|
@@ -5850,7 +5708,7 @@ The Pair Programming skill provides **human-AI collaborative coding** with role
|
|
|
5850
5708
|
/pair-programming --mode tdd
|
|
5851
5709
|
|
|
5852
5710
|
# Via CLI
|
|
5853
|
-
npx
|
|
5711
|
+
npx opencode-orchestrator@v3alpha pair start --mode navigator
|
|
5854
5712
|
```
|
|
5855
5713
|
|
|
5856
5714
|
### TDD Mode Workflow
|
|
@@ -5890,16 +5748,16 @@ npx ruflo@v3alpha pair start --mode navigator
|
|
|
5890
5748
|
|
|
5891
5749
|
```bash
|
|
5892
5750
|
# Switch roles mid-session
|
|
5893
|
-
npx
|
|
5751
|
+
npx opencode-orchestrator@v3alpha pair switch
|
|
5894
5752
|
|
|
5895
5753
|
# Get AI explanation
|
|
5896
|
-
npx
|
|
5754
|
+
npx opencode-orchestrator@v3alpha pair explain
|
|
5897
5755
|
|
|
5898
5756
|
# Run tests
|
|
5899
|
-
npx
|
|
5757
|
+
npx opencode-orchestrator@v3alpha pair test
|
|
5900
5758
|
|
|
5901
5759
|
# End session with summary
|
|
5902
|
-
npx
|
|
5760
|
+
npx opencode-orchestrator@v3alpha pair end
|
|
5903
5761
|
```
|
|
5904
5762
|
|
|
5905
5763
|
</details>
|
|
@@ -5956,22 +5814,22 @@ Detection Time: 0.04ms | 50+ Patterns | Self-Learning | HNSW Vector Search
|
|
|
5956
5814
|
|
|
5957
5815
|
```bash
|
|
5958
5816
|
# Basic threat scan
|
|
5959
|
-
npx
|
|
5817
|
+
npx opencode-orchestrator@v3alpha security defend -i "ignore previous instructions"
|
|
5960
5818
|
|
|
5961
5819
|
# Scan a file
|
|
5962
|
-
npx
|
|
5820
|
+
npx opencode-orchestrator@v3alpha security defend -f ./user-prompts.txt
|
|
5963
5821
|
|
|
5964
5822
|
# Quick scan (faster)
|
|
5965
|
-
npx
|
|
5823
|
+
npx opencode-orchestrator@v3alpha security defend -i "some text" --quick
|
|
5966
5824
|
|
|
5967
5825
|
# JSON output
|
|
5968
|
-
npx
|
|
5826
|
+
npx opencode-orchestrator@v3alpha security defend -i "test" -o json
|
|
5969
5827
|
|
|
5970
5828
|
# View statistics
|
|
5971
|
-
npx
|
|
5829
|
+
npx opencode-orchestrator@v3alpha security defend --stats
|
|
5972
5830
|
|
|
5973
5831
|
# Full security audit
|
|
5974
|
-
npx
|
|
5832
|
+
npx opencode-orchestrator@v3alpha security scan --depth full
|
|
5975
5833
|
```
|
|
5976
5834
|
|
|
5977
5835
|
### MCP Tools
|
|
@@ -6163,7 +6021,7 @@ Domain-Driven Design with bounded contexts, clean architecture, and measured per
|
|
|
6163
6021
|
|
|
6164
6022
|
[](https://www.npmjs.com/package/@claude-flow/browser)
|
|
6165
6023
|
|
|
6166
|
-
AI-optimized browser automation integrating [agent-browser](https://github.com/AugmentCode/agent-browser) with
|
|
6024
|
+
AI-optimized browser automation integrating [agent-browser](https://github.com/AugmentCode/agent-browser) with opencode-orchestrator for intelligent web automation, trajectory learning, and multi-agent browser coordination.
|
|
6167
6025
|
|
|
6168
6026
|
### Installation
|
|
6169
6027
|
|
|
@@ -6248,7 +6106,7 @@ const template = getWorkflow('login-basic');
|
|
|
6248
6106
|
<details>
|
|
6249
6107
|
<summary>📦 <strong>Release Management</strong> — @claude-flow/deployment</summary>
|
|
6250
6108
|
|
|
6251
|
-
Automated release management, versioning, and CI/CD for
|
|
6109
|
+
Automated release management, versioning, and CI/CD for OpenCode Orchestrator packages.
|
|
6252
6110
|
|
|
6253
6111
|
### Features
|
|
6254
6112
|
|
|
@@ -6562,10 +6420,10 @@ npm run bench:attention
|
|
|
6562
6420
|
npm run bench:startup
|
|
6563
6421
|
|
|
6564
6422
|
# Performance report
|
|
6565
|
-
npx
|
|
6423
|
+
npx opencode-orchestrator@v3alpha performance report
|
|
6566
6424
|
|
|
6567
6425
|
# Benchmark specific suite
|
|
6568
|
-
npx
|
|
6426
|
+
npx opencode-orchestrator@v3alpha performance benchmark --suite memory
|
|
6569
6427
|
```
|
|
6570
6428
|
|
|
6571
6429
|
</details>
|
|
@@ -6946,7 +6804,7 @@ export CLAUDE_FLOW_MEMORY_PATH="./data"
|
|
|
6946
6804
|
| `GCS_PROJECT_ID` | GCS project ID | Optional |
|
|
6947
6805
|
| `GOOGLE_CLOUD_PROJECT` | Alternative project ID variable | Optional |
|
|
6948
6806
|
| `GOOGLE_APPLICATION_CREDENTIALS` | Path to GCS service account JSON | Optional |
|
|
6949
|
-
| `GCS_PREFIX` | Prefix for stored files | `
|
|
6807
|
+
| `GCS_PREFIX` | Prefix for stored files | `opencode-orchestrator-patterns` |
|
|
6950
6808
|
|
|
6951
6809
|
### Auto-Update System
|
|
6952
6810
|
|
|
@@ -7017,9 +6875,9 @@ CLAUDE_FLOW_HNSW_EF=200
|
|
|
7017
6875
|
|
|
7018
6876
|
### Configuration File Location
|
|
7019
6877
|
|
|
7020
|
-
|
|
6878
|
+
OpenCode Orchestrator looks for configuration in this order:
|
|
7021
6879
|
1. `./claude-flow.config.json` (project root)
|
|
7022
|
-
2. `~/.config/
|
|
6880
|
+
2. `~/.config/opencode-orchestrator/config.json` (user config)
|
|
7023
6881
|
3. Environment variables (override any file config)
|
|
7024
6882
|
|
|
7025
6883
|
### Complete Configuration Schema
|
|
@@ -7119,7 +6977,7 @@ Ruflo looks for configuration in this order:
|
|
|
7119
6977
|
"level": "info",
|
|
7120
6978
|
"format": "json",
|
|
7121
6979
|
"destination": "console",
|
|
7122
|
-
"filePath": "./logs/
|
|
6980
|
+
"filePath": "./logs/opencode-orchestrator.log",
|
|
7123
6981
|
"maxFileSize": "100MB",
|
|
7124
6982
|
"maxFiles": 10
|
|
7125
6983
|
},
|
|
@@ -7186,7 +7044,7 @@ Ruflo looks for configuration in this order:
|
|
|
7186
7044
|
"version": "3.0.0",
|
|
7187
7045
|
"memory": {
|
|
7188
7046
|
"type": "hybrid",
|
|
7189
|
-
"path": "/var/lib/
|
|
7047
|
+
"path": "/var/lib/opencode-orchestrator/data",
|
|
7190
7048
|
"encryption": { "enabled": true, "algorithm": "aes-256-gcm" }
|
|
7191
7049
|
},
|
|
7192
7050
|
"swarm": { "topology": "hierarchical", "maxAgents": 15 },
|
|
@@ -7198,7 +7056,7 @@ Ruflo looks for configuration in this order:
|
|
|
7198
7056
|
"level": "warn",
|
|
7199
7057
|
"format": "json",
|
|
7200
7058
|
"destination": "file",
|
|
7201
|
-
"filePath": "/var/log/
|
|
7059
|
+
"filePath": "/var/log/opencode-orchestrator/production.log"
|
|
7202
7060
|
},
|
|
7203
7061
|
"monitoring": { "enabled": true, "metricsInterval": 30000 }
|
|
7204
7062
|
}
|
|
@@ -7242,25 +7100,25 @@ Ruflo looks for configuration in this order:
|
|
|
7242
7100
|
|
|
7243
7101
|
```bash
|
|
7244
7102
|
# View current configuration
|
|
7245
|
-
npx
|
|
7103
|
+
npx opencode-orchestrator@v3alpha config list
|
|
7246
7104
|
|
|
7247
7105
|
# Get specific value
|
|
7248
|
-
npx
|
|
7106
|
+
npx opencode-orchestrator@v3alpha config get --key memory.type
|
|
7249
7107
|
|
|
7250
7108
|
# Set configuration value
|
|
7251
|
-
npx
|
|
7109
|
+
npx opencode-orchestrator@v3alpha config set --key swarm.maxAgents --value 10
|
|
7252
7110
|
|
|
7253
7111
|
# Export configuration
|
|
7254
|
-
npx
|
|
7112
|
+
npx opencode-orchestrator@v3alpha config export > my-config.json
|
|
7255
7113
|
|
|
7256
7114
|
# Import configuration
|
|
7257
|
-
npx
|
|
7115
|
+
npx opencode-orchestrator@v3alpha config import --file my-config.json
|
|
7258
7116
|
|
|
7259
7117
|
# Reset to defaults
|
|
7260
|
-
npx
|
|
7118
|
+
npx opencode-orchestrator@v3alpha config reset --key swarm
|
|
7261
7119
|
|
|
7262
7120
|
# Initialize with wizard
|
|
7263
|
-
npx
|
|
7121
|
+
npx opencode-orchestrator@v3alpha init --wizard
|
|
7264
7122
|
```
|
|
7265
7123
|
|
|
7266
7124
|
</details>
|
|
@@ -7284,7 +7142,7 @@ lsof -i :3000
|
|
|
7284
7142
|
# Kill existing process
|
|
7285
7143
|
kill -9 <PID>
|
|
7286
7144
|
# Restart MCP server
|
|
7287
|
-
npx
|
|
7145
|
+
npx opencode-orchestrator@v3alpha mcp start
|
|
7288
7146
|
```
|
|
7289
7147
|
|
|
7290
7148
|
**Agent spawn failures**
|
|
@@ -7298,9 +7156,9 @@ export CLAUDE_FLOW_MAX_AGENTS=5
|
|
|
7298
7156
|
**Pattern search returning no results**
|
|
7299
7157
|
```bash
|
|
7300
7158
|
# Verify patterns are stored
|
|
7301
|
-
npx
|
|
7159
|
+
npx opencode-orchestrator@v3alpha hooks metrics
|
|
7302
7160
|
# Re-run pretraining if empty
|
|
7303
|
-
npx
|
|
7161
|
+
npx opencode-orchestrator@v3alpha hooks pretrain
|
|
7304
7162
|
```
|
|
7305
7163
|
|
|
7306
7164
|
**Windows path issues**
|
|
@@ -7308,7 +7166,7 @@ npx ruflo@v3alpha hooks pretrain
|
|
|
7308
7166
|
# Use forward slashes or escape backslashes
|
|
7309
7167
|
$env:CLAUDE_FLOW_MEMORY_PATH = "./data"
|
|
7310
7168
|
# Or use absolute path
|
|
7311
|
-
$env:CLAUDE_FLOW_MEMORY_PATH = "C:/Users/name/
|
|
7169
|
+
$env:CLAUDE_FLOW_MEMORY_PATH = "C:/Users/name/opencode-orchestrator/data"
|
|
7312
7170
|
```
|
|
7313
7171
|
|
|
7314
7172
|
**Permission denied errors**
|
|
@@ -7321,7 +7179,7 @@ sudo chown -R $(whoami) ~/.npm
|
|
|
7321
7179
|
**High memory usage**
|
|
7322
7180
|
```bash
|
|
7323
7181
|
# Enable garbage collection
|
|
7324
|
-
node --expose-gc node_modules/.bin/
|
|
7182
|
+
node --expose-gc node_modules/.bin/opencode-orchestrator
|
|
7325
7183
|
# Reduce HNSW parameters for lower memory
|
|
7326
7184
|
export CLAUDE_FLOW_HNSW_M=8
|
|
7327
7185
|
export CLAUDE_FLOW_HNSW_EF=100
|
|
@@ -7353,45 +7211,45 @@ export CLAUDE_FLOW_HNSW_EF=100
|
|
|
7353
7211
|
|
|
7354
7212
|
| Change | V2 | V3 | Impact |
|
|
7355
7213
|
|--------|----|----|--------|
|
|
7356
|
-
| **Package Structure** | `
|
|
7214
|
+
| **Package Structure** | `opencode-orchestrator` | `@claude-flow/*` (scoped) | Update imports |
|
|
7357
7215
|
| **Memory Backend** | JSON files | AgentDB + HNSW | Faster search |
|
|
7358
7216
|
| **Hooks System** | Basic patterns | ReasoningBank + SONA | Self-learning |
|
|
7359
7217
|
| **Security** | Manual validation | Automatic strict mode | More secure |
|
|
7360
7218
|
| **CLI Commands** | Flat structure | Nested subcommands | New syntax |
|
|
7361
|
-
| **Config Format** | `.
|
|
7219
|
+
| **Config Format** | `.opencode-orchestrator/config.json` | `claude-flow.config.json` | Update path |
|
|
7362
7220
|
|
|
7363
7221
|
### Step-by-Step Migration
|
|
7364
7222
|
|
|
7365
7223
|
```bash
|
|
7366
7224
|
# STEP 1: Backup existing data (CRITICAL)
|
|
7367
7225
|
cp -r ./data ./data-backup-v2
|
|
7368
|
-
cp -r ./.
|
|
7226
|
+
cp -r ./.opencode-orchestrator ./.opencode-orchestrator-backup-v2
|
|
7369
7227
|
|
|
7370
7228
|
# STEP 2: Check migration status
|
|
7371
|
-
npx
|
|
7229
|
+
npx opencode-orchestrator@v3alpha migrate status
|
|
7372
7230
|
|
|
7373
7231
|
# STEP 3: Run migration with dry-run first
|
|
7374
|
-
npx
|
|
7232
|
+
npx opencode-orchestrator@v3alpha migrate run --dry-run
|
|
7375
7233
|
|
|
7376
7234
|
# STEP 4: Execute migration
|
|
7377
|
-
npx
|
|
7235
|
+
npx opencode-orchestrator@v3alpha migrate run --from v2
|
|
7378
7236
|
|
|
7379
7237
|
# STEP 5: Verify migration
|
|
7380
|
-
npx
|
|
7238
|
+
npx opencode-orchestrator@v3alpha migrate verify
|
|
7381
7239
|
|
|
7382
7240
|
# STEP 6: Initialize V3 learning
|
|
7383
|
-
npx
|
|
7384
|
-
npx
|
|
7241
|
+
npx opencode-orchestrator@v3alpha hooks pretrain
|
|
7242
|
+
npx opencode-orchestrator@v3alpha doctor --fix
|
|
7385
7243
|
```
|
|
7386
7244
|
|
|
7387
7245
|
### Command Changes Reference
|
|
7388
7246
|
|
|
7389
7247
|
| V2 Command | V3 Command | Notes |
|
|
7390
7248
|
|------------|------------|-------|
|
|
7391
|
-
| `
|
|
7392
|
-
| `
|
|
7393
|
-
| `
|
|
7394
|
-
| `
|
|
7249
|
+
| `opencode-orchestrator start` | `opencode-orchestrator mcp start` | MCP is explicit |
|
|
7250
|
+
| `opencode-orchestrator init` | `opencode-orchestrator init --wizard` | Interactive mode |
|
|
7251
|
+
| `opencode-orchestrator spawn <type>` | `opencode-orchestrator agent spawn -t <type>` | Nested under `agent` |
|
|
7252
|
+
| `opencode-orchestrator swarm create` | `opencode-orchestrator swarm init --topology mesh` | Explicit topology |
|
|
7395
7253
|
| `--pattern-store path` | `--memory-backend agentdb` | Backend selection |
|
|
7396
7254
|
| `hooks record` | `hooks post-edit --success true` | Explicit success flag |
|
|
7397
7255
|
| `memory get <key>` | `memory retrieve --key <key>` | Explicit flag |
|
|
@@ -7401,7 +7259,7 @@ npx ruflo@v3alpha doctor --fix
|
|
|
7401
7259
|
|
|
7402
7260
|
### Configuration Migration
|
|
7403
7261
|
|
|
7404
|
-
**V2 Config (`.
|
|
7262
|
+
**V2 Config (`.opencode-orchestrator/config.json`)**:
|
|
7405
7263
|
```json
|
|
7406
7264
|
{
|
|
7407
7265
|
"mode": "basic",
|
|
@@ -7433,7 +7291,7 @@ npx ruflo@v3alpha doctor --fix
|
|
|
7433
7291
|
|
|
7434
7292
|
```typescript
|
|
7435
7293
|
// V2 (deprecated)
|
|
7436
|
-
import { ClaudeFlow, Agent, Memory } from '
|
|
7294
|
+
import { ClaudeFlow, Agent, Memory } from 'opencode-orchestrator';
|
|
7437
7295
|
|
|
7438
7296
|
// V3 (new)
|
|
7439
7297
|
import { ClaudeFlowClient } from '@claude-flow/cli';
|
|
@@ -7448,10 +7306,10 @@ If migration fails, you can rollback:
|
|
|
7448
7306
|
|
|
7449
7307
|
```bash
|
|
7450
7308
|
# Check rollback options
|
|
7451
|
-
npx
|
|
7309
|
+
npx opencode-orchestrator@v3alpha migrate rollback --list
|
|
7452
7310
|
|
|
7453
7311
|
# Rollback to V2
|
|
7454
|
-
npx
|
|
7312
|
+
npx opencode-orchestrator@v3alpha migrate rollback --to v2
|
|
7455
7313
|
|
|
7456
7314
|
# Restore backup manually if needed
|
|
7457
7315
|
rm -rf ./data
|
|
@@ -7460,12 +7318,12 @@ cp -r ./data-backup-v2 ./data
|
|
|
7460
7318
|
|
|
7461
7319
|
### Post-Migration Checklist
|
|
7462
7320
|
|
|
7463
|
-
- [ ] Verify all agents spawn correctly: `npx
|
|
7464
|
-
- [ ] Check memory search works: `npx
|
|
7465
|
-
- [ ] Confirm MCP server starts: `npx
|
|
7466
|
-
- [ ] Run doctor diagnostics: `npx
|
|
7467
|
-
- [ ] Test a simple swarm: `npx
|
|
7468
|
-
- [ ] Bootstrap learning: `npx
|
|
7321
|
+
- [ ] Verify all agents spawn correctly: `npx opencode-orchestrator@v3alpha agent list`
|
|
7322
|
+
- [ ] Check memory search works: `npx opencode-orchestrator@v3alpha memory search -q "test"`
|
|
7323
|
+
- [ ] Confirm MCP server starts: `npx opencode-orchestrator@v3alpha mcp start`
|
|
7324
|
+
- [ ] Run doctor diagnostics: `npx opencode-orchestrator@v3alpha doctor`
|
|
7325
|
+
- [ ] Test a simple swarm: `npx opencode-orchestrator@v3alpha swarm init --topology mesh`
|
|
7326
|
+
- [ ] Bootstrap learning: `npx opencode-orchestrator@v3alpha hooks pretrain`
|
|
7469
7327
|
|
|
7470
7328
|
### Common Migration Issues
|
|
7471
7329
|
|
|
@@ -7519,14 +7377,13 @@ cp -r ./data-backup-v2 ./data
|
|
|
7519
7377
|
|
|
7520
7378
|
| Resource | Link |
|
|
7521
7379
|
|----------|------|
|
|
7522
|
-
| 📚 Documentation | [github.com/
|
|
7523
|
-
| 🐛 Issues & Bugs | [github.com/
|
|
7524
|
-
| 💼 Professional Implementation | [ruv.io](https://ruv.io) — Enterprise consulting, custom integrations, and production deployment |
|
|
7380
|
+
| 📚 Documentation | [github.com/pedrocosta95/opencode-orchestrator](https://github.com/pedrocosta95/opencode-orchestrator) |
|
|
7381
|
+
| 🐛 Issues & Bugs | [github.com/pedrocosta95/opencode-orchestrator/issues](https://github.com/pedrocosta95/opencode-orchestrator/issues) |
|
|
7525
7382
|
| 💬 Discord Community | [Agentics Foundation](https://discord.com/invite/dfxmpwkG2D) |
|
|
7526
7383
|
|
|
7527
7384
|
## License
|
|
7528
7385
|
|
|
7529
|
-
MIT - [
|
|
7386
|
+
MIT - [pedrocosta95](https://github.com/pedrocosta95)
|
|
7530
7387
|
|
|
7531
7388
|
|
|
7532
7389
|
[](https://www.npmjs.com/package/ruvector)
|