@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.
Files changed (39) hide show
  1. package/.opencode/helpers/auto-memory-hook.mjs +104 -0
  2. package/.opencode/helpers/hook-handler.cjs +223 -0
  3. package/.opencode/helpers/intelligence.cjs +197 -0
  4. package/.opencode/helpers/memory.js +83 -0
  5. package/.opencode/helpers/post-commit +16 -0
  6. package/.opencode/helpers/pre-commit +26 -0
  7. package/.opencode/helpers/router.js +66 -0
  8. package/.opencode/helpers/session.js +127 -0
  9. package/.opencode/helpers/statusline.cjs +774 -0
  10. package/.opencode/settings.json +319 -0
  11. package/package.json +1 -1
  12. package/v3/@claude-flow/cli/README.md +391 -534
  13. package/v3/@claude-flow/cli/dist/src/commands/benchmark.js +2 -2
  14. package/v3/@claude-flow/cli/dist/src/commands/claims.js +1 -1
  15. package/v3/@claude-flow/cli/dist/src/commands/config.js +1 -1
  16. package/v3/@claude-flow/cli/dist/src/commands/daemon.js +3 -3
  17. package/v3/@claude-flow/cli/dist/src/commands/deployment.js +1 -1
  18. package/v3/@claude-flow/cli/dist/src/commands/doctor.js +1 -1
  19. package/v3/@claude-flow/cli/dist/src/commands/embeddings.js +1 -1
  20. package/v3/@claude-flow/cli/dist/src/commands/hooks.js +1 -1
  21. package/v3/@claude-flow/cli/dist/src/commands/init.js +9 -9
  22. package/v3/@claude-flow/cli/dist/src/commands/neural.js +1 -1
  23. package/v3/@claude-flow/cli/dist/src/commands/performance.js +1 -1
  24. package/v3/@claude-flow/cli/dist/src/commands/plugins.js +1 -1
  25. package/v3/@claude-flow/cli/dist/src/commands/providers.js +1 -1
  26. package/v3/@claude-flow/cli/dist/src/commands/security.js +1 -1
  27. package/v3/@claude-flow/cli/dist/src/commands/start.js +10 -10
  28. package/v3/@claude-flow/cli/dist/src/commands/status.js +2 -2
  29. package/v3/@claude-flow/cli/dist/src/commands/transfer-store.js +1 -1
  30. package/v3/@claude-flow/cli/dist/src/memory/memory-initializer.d.ts +1 -1
  31. package/v3/@claude-flow/cli/dist/src/memory/memory-initializer.js +1 -1
  32. package/v3/@claude-flow/cli/dist/src/plugins/store/discovery.js +1 -1
  33. package/v3/@claude-flow/cli/dist/src/runtime/headless.js +3 -3
  34. package/v3/@claude-flow/cli/dist/src/services/claim-service.js +1 -1
  35. package/v3/@claude-flow/cli/dist/src/types.d.ts +1 -1
  36. package/v3/@claude-flow/cli/dist/src/types.js +1 -1
  37. package/v3/@claude-flow/cli/package.json +1 -1
  38. package/v3/@claude-flow/cli/dist/src/init/claudemd-generator.d.ts +0 -25
  39. package/v3/@claude-flow/cli/dist/src/init/claudemd-generator.js +0 -486
@@ -1,40 +1,40 @@
1
- # 🌊 RuFlo v3.5: Enterprise AI Orchestration Platform
1
+ # OpenCode Orchestrator v3.5: Enterprise AI Orchestration Platform
2
2
 
3
3
  <div align="center">
4
4
 
5
- ![Ruflo Banner](ruflo/assets/ruflo-small.jpeg)
5
+ ![OpenCode Orchestrator Banner](opencode-orchestrator/assets/opencode-orchestrator-small.jpeg)
6
6
 
7
7
 
8
8
 
9
- [![GitHub Project of the Day](https://img.shields.io/badge/GitHub-Project%20of%20the%20Day-ff6600?style=for-the-badge&logo=github&logoColor=white)](https://github.com/ruvnet/claude-flow)
9
+ [![GitHub Project](https://img.shields.io/badge/GitHub-OpenCode%20Orchestrator-ff6600?style=for-the-badge&logo=github&logoColor=white)](https://github.com/pedrocosta95/opencode-orchestrator)
10
10
 
11
- [![Star on GitHub](https://img.shields.io/github/stars/ruvnet/claude-flow?style=for-the-badge&logo=github&color=gold)](https://github.com/ruvnet/claude-flow)
11
+ [![Star on GitHub](https://img.shields.io/github/stars/pedrocosta95/opencode-orchestrator?style=for-the-badge&logo=github&color=gold)](https://github.com/pedrocosta95/opencode-orchestrator)
12
12
  [![Monthly Downloads](https://img.shields.io/npm/dm/claude-flow?style=for-the-badge&logo=npm&color=blue&label=Monthly%20Downloads)](https://www.npmjs.com/package/claude-flow)
13
13
  [![Total Downloads](https://img.shields.io/npm/dt/claude-flow?style=for-the-badge&logo=npm&color=cyan&label=Total%20Downloads)](https://www.npmjs.com/package/claude-flow)
14
14
  [![ruv.io](https://img.shields.io/badge/ruv.io-AI%20Platform-green?style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZmlsbD0id2hpdGUiIGQ9Ik0xMiAyQzYuNDggMiAyIDYuNDggMiAxMnM0LjQ4IDEwIDEwIDEwIDEwLTQuNDggMTAtMTBTMTcuNTIgMiAxMiAyem0wIDE4Yy00LjQyIDAtOC0zLjU4LTgtOHMzLjU4LTggOC04IDggMy41OCA4IDgtMy41OCA4LTggOHoiLz48L3N2Zz4=)](https://ruv.io)
15
15
  [![Agentics Foundation](https://img.shields.io/badge/Agentics-Foundation-crimson?style=for-the-badge&logo=openai)](https://discord.com/invite/dfxmpwkG2D)
16
- [![Claude Code](https://img.shields.io/badge/Claude%20Code-SDK%20Integrated-green?style=for-the-badge&logo=anthropic)](https://github.com/ruvnet/claude-flow)
16
+ [![OpenCode](https://img.shields.io/badge/OpenCode-Orchestrator-purple?style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIyNCIgaGVpZ2h0PSIyNCIgdmlld0JveD0iMCAwIDI0IDI0IiBmaWxsPSIjMDAwZmZmIj48Y2lyY2xlIGN4PSIxMiIgY3k9IjEyIiByPSI4Ii8+PHBhdGggZD0iTTEyIDRjLTQuNDIgMC04IDMuNTktOCA4czMuNTkgOCA4IDggOC0zLjU5IDggOC0zLjU5IDggOC04em0wIDE4Yy00LjQyIDAtOC0zLjU5LTgtOHMzLjU5LTggOC04IDggMy41OSA4IDgtMy41OSA4LTggOHoiLz48L3N2Zz4=)](https://github.com/opencode-ai/opencode)
17
17
  [![MIT License](https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge&logo=opensourceinitiative)](https://opensource.org/licenses/MIT)
18
18
  ---
19
19
  [![Follow @ruv](https://img.shields.io/badge/Follow%20%40ruv-000000?style=for-the-badge&logo=x&logoColor=white)](https://x.com/ruv)
20
20
  [![LinkedIn](https://img.shields.io/badge/LinkedIn-Connect-0A66C2?style=for-the-badge&logo=linkedin)](https://www.linkedin.com/in/reuvencohen/)
21
21
  [![YouTube](https://img.shields.io/badge/YouTube-Subscribe-FF0000?style=for-the-badge&logo=youtube&logoColor=white)](https://www.youtube.com/@ReuvenCohen)
22
22
 
23
- # **Production-ready multi-agent AI orchestration for Claude Code**
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 Ruflo?** Claude Flow is now 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. 5,800 commits later, the alpha is over. This is v3.5.
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
- Ruflo is a comprehensive AI agent orchestration framework that transforms Claude Code into a powerful multi-agent development platform. It enables teams to deploy, coordinate, and optimize specialized AI agents working together on complex software engineering tasks.
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 → Ruflo (CLI/MCP) → Router → Swarm → Agents → Memory → LLM Providers
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 Ruflo):
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 Ruflo
146
- npx ruflo@latest hooks intelligence --status
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
- # One-line install (recommended)
155
- curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/claude-flow@main/scripts/install.sh | bash
154
+ # Clone the repository
155
+ git clone https://github.com/pedrocosta95/opencode-orchestrator.git
156
+ cd opencode-orchestrator
156
157
 
157
- # Or full setup with MCP + diagnostics
158
- curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/claude-flow@main/scripts/install.sh | bash -s -- --full
158
+ # Install dependencies
159
+ npm install
159
160
 
160
- # Or via npx
161
- npx ruflo@latest init --wizard
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 Claude Code** - Native integration via MCP (Model Context Protocol). Use ruflo commands directly in your Claude Code sessions with full tool access.
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 Claude Code interface, through intelligent routing, to specialized agents, and finally to LLM providers for reasoning.
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 | Claude Code, CLI | Your interface to control and run commands |
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 Claude Code subscription by 250%</summary>
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 Claude Code usage by 250% or save significantly on direct API costs.
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. Ruflo V3 includes anti-drift defaults that prevent agents from going off-task.
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
- ### Claude Code: With vs Without Ruflo
405
+ ### OpenCode: With vs Without OpenCode Orchestrator
396
406
 
397
- | Capability | Claude Code Alone | Claude Code + Ruflo |
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**: Claude Code must be installed first:
433
+ **IMPORTANT**: OpenCode must be installed first:
424
434
 
425
435
  ```bash
426
- # 1. Install Claude Code globally
427
- npm install -g @anthropic-ai/claude-code
436
+ # 1. Install OpenCode globally
437
+ npm install -g opencode-ai
428
438
 
429
- # 2. (Optional) Skip permissions check for faster setup
430
- claude --dangerously-skip-permissions
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
- # curl-style installer with progress display
439
- curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/claude-flow@main/scripts/install.sh | bash
448
+ # Install globally via npm
449
+ npm install -g @cloudpftc/opencode-orchestrator@latest
440
450
 
441
- # Full setup (global + MCP + diagnostics)
442
- curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/claude-flow@main/scripts/install.sh | bash -s -- --full
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 Claude Code |
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
- curl ... | bash -s -- --global --minimal
471
+ npm install -g opencode-orchestrator@latest --omit=optional
462
472
 
463
473
  # With MCP auto-setup
464
- curl ... | bash -s -- --global --setup-mcp
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 ruflo@latest init
494
+ npx opencode-orchestrator@latest init
485
495
 
486
496
  # Or install globally
487
- npm install -g ruflo@latest
488
- ruflo init
497
+ npm install -g opencode-orchestrator@latest
498
+ opencode-orchestrator init
489
499
 
490
500
  # With Bun (faster)
491
- bunx ruflo@latest init
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 ruflo@latest --omit=optional
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 ruflo@latest init
522
+ npx opencode-orchestrator@latest init
665
523
 
666
- # Start MCP server for Claude Code integration
667
- npx ruflo@latest mcp start
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 ruflo@latest --agent coder --task "Implement user authentication"
528
+ npx opencode-orchestrator@latest --agent coder --task "Implement user authentication"
671
529
 
672
530
  # List available agents
673
- npx ruflo@latest --list
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 ruflo@v3alpha init upgrade
538
+ npx opencode-orchestrator@v3alpha init upgrade
681
539
 
682
540
  # Update AND add any missing skills/agents/commands
683
- npx ruflo@v3alpha init upgrade --add-missing
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
- ### Claude Code MCP Integration
546
+ ### OpenCode MCP Integration
689
547
 
690
- Add ruflo as an MCP server for seamless integration:
548
+ Add opencode-orchestrator as an MCP server for seamless integration:
691
549
 
692
550
  ```bash
693
- # Add ruflo MCP server to Claude Code
694
- claude mcp add ruflo -- npx -y ruflo@latest mcp start
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
- claude mcp list
555
+ opencode mcp list
698
556
  ```
699
557
 
700
- Once added, Claude Code can use all 175+ ruflo MCP tools directly:
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 Ruflo v3?</strong></summary>
569
+ <summary>🆚 <strong>Why OpenCode Orchestrator v3?</strong></summary>
712
570
 
713
- Ruflo v3 introduces **self-learning neural capabilities** that no other agent orchestration framework offers. While competitors require manual agent configuration and static routing, Ruflo learns from every task execution, prevents catastrophic forgetting of successful patterns, and intelligently routes work to specialized experts.
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 | Ruflo v3 | CrewAI | LangGraph | AutoGen | Manus |
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 | Ruflo v3 | CrewAI | LangGraph | AutoGen | Manus |
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 | Ruflo v3 | CrewAI | LangGraph | AutoGen | Manus |
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 | Ruflo v3 | CrewAI | LangGraph | AutoGen | Manus |
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 | Ruflo v3 | CrewAI | LangGraph | AutoGen | Manus |
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 Ruflo 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.
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. Ruflo 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.
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. Ruflo 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.
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 (Claude Code ↔ AgentDB bidirectional sync)
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[Claude Code]
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: Claude Code auto memory files ↔ AgentDB | ADR-048 |
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
- Ruflo V3 integrates AgentDB v3 (3.0.0-alpha.10) providing 20+ memory controllers accessible via MCP tools and the CLI.
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 Ruflo to your development environment.
1031
+ Connect OpenCode Orchestrator to your development environment.
1174
1032
 
1175
1033
  <details>
1176
- <summary>🔌 <strong>MCP Setup</strong> — Connect Ruflo to Any AI Environment</summary>
1034
+ <summary>🔌 <strong>MCP Setup</strong> — Connect OpenCode Orchestrator to Any AI Environment</summary>
1177
1035
 
1178
- Ruflo runs as an MCP (Model Context Protocol) server, allowing you to connect it to any MCP-compatible AI client. This means you can use Ruflo's 60+ agents, swarm coordination, and self-learning capabilities from Claude Desktop, VS Code, Cursor, Windsurf, ChatGPT, and more.
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 Ruflo MCP server in any environment
1184
- npx ruflo@v3alpha mcp start
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
- "ruflo": {
1057
+ "opencode-orchestrator": {
1200
1058
  "command": "npx",
1201
- "args": ["ruflo@v3alpha", "mcp", "start"],
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>Claude Code (CLI)</strong></summary>
1075
+ <summary>⌨️ <strong>OpenCode (CLI)</strong></summary>
1218
1076
 
1219
1077
  ```bash
1220
1078
  # Add via CLI (recommended)
1221
- claude mcp add ruflo -- npx ruflo@v3alpha mcp start
1079
+ opencode mcp add opencode-orchestrator -- npx opencode-orchestrator@latest mcp start
1222
1080
 
1223
1081
  # Or add with environment variables
1224
- claude mcp add ruflo \
1082
+ opencode mcp add opencode-orchestrator \
1225
1083
  --env ANTHROPIC_API_KEY=sk-ant-... \
1226
- -- npx ruflo@v3alpha mcp start
1084
+ -- npx opencode-orchestrator@latest mcp start
1227
1085
 
1228
1086
  # Verify installation
1229
- claude mcp list
1087
+ opencode mcp list
1230
1088
  ```
1231
1089
 
1232
- *Sources: [Claude Code MCP Docs](https://code.claude.com/docs/en/mcp)*
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
- "ruflo": {
1111
+ "opencode-orchestrator": {
1254
1112
  "command": "npx",
1255
- "args": ["ruflo@v3alpha", "mcp", "start"],
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
- "ruflo": {
1138
+ "opencode-orchestrator": {
1281
1139
  "command": "npx",
1282
- "args": ["ruflo@v3alpha", "mcp", "start"],
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
- "ruflo": {
1165
+ "opencode-orchestrator": {
1308
1166
  "command": "npx",
1309
- "args": ["ruflo@v3alpha", "mcp", "start"],
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 ruflo to a server with HTTP transport:
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 ruflo@v3alpha mcp start --transport http --port 3000
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 ruflo MCP server
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: 'ruflo',
1227
+ name: 'opencode-orchestrator',
1370
1228
  command: 'npx',
1371
- args: ['ruflo@v3alpha', 'mcp', 'start']
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": "ruflo",
1250
+ "name": "opencode-orchestrator",
1393
1251
  "command": "npx",
1394
- "args": ["ruflo@v3alpha", "mcp", "start"]
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 ruflo hive-mind init # Initialize hive mind
1625
- npx ruflo hive-mind spawn "Build API" # Spawn with objective
1626
- npx ruflo hive-mind spawn "..." --queen-type strategic --consensus byzantine
1627
- npx ruflo hive-mind status # Check status
1628
- npx ruflo hive-mind metrics # Performance metrics
1629
- npx ruflo hive-mind memory # Collective memory stats
1630
- npx ruflo hive-mind sessions # List active sessions
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 ruflo init
1645
- npx ruflo@latest init
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 ruflo@latest hooks teammate-idle --auto-assign true
1555
+ npx opencode-orchestrator@latest hooks teammate-idle --auto-assign true
1698
1556
 
1699
1557
  # Handle task completion
1700
- npx ruflo@latest hooks task-completed --task-id <id> --train-patterns
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 Ruflo capabilities:
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 ruflo@latest plugins install -n @claude-flow/plugin-gastown-bridge` |
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 ruflo@latest plugins install -n @claude-flow/teammate-plugin` |
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 ruflo@latest plugins install -n @claude-flow/plugin-gastown-bridge
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 ruflo plugins list --installed
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 ruflo@v3alpha worker dispatch --trigger audit --context "./src"
2043
- npx ruflo@v3alpha worker status
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** | `ruflo embeddings init` or `createEmbeddingServiceAsync()` | Zero config |
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
- ruflo embeddings init
2135
+ opencode-orchestrator embeddings init
2278
2136
 
2279
2137
  # Use larger model for higher quality
2280
- ruflo embeddings init --model all-mpnet-base-v2
2138
+ opencode-orchestrator embeddings init --model all-mpnet-base-v2
2281
2139
 
2282
2140
  # Semantic search
2283
- ruflo embeddings search -q "authentication patterns"
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
- ruflo ruvector init --database mydb --user admin
2178
+ opencode-orchestrator ruvector init --database mydb --user admin
2321
2179
 
2322
2180
  # Check connection and schema status
2323
- ruflo ruvector status --verbose
2181
+ opencode-orchestrator ruvector status --verbose
2324
2182
 
2325
2183
  # Run pending migrations
2326
- ruflo ruvector migrate --up
2184
+ opencode-orchestrator ruvector migrate --up
2327
2185
 
2328
2186
  # Performance benchmark
2329
- ruflo ruvector benchmark --iterations 1000
2187
+ opencode-orchestrator ruvector benchmark --iterations 1000
2330
2188
 
2331
2189
  # Optimize indices and vacuum
2332
- ruflo ruvector optimize --analyze
2190
+ opencode-orchestrator ruvector optimize --analyze
2333
2191
 
2334
2192
  # Backup vector data
2335
- ruflo ruvector backup --output ./backup.sql
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 ruflo hive-mind init # Initialize
2368
- npx ruflo hive-mind spawn "Build API" --queen-type tactical # Spawn swarm
2369
- npx ruflo hive-mind spawn "Research AI" --consensus byzantine --claude
2370
- npx ruflo hive-mind status # Check status
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
- **Ruflo Skill:** `/hive-mind-advanced` — Full hive mind orchestration
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
- Ruflo V3 ● ruvnet │ ⎇ main │ Opus 4.6 | ●42% ctx | $0.15
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
- | `▊ Ruflo V3` | Project header | Always shown |
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 ruflo@latest init` — this generates `.claude/settings.json` with the correct statusline config and creates the helper script at `.claude/helpers/statusline.cjs`.
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 ruflo@latest init --update --settings
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 ruflo@v3alpha daemon start
2439
+ npx opencode-orchestrator@v3alpha daemon start
2582
2440
 
2583
2441
  # Check status with worker history
2584
- npx ruflo@v3alpha daemon status
2442
+ npx opencode-orchestrator@v3alpha daemon status
2585
2443
 
2586
2444
  # Manually trigger a worker
2587
- npx ruflo@v3alpha daemon trigger map
2445
+ npx opencode-orchestrator@v3alpha daemon trigger map
2588
2446
 
2589
2447
  # Enable/disable workers
2590
- npx ruflo@v3alpha daemon enable map audit optimize
2448
+ npx opencode-orchestrator@v3alpha daemon enable map audit optimize
2591
2449
 
2592
2450
  # Stop daemon
2593
- npx ruflo@v3alpha daemon stop
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 Ruflo operations.
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 ruflo@v3alpha init --wizard
2567
+ npx opencode-orchestrator@v3alpha init --wizard
2710
2568
 
2711
2569
  # Start daemon with background workers
2712
- npx ruflo@v3alpha daemon start
2570
+ npx opencode-orchestrator@v3alpha daemon start
2713
2571
 
2714
2572
  # Spawn an agent with specific type
2715
- npx ruflo@v3alpha agent spawn -t coder --name my-coder
2573
+ npx opencode-orchestrator@v3alpha agent spawn -t coder --name my-coder
2716
2574
 
2717
2575
  # Initialize swarm with V3 mode
2718
- npx ruflo@v3alpha swarm init --v3-mode
2576
+ npx opencode-orchestrator@v3alpha swarm init --v3-mode
2719
2577
 
2720
2578
  # Search memory (HNSW-indexed, 150x faster)
2721
- npx ruflo@v3alpha memory search -q "authentication patterns"
2579
+ npx opencode-orchestrator@v3alpha memory search -q "authentication patterns"
2722
2580
 
2723
2581
  # Run security scan
2724
- npx ruflo@v3alpha security scan --depth full
2582
+ npx opencode-orchestrator@v3alpha security scan --depth full
2725
2583
 
2726
2584
  # Performance benchmark
2727
- npx ruflo@v3alpha performance benchmark --suite all
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 ruflo@v3alpha doctor` to diagnose and fix common issues.
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 ruflo@v3alpha doctor
2614
+ npx opencode-orchestrator@v3alpha doctor
2757
2615
 
2758
2616
  # Run diagnostics with auto-fix
2759
- npx ruflo@v3alpha doctor --fix
2617
+ npx opencode-orchestrator@v3alpha doctor --fix
2760
2618
 
2761
2619
  # Check specific component
2762
- npx ruflo@v3alpha doctor --component memory
2620
+ npx opencode-orchestrator@v3alpha doctor --component memory
2763
2621
 
2764
2622
  # Verbose output
2765
- npx ruflo@v3alpha doctor --verbose
2623
+ npx opencode-orchestrator@v3alpha doctor --verbose
2766
2624
  ```
2767
2625
 
2768
2626
  **Output Example:**
2769
2627
 
2770
2628
  ```
2771
- 🩺 Ruflo Doctor v3.0.0-alpha
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 ruflo@v3alpha embeddings init
2673
+ npx opencode-orchestrator@v3alpha embeddings init
2816
2674
 
2817
2675
  # Generate embedding for text
2818
- npx ruflo@v3alpha embeddings embed "authentication patterns"
2676
+ npx opencode-orchestrator@v3alpha embeddings embed "authentication patterns"
2819
2677
 
2820
2678
  # Batch embed multiple texts
2821
- npx ruflo@v3alpha embeddings batch --file texts.txt
2679
+ npx opencode-orchestrator@v3alpha embeddings batch --file texts.txt
2822
2680
 
2823
2681
  # Search with semantic similarity
2824
- npx ruflo@v3alpha embeddings search "login flow" --top-k 5
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 ruflo@v3alpha --agent reviewer --task "Review PR #123"` |
2862
- | **Test Generation** | Auto-generate unit, integration, and e2e tests for existing code | `npx ruflo@v3alpha --agent tester --task "Write tests for auth module"` |
2863
- | **Refactoring** | Safely restructure code while maintaining behavior | `npx ruflo@v3alpha --agent coder --task "Refactor user service to use repository pattern"` |
2864
- | **Bug Fixing** | Diagnose and fix bugs with full context analysis | `npx ruflo@v3alpha --agent coder --task "Fix race condition in checkout flow"` |
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 ruflo@v3alpha --agent security-architect --task "Audit for OWASP Top 10"` |
2871
- | **Dependency Scan** | Identify vulnerable packages and suggest upgrades | `npx ruflo@v3alpha security scan --depth full` |
2872
- | **Compliance Check** | Ensure code meets security standards | `npx ruflo@v3alpha --agent security-architect --task "Check PCI-DSS compliance"` |
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 ruflo@v3alpha swarm init --topology hierarchical && npx ruflo@v3alpha task orchestrate "Build user dashboard"` |
2879
- | **Large Refactors** | Parallel refactoring across many files without conflicts | `npx ruflo@v3alpha swarm init --topology mesh --max-agents 8` |
2880
- | **Codebase Migration** | Migrate frameworks, languages, or patterns systematically | `npx ruflo@v3alpha task orchestrate "Migrate from Express to Fastify" --strategy adaptive` |
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 ruflo@v3alpha --agent perf-analyzer --task "Profile API endpoints"` |
2887
- | **Query Optimization** | Speed up slow database queries | `npx ruflo@v3alpha hooks route "Optimize database queries"` |
2888
- | **Memory Analysis** | Reduce memory usage and fix leaks | `npx ruflo@v3alpha --agent perf-analyzer --task "Analyze memory usage patterns"` |
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 ruflo@v3alpha --agent pr-manager --task "Review open PRs"` |
2895
- | **Issue Triage** | Categorize, prioritize, and assign issues automatically | `npx ruflo@v3alpha --agent issue-tracker --task "Triage new issues"` |
2896
- | **Release Management** | Coordinate releases with changelogs and versioning | `npx ruflo@v3alpha --agent release-manager --task "Prepare v2.0 release"` |
2897
- | **CI/CD Optimization** | Speed up pipelines and reduce flaky tests | `npx ruflo@v3alpha --agent cicd-engineer --task "Optimize GitHub Actions workflow"` |
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 ruflo@v3alpha --agent architect --task "Create ADR for authentication system"` |
2904
- | **Validate Implementation** | Ensure code matches specifications | `npx ruflo@v3alpha hooks progress --detailed` |
2905
- | **Track Compliance** | Monitor spec adherence across the team | `npx ruflo@v3alpha progress sync` |
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 ruflo@v3alpha hooks pretrain --depth deep` |
2912
- | **Optimize Routing** | Improve task-to-agent matching over time | `npx ruflo@v3alpha hooks route "<task>" --include-explanation` |
2913
- | **Transfer Learning** | Apply patterns learned from other projects | `npx ruflo@v3alpha hooks transfer <sourceProject>` |
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
- Ruflo eliminates Claude Code's context window ceiling with a real-time memory management system that archives, optimizes, and restores conversation context automatically.
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
- Ruflo intercepts the compaction lifecycle with three hooks that make context loss invisible:
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
- Ruflo 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.
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
- ruflo memory init --force
3156
- ruflo config set memory.backend hybrid
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 ruflo@v3alpha hooks pre-task --description "convert var to const in utils.ts"
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 ruflo@v3alpha hooks pre-edit ./src/auth.ts
3334
- npx ruflo@v3alpha hooks post-edit ./src/auth.ts --success true --train-patterns
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 ruflo@v3alpha hooks route "refactor authentication to use JWT" --include-explanation
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 ruflo@v3alpha hooks pretrain --depth deep --model-type moe
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 ruflo@v3alpha hooks session-start --session-id "feature-auth" --start-daemon
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 ruflo@v3alpha hooks session-end --export-metrics --persist-patterns
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 ruflo@v3alpha hooks intelligence trajectory-start --task "implement OAuth2"
3249
+ npx opencode-orchestrator@v3alpha hooks intelligence trajectory-start --task "implement OAuth2"
3392
3250
 
3393
3251
  # Record successful action
3394
- npx ruflo@v3alpha hooks intelligence trajectory-step --action "created token service" --quality 0.9
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 ruflo@v3alpha hooks intelligence trajectory-end --success true
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 ruflo@v3alpha hooks worker list
3283
+ npx opencode-orchestrator@v3alpha hooks worker list
3426
3284
 
3427
3285
  # Manually dispatch security audit
3428
- npx ruflo@v3alpha hooks worker dispatch --trigger audit --context "./src/auth"
3286
+ npx opencode-orchestrator@v3alpha hooks worker dispatch --trigger audit --context "./src/auth"
3429
3287
 
3430
3288
  # Check worker status
3431
- npx ruflo@v3alpha hooks worker status
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 ruflo@v3alpha hooks model-route --task "fix typo in README"
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 ruflo@v3alpha hooks model-route --task "design distributed consensus system"
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 ruflo@v3alpha hooks route "<task>" --include-explanation
3328
+ npx opencode-orchestrator@v3alpha hooks route "<task>" --include-explanation
3471
3329
 
3472
3330
  # Start/end session with learning
3473
- npx ruflo@v3alpha hooks session-start --start-daemon
3474
- npx ruflo@v3alpha hooks session-end --persist-patterns
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 ruflo@v3alpha hooks metrics
3478
- npx ruflo@v3alpha hooks intelligence stats
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 ruflo@v3alpha hooks pretrain --depth deep
3344
+ npx opencode-orchestrator@v3alpha hooks pretrain --depth deep
3487
3345
 
3488
3346
  # Dispatch background worker
3489
- npx ruflo@v3alpha hooks worker dispatch --trigger audit
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 ruflo@v3alpha memory export --format json --output ./patterns.json
3373
+ npx opencode-orchestrator@v3alpha memory export --format json --output ./patterns.json
3516
3374
 
3517
3375
  # Export specific namespace
3518
- npx ruflo@v3alpha memory export --namespace "security" --output ./security-patterns.json
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 ruflo@v3alpha memory export --include-embeddings --output ./full-export.json
3379
+ npx opencode-orchestrator@v3alpha memory export --include-embeddings --output ./full-export.json
3522
3380
 
3523
3381
  # Export agent configurations
3524
- npx ruflo@v3alpha config export --scope project --output ./agent-configs.json
3382
+ npx opencode-orchestrator@v3alpha config export --scope project --output ./agent-configs.json
3525
3383
 
3526
3384
  # Export session state
3527
- npx ruflo@v3alpha session export --session-id "my-session" --output ./session.json
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 ruflo@v3alpha memory import --input ./patterns.json
3392
+ npx opencode-orchestrator@v3alpha memory import --input ./patterns.json
3535
3393
 
3536
3394
  # Import and merge with existing (don't overwrite)
3537
- npx ruflo@v3alpha memory import --input ./patterns.json --merge
3395
+ npx opencode-orchestrator@v3alpha memory import --input ./patterns.json --merge
3538
3396
 
3539
3397
  # Import from another project
3540
- npx ruflo@v3alpha hooks transfer --source-path ../other-project
3398
+ npx opencode-orchestrator@v3alpha hooks transfer --source-path ../other-project
3541
3399
 
3542
3400
  # Import agent configurations
3543
- npx ruflo@v3alpha config import --input ./agent-configs.json --scope project
3401
+ npx opencode-orchestrator@v3alpha config import --input ./agent-configs.json --scope project
3544
3402
 
3545
3403
  # Restore session
3546
- npx ruflo@v3alpha session restore --session-id "my-session"
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 ruflo@v3alpha transfer-store search --query "authentication" --min-rating 4.0
3422
+ npx opencode-orchestrator@v3alpha transfer-store search --query "authentication" --min-rating 4.0
3565
3423
 
3566
3424
  # Download a pattern
3567
- npx ruflo@v3alpha transfer-store download --id "auth-jwt-patterns-v2" --verify
3425
+ npx opencode-orchestrator@v3alpha transfer-store download --id "auth-jwt-patterns-v2" --verify
3568
3426
 
3569
3427
  # Publish your patterns
3570
- npx ruflo@v3alpha transfer-store publish --input ./my-patterns.json --category "security"
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 ruflo@v3alpha plugins list
3446
+ npx opencode-orchestrator@v3alpha plugins list
3589
3447
 
3590
3448
  # Filter by type
3591
- npx ruflo@v3alpha plugins list --type integration
3449
+ npx opencode-orchestrator@v3alpha plugins list --type integration
3592
3450
 
3593
3451
  # Rate a plugin
3594
- npx ruflo@v3alpha plugins rate --name @claude-flow/embeddings --rating 5
3452
+ npx opencode-orchestrator@v3alpha plugins rate --name @claude-flow/embeddings --rating 5
3595
3453
 
3596
3454
  # Search for MCP tool plugins
3597
- npx ruflo@v3alpha transfer plugin-search --type "mcp-tool" --verified
3455
+ npx opencode-orchestrator@v3alpha transfer plugin-search --type "mcp-tool" --verified
3598
3456
 
3599
3457
  # Get plugin info
3600
- npx ruflo@v3alpha transfer plugin-info --name "semantic-code-search"
3458
+ npx opencode-orchestrator@v3alpha transfer plugin-info --name "semantic-code-search"
3601
3459
 
3602
3460
  # List official plugins
3603
- npx ruflo@v3alpha transfer plugin-official
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 ruflo@v3alpha transfer ipfs-resolve --name "/ipns/patterns.ruflo.io"
3494
+ npx opencode-orchestrator@v3alpha transfer ipfs-resolve --name "/ipns/patterns.opencode-orchestrator.io"
3637
3495
 
3638
3496
  # Detect PII before publishing
3639
- npx ruflo@v3alpha transfer detect-pii --content "$(cat ./patterns.json)"
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": "ruflo-learning-pattern"}
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 ruflo@v3alpha transfer import --cid QmNr1yYMKi7YBaL8JSztQyuB5ZUaTdRMLxJC1pBpGbjsTc
3562
+ npx opencode-orchestrator@v3alpha transfer import --cid QmNr1yYMKi7YBaL8JSztQyuB5ZUaTdRMLxJC1pBpGbjsTc
3705
3563
 
3706
3564
  # Import specific category
3707
- npx ruflo@v3alpha neural import --model security-review-patterns --source ipfs
3565
+ npx opencode-orchestrator@v3alpha neural import --model security-review-patterns --source ipfs
3708
3566
 
3709
3567
  # Use patterns in routing
3710
- npx ruflo@v3alpha hooks route --task "review authentication code" --use-patterns
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 ruflo@v3alpha transfer-store download --id "security-essentials" --apply
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 ruflo@v3alpha neural list
3611
+ npx opencode-orchestrator@v3alpha neural list
3754
3612
 
3755
3613
  # List models by category
3756
- npx ruflo@v3alpha neural list --category security
3614
+ npx opencode-orchestrator@v3alpha neural list --category security
3757
3615
 
3758
3616
  # Train with WASM acceleration
3759
- npx ruflo@v3alpha neural train -p coordination -e 100 --wasm --flash --contrastive
3617
+ npx opencode-orchestrator@v3alpha neural train -p coordination -e 100 --wasm --flash --contrastive
3760
3618
 
3761
3619
  # Train security patterns
3762
- npx ruflo@v3alpha neural train -p security --wasm --contrastive
3620
+ npx opencode-orchestrator@v3alpha neural train -p security --wasm --contrastive
3763
3621
 
3764
3622
  # Benchmark WASM performance
3765
- npx ruflo@v3alpha neural benchmark -d 256 -i 1000
3623
+ npx opencode-orchestrator@v3alpha neural benchmark -d 256 -i 1000
3766
3624
 
3767
3625
  # Import pre-trained models
3768
- npx ruflo@v3alpha neural import --cid QmNr1yYMKi7YBaL8JSztQyuB5ZUaTdRMLxJC1pBpGbjsTc
3626
+ npx opencode-orchestrator@v3alpha neural import --cid QmNr1yYMKi7YBaL8JSztQyuB5ZUaTdRMLxJC1pBpGbjsTc
3769
3627
 
3770
3628
  # Export trained patterns to IPFS
3771
- npx ruflo@v3alpha neural export --ipfs --sign
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 ruflo@v3alpha skill run github-code-review
4111
- npx ruflo@v3alpha skill list
4112
- npx ruflo@v3alpha skill info sparc-methodology
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 ruflo@v3alpha issues list` |
4170
- | `issues claim` | Claim an issue for yourself/agent | `npx ruflo@v3alpha issues claim #123 --as coder-1` |
4171
- | `issues release` | Release your claim | `npx ruflo@v3alpha issues release #123` |
4172
- | `issues handoff` | Hand off to another worker | `npx ruflo@v3alpha issues handoff #123 --to reviewer` |
4173
- | `issues status` | Update progress on claimed work | `npx ruflo@v3alpha issues status #123 --progress 75` |
4174
- | `issues stealable` | List abandoned/stuck issues | `npx ruflo@v3alpha issues stealable` |
4175
- | `issues steal` | Take over stealable issue | `npx ruflo@v3alpha issues steal #123` |
4176
- | `issues load` | View agent workloads | `npx ruflo@v3alpha issues load` |
4177
- | `issues rebalance` | Redistribute work evenly | `npx ruflo@v3alpha issues rebalance --dry-run` |
4178
- | `issues board` | Visual board view | `npx ruflo@v3alpha issues board` |
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 ruflo@v3alpha issues board
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 ruflo@v3alpha issues handoff #123 \
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 ruflo@v3alpha issues accept #123 --as security-architect
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 ruflo@v3alpha issues load
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 ruflo@v3alpha issues rebalance
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 ruflo@v3alpha route task "implement OAuth2"` |
4293
- | `route explain` | Understand routing decision | `npx ruflo@v3alpha route explain "task"` |
4294
- | `route coverage` | Route based on test coverage | `npx ruflo@v3alpha route coverage` |
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 ruflo@v3alpha route task "refactor authentication to use JWT"
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 ruflo@v3alpha route coverage
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 ruflo@v3alpha hooks route "implement caching layer" --include-explanation
4196
+ npx opencode-orchestrator@v3alpha hooks route "implement caching layer" --include-explanation
4339
4197
 
4340
4198
  # Record outcome for learning
4341
- npx ruflo@v3alpha hooks post-task --task-id "task-123" --success true --agent coder
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 Ruflo packages directly in your applications.
4219
+ Use OpenCode Orchestrator packages directly in your applications.
4362
4220
 
4363
4221
  <details>
4364
- <summary>💻 <strong>Programmatic SDK</strong> — Use Ruflo in Your Code</summary>
4222
+ <summary>💻 <strong>Programmatic SDK</strong> — Use OpenCode Orchestrator in Your Code</summary>
4365
4223
 
4366
- Use Ruflo packages directly in your TypeScript/JavaScript applications.
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 ruflo@v3alpha
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 ruflo@latest memory init --force
4270
+ npx opencode-orchestrator@latest memory init --force
4413
4271
 
4414
4272
  # Store patterns
4415
- npx ruflo@latest memory store --key "pattern-auth" --value "JWT authentication with refresh tokens"
4416
- npx ruflo@latest memory store --key "pattern-cache" --value "Redis caching for API responses"
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 ruflo@latest memory search --query "authentication" --build-hnsw
4277
+ npx opencode-orchestrator@latest memory search --query "authentication" --build-hnsw
4420
4278
 
4421
4279
  # Semantic search (uses HNSW if built)
4422
- npx ruflo@latest memory search --query "how to cache data" --limit 5
4280
+ npx opencode-orchestrator@latest memory search --query "how to cache data" --limit 5
4423
4281
 
4424
4282
  # List and manage entries
4425
- npx ruflo@latest memory list --namespace patterns
4426
- npx ruflo@latest memory stats
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
- ruflo embeddings embed "Your text here"
4518
+ opencode-orchestrator embeddings embed "Your text here"
4661
4519
 
4662
4520
  # Batch embed from file
4663
- ruflo embeddings batch documents.txt -o embeddings.json
4521
+ opencode-orchestrator embeddings batch documents.txt -o embeddings.json
4664
4522
 
4665
4523
  # Similarity search
4666
- ruflo embeddings search "query" --index ./vectors
4524
+ opencode-orchestrator embeddings search "query" --index ./vectors
4667
4525
 
4668
4526
  # Document chunking
4669
- ruflo embeddings chunk document.txt --strategy sentence --max-size 512
4527
+ opencode-orchestrator embeddings chunk document.txt --strategy sentence --max-size 512
4670
4528
 
4671
4529
  # Normalize embeddings
4672
- ruflo embeddings normalize embeddings.json --type l2 -o normalized.json
4530
+ opencode-orchestrator embeddings normalize embeddings.json --type l2 -o normalized.json
4673
4531
 
4674
4532
  # Convert to hyperbolic
4675
- ruflo embeddings hyperbolic embeddings.json -o poincare.json
4533
+ opencode-orchestrator embeddings hyperbolic embeddings.json -o poincare.json
4676
4534
 
4677
4535
  # Neural operations
4678
- ruflo embeddings neural drift --baseline "context" --input "check"
4679
- ruflo embeddings neural store --id mem-1 --content "data"
4680
- ruflo embeddings neural recall "query" --top-k 5
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
- ruflo embeddings models list
4684
- ruflo embeddings models download all-MiniLM-L6-v2
4541
+ opencode-orchestrator embeddings models list
4542
+ opencode-orchestrator embeddings models download all-MiniLM-L6-v2
4685
4543
 
4686
4544
  # Cache management
4687
- ruflo embeddings cache stats
4688
- ruflo embeddings cache clear --older-than 7d
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 Ruflo's intelligence layer.
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
  [![npm downloads](https://img.shields.io/npm/dm/agentic-flow?color=green)](https://www.npmjs.com/package/agentic-flow)
4762
4620
  [![GitHub](https://img.shields.io/badge/GitHub-ruvnet%2Fagentic--flow-blue?logo=github)](https://github.com/ruvnet/agentic-flow)
4763
4621
 
4764
- Ruflo 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.
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 Ruflo
4903
+ ### Integration with OpenCode Orchestrator
5046
4904
 
5047
- Ruflo automatically leverages agentic-flow for:
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
- // Ruflo automatically uses agentic-flow optimizations
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
- ### Ruflo Skill
5092
+ ### OpenCode Orchestrator Skill
5235
5093
 
5236
- Ruflo includes a dedicated `/agentic-jujutsu` skill for AI-powered version control:
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
  [![GitHub](https://img.shields.io/badge/GitHub-ruvnet%2Fruvector-blue?logo=github)](https://github.com/ruvnet/ruvector)
5317
5175
  [![Docker](https://img.shields.io/badge/Docker-ruvector--postgres-blue?logo=docker)](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 Ruflo's intelligence layer with native speed.
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 ruflo ruvector setup --output ./my-ruvector
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=ruflo-test \
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 ruflo ruvector import --input memory-export.json
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 Ruflo
5429
+ ### Integration with OpenCode Orchestrator
5572
5430
 
5573
- Ruflo automatically uses RuVector when available:
5431
+ OpenCode Orchestrator automatically uses RuVector when available:
5574
5432
 
5575
5433
  ```typescript
5576
- // Ruflo detects and uses native ruvector
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 ruflo ruvector setup # Output to ./ruvector-postgres
5595
- npx ruflo ruvector setup --output ./mydir # Custom directory
5596
- npx ruflo ruvector setup --print # Preview files
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 ruflo ruvector import --input data.json # Direct import
5600
- npx ruflo ruvector import --input data.json --output sql # Dry-run (generate SQL)
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 ruflo ruvector status --verbose # Check connection
5604
- npx ruflo ruvector benchmark --vectors 10000 # Performance test
5605
- npx ruflo ruvector optimize --analyze # Optimization suggestions
5606
- npx ruflo ruvector backup --output backup.sql # Backup data
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 Ruflo beyond your local machine.
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 Ruflo | + Flow Nexus |
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 ruflo@v3alpha nexus swarm deploy \
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 ruflo@v3alpha nexus sandbox create --language python
5556
+ npx opencode-orchestrator@v3alpha nexus sandbox create --language python
5699
5557
 
5700
5558
  # Execute code safely
5701
- npx ruflo@v3alpha nexus sandbox exec --code "print('Hello')"
5559
+ npx opencode-orchestrator@v3alpha nexus sandbox exec --code "print('Hello')"
5702
5560
 
5703
5561
  # Cleanup
5704
- npx ruflo@v3alpha nexus sandbox destroy
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 ruflo@v3alpha nexus configure --api-key <key>
5588
+ npx opencode-orchestrator@v3alpha nexus configure --api-key <key>
5731
5589
 
5732
5590
  # 4. Deploy
5733
- npx ruflo@v3alpha nexus swarm deploy
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 ruflo@v3alpha stream-chain create \
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 ruflo@v3alpha stream-chain run feature-pipeline \
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 ruflo@v3alpha stream-chain status feature-pipeline
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 ruflo@v3alpha pair start --mode navigator
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 ruflo@v3alpha pair switch
5751
+ npx opencode-orchestrator@v3alpha pair switch
5894
5752
 
5895
5753
  # Get AI explanation
5896
- npx ruflo@v3alpha pair explain
5754
+ npx opencode-orchestrator@v3alpha pair explain
5897
5755
 
5898
5756
  # Run tests
5899
- npx ruflo@v3alpha pair test
5757
+ npx opencode-orchestrator@v3alpha pair test
5900
5758
 
5901
5759
  # End session with summary
5902
- npx ruflo@v3alpha pair end
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 ruflo@v3alpha security defend -i "ignore previous instructions"
5817
+ npx opencode-orchestrator@v3alpha security defend -i "ignore previous instructions"
5960
5818
 
5961
5819
  # Scan a file
5962
- npx ruflo@v3alpha security defend -f ./user-prompts.txt
5820
+ npx opencode-orchestrator@v3alpha security defend -f ./user-prompts.txt
5963
5821
 
5964
5822
  # Quick scan (faster)
5965
- npx ruflo@v3alpha security defend -i "some text" --quick
5823
+ npx opencode-orchestrator@v3alpha security defend -i "some text" --quick
5966
5824
 
5967
5825
  # JSON output
5968
- npx ruflo@v3alpha security defend -i "test" -o json
5826
+ npx opencode-orchestrator@v3alpha security defend -i "test" -o json
5969
5827
 
5970
5828
  # View statistics
5971
- npx ruflo@v3alpha security defend --stats
5829
+ npx opencode-orchestrator@v3alpha security defend --stats
5972
5830
 
5973
5831
  # Full security audit
5974
- npx ruflo@v3alpha security scan --depth full
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
  [![npm version](https://img.shields.io/npm/v/@claude-flow/browser?color=blue&label=npm)](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 ruflo for intelligent web automation, trajectory learning, and multi-agent browser coordination.
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 Ruflo packages.
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 ruflo@v3alpha performance report
6423
+ npx opencode-orchestrator@v3alpha performance report
6566
6424
 
6567
6425
  # Benchmark specific suite
6568
- npx ruflo@v3alpha performance benchmark --suite memory
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 | `ruflo-patterns` |
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
- Ruflo looks for configuration in this order:
6878
+ OpenCode Orchestrator looks for configuration in this order:
7021
6879
  1. `./claude-flow.config.json` (project root)
7022
- 2. `~/.config/ruflo/config.json` (user 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/ruflo.log",
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/ruflo/data",
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/ruflo/production.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 ruflo@v3alpha config list
7103
+ npx opencode-orchestrator@v3alpha config list
7246
7104
 
7247
7105
  # Get specific value
7248
- npx ruflo@v3alpha config get --key memory.type
7106
+ npx opencode-orchestrator@v3alpha config get --key memory.type
7249
7107
 
7250
7108
  # Set configuration value
7251
- npx ruflo@v3alpha config set --key swarm.maxAgents --value 10
7109
+ npx opencode-orchestrator@v3alpha config set --key swarm.maxAgents --value 10
7252
7110
 
7253
7111
  # Export configuration
7254
- npx ruflo@v3alpha config export > my-config.json
7112
+ npx opencode-orchestrator@v3alpha config export > my-config.json
7255
7113
 
7256
7114
  # Import configuration
7257
- npx ruflo@v3alpha config import --file my-config.json
7115
+ npx opencode-orchestrator@v3alpha config import --file my-config.json
7258
7116
 
7259
7117
  # Reset to defaults
7260
- npx ruflo@v3alpha config reset --key swarm
7118
+ npx opencode-orchestrator@v3alpha config reset --key swarm
7261
7119
 
7262
7120
  # Initialize with wizard
7263
- npx ruflo@v3alpha init --wizard
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 ruflo@v3alpha mcp start
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 ruflo@v3alpha hooks metrics
7159
+ npx opencode-orchestrator@v3alpha hooks metrics
7302
7160
  # Re-run pretraining if empty
7303
- npx ruflo@v3alpha hooks pretrain
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/ruflo/data"
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/ruflo
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** | `ruflo` | `@claude-flow/*` (scoped) | Update imports |
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** | `.ruflo/config.json` | `claude-flow.config.json` | Update path |
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 ./.ruflo ./.ruflo-backup-v2
7226
+ cp -r ./.opencode-orchestrator ./.opencode-orchestrator-backup-v2
7369
7227
 
7370
7228
  # STEP 2: Check migration status
7371
- npx ruflo@v3alpha migrate status
7229
+ npx opencode-orchestrator@v3alpha migrate status
7372
7230
 
7373
7231
  # STEP 3: Run migration with dry-run first
7374
- npx ruflo@v3alpha migrate run --dry-run
7232
+ npx opencode-orchestrator@v3alpha migrate run --dry-run
7375
7233
 
7376
7234
  # STEP 4: Execute migration
7377
- npx ruflo@v3alpha migrate run --from v2
7235
+ npx opencode-orchestrator@v3alpha migrate run --from v2
7378
7236
 
7379
7237
  # STEP 5: Verify migration
7380
- npx ruflo@v3alpha migrate verify
7238
+ npx opencode-orchestrator@v3alpha migrate verify
7381
7239
 
7382
7240
  # STEP 6: Initialize V3 learning
7383
- npx ruflo@v3alpha hooks pretrain
7384
- npx ruflo@v3alpha doctor --fix
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
- | `ruflo start` | `ruflo mcp start` | MCP is explicit |
7392
- | `ruflo init` | `ruflo init --wizard` | Interactive mode |
7393
- | `ruflo spawn <type>` | `ruflo agent spawn -t <type>` | Nested under `agent` |
7394
- | `ruflo swarm create` | `ruflo swarm init --topology mesh` | Explicit topology |
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 (`.ruflo/config.json`)**:
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 'ruflo';
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 ruflo@v3alpha migrate rollback --list
7309
+ npx opencode-orchestrator@v3alpha migrate rollback --list
7452
7310
 
7453
7311
  # Rollback to V2
7454
- npx ruflo@v3alpha migrate rollback --to v2
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 ruflo@v3alpha agent list`
7464
- - [ ] Check memory search works: `npx ruflo@v3alpha memory search -q "test"`
7465
- - [ ] Confirm MCP server starts: `npx ruflo@v3alpha mcp start`
7466
- - [ ] Run doctor diagnostics: `npx ruflo@v3alpha doctor`
7467
- - [ ] Test a simple swarm: `npx ruflo@v3alpha swarm init --topology mesh`
7468
- - [ ] Bootstrap learning: `npx ruflo@v3alpha hooks pretrain`
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/ruvnet/claude-flow](https://github.com/ruvnet/claude-flow) |
7523
- | 🐛 Issues & Bugs | [github.com/ruvnet/claude-flow/issues](https://github.com/ruvnet/claude-flow/issues) |
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 - [RuvNet](https://github.com/ruvnet)
7386
+ MIT - [pedrocosta95](https://github.com/pedrocosta95)
7530
7387
 
7531
7388
 
7532
7389
  [![RuVector](https://img.shields.io/npm/v/ruvector?style=for-the-badge&logo=rust&color=orange&label=RuVector)](https://www.npmjs.com/package/ruvector)