Turbo Flow

About Adventure Wave Labs

Adventure Wave Labs is the team behind Turbo Flow a complete agentic development environment built for the Claude ecosystem. We design, build, and maintain the tooling that brings together orchestration, memory, codebase intelligence, and agent isolation into a single streamlined workflow.

Ruv Stack Edition (v4.1.0)

Turbo Flow's orchestration core has always run on ruvnet's ("rUv") ecosystem — Ruflo v3.5 and a bundled RuVector WASM build. This edition wires in three more real ruvnet projects and gives the rest of the branded "ruv stack" an honest accounting: what's dev-relevant gets integrated, what isn't gets documented and skipped.

Full breakdown, package names, and rationale: docs/RUV-STACK.md.

./scripts/setup-ruv-stack.sh            # dry run — prints the plan
./scripts/setup-ruv-stack.sh --apply    # installs RuVector+, ruVLLM, MetaHarness

Pure add-on: it never modifies devpods/setup.sh, runs independently of the main install, and writes its rv-* aliases to a separate file from the core rf-* set.

What's New in v4.0.0

Major Changes

• claude-flow → Ruflo v3.5 — Single npx ruflo@latest init replaces 4 separate installs
• Beads — Cross-session project memory via git-native JSONL
• GitNexus — Codebase knowledge graph with MCP server and blast-radius detection
• Native Git Worktrees — Per-agent isolation with auto PG Vector schema namespacing
• Native Agent Teams — Anthropic's experimental multi-agent spawning
• 6 focused plugins — 9 redundant/domain-specific plugins removed
• OpenSpec — Spec-driven development kept
• UI UX Pro Max — Design skill kept
• Statusline Pro v4.0 — Updated with TF 4.0 branding

Removed (redundant with Ruflo v3.5 or out of scope)

• claude-flow@alpha, @ruvector/cli, @ruvector/sona, @claude-flow/browser → bundled in Ruflo
• 9 plugins: healthcare-clinical, financial-risk, legal-contracts, cognitive-kernel, hyperbolic-reasoning, quantum-optimizer, neural-coordination, prime-radiant, ruvector-upstream
• Claudish, Agentic Jujutsu, Spec-Kit, agtrace, PAL MCP → bundled or redundant
• HeroUI + Tailwind + TypeScript scaffold → out of scope
• Ars Contexta, OpenClaw Secure Stack → out of scope

Architecture

+------------------------------------------------------------------+
|              TURBO FLOW v4.1.0 — Adventure Wave Labs              |
+------------------------------------------------------------------+
|  INTERFACE                                                        |
|  +---------------+  +---------------+  +---------------+          |
|  | Claude Code   |  |  Open WebUI   |  |  Statusline   |          |
|  |     CLI       |  |  (4 instances)|  |   Pro v4.0    |          |
|  +---------------+  +---------------+  +---------------+          |
+------------------------------------------------------------------+
|  ORCHESTRATION: Ruflo v3.5                                        |
|  60+ Agents | 215+ MCP Tools | Auto-activated Skills              |
|  AgentDB v3 | RuVector WASM | SONA | 3-Tier Model Routing        |
|  59 MCP Browser Tools | Observability | Gating                    |
+------------------------------------------------------------------+
|  RUV STACK (optional add-on — scripts/setup-ruv-stack.sh)         |
|  RuVector crate (deepened) | ruVLLM local tier | MetaHarness      |
|  Skygraph (opt-in, off by default)                                |
+------------------------------------------------------------------+
|  PLUGINS (6)                                                      |
|  +--------------------------------------------------------------+ |
|  | Agentic QE | Code Intel | Test Intel | Perf | Teammate | Gas | |
|  +--------------------------------------------------------------+ |
+------------------------------------------------------------------+
|  CODEBASE INTELLIGENCE: GitNexus                                  |
|  Knowledge Graph | Blast Radius Detection | MCP Server            |
+------------------------------------------------------------------+
|  MEMORY (Three-Tier)                                              |
|  +---------------+  +---------------+  +---------------+          |
|  |    Beads      |  | Native Tasks  |  |   AgentDB     |          |
|  |  project/git  |  |   session     |  |  + RuVector   |          |
|  |    JSONL      |  |  ~/.claude/   |  |  WASM accel   |          |
|  +---------------+  +---------------+  +---------------+          |
+------------------------------------------------------------------+
|  ISOLATION                                                        |
|  Git Worktrees per Agent | PG Vector Schema per Worktree          |
|  Auto GitNexus Indexing | Agent Teams (experimental)              |
+------------------------------------------------------------------+
|  SKILLS                                                           |
|  UI UX Pro Max | OpenSpec | 36+ Ruflo Auto-activated Skills       |
+------------------------------------------------------------------+
|  INFRASTRUCTURE                                                   |
|  DevPod | Codespaces | Rackspace Spot                            |
+------------------------------------------------------------------+

Quick Start

DevPod Installation

brew install loft-sh/devpod/devpod

choco install devpod

curl -L -o devpod "https://github.com/loft-sh/devpod/releases/latest/download/devpod-linux-amd64"
sudo install devpod /usr/local/bin

Launch

# DevPod (recommended)
devpod up https://github.com/adventurewave-labs/turbo-flow --ide vscode

# Codespaces
# Push to GitHub → Open in Codespace → runs automatically

# Manual
git clone https://github.com/adventurewave-labs/turbo-flow -b main
cd turbo-flow
chmod +x devpods/setup.sh
./devpods/setup.sh
source ~/.bashrc
turbo-status

# Optional: Ruv Stack Edition (RuVector+, ruVLLM, MetaHarness)
./scripts/setup-ruv-stack.sh --apply

What Gets Installed

The devpods/setup.sh script installs the complete stack in 10 automated steps:

Step 1: System Prerequisites

Step 2: Claude Code + Ruflo v3.5

Ruflo v3.5 bundles: AgentDB v3, RuVector WASM, SONA, 215 MCP tools, 60+ agents, skills system, 3-tier model routing, 59 browser automation MCP tools, observability, gating

Step 3: Ruflo Plugins (6) + OpenSpec

Step 4: UI UX Pro Max Skill

Step 5: GitNexus (Codebase Knowledge Graph)

Step 6: Beads (Cross-Session Memory)

Step 7: Workspace + Agent Teams

Step 8: Statusline Pro v4.0

3-line statusline with 15 components:

LINE 1: [Project] name | [Model] Sonnet | [Git] branch | [TF] 4.0 | [SID] abc123
LINE 2: [Tokens] 50k/200k | [Ctx] #######--- 65% | [Cache] 42% | [Cost] $1.23 | [Time] 5m
LINE 3: [+150] [-50] | [READY]

Step 9: CLAUDE.md Generation

Generates workspace context file with:

• 3-tier memory protocol (Beads → Native Tasks → AgentDB)
• Isolation rules (one worktree per agent)
• Agent Teams rules (max 3 teammates, recursion depth 2)
• Model routing tiers (Opus/Sonnet/Haiku)
• Plugin reference
• Cost guardrails ($15/hr)

Step 10: Aliases + Environment + MCP Registration

50+ aliases across families: rf-*, ruv-*, mem-*, bd-*, wt-*, gnx-*, aqe-*, os-*, hooks-*, neural-*, turbo-status, turbo-help

Optional: Ruv Stack Edition (scripts/setup-ruv-stack.sh)

Run after the 10 steps above, independently, any time:

Adds a fourth alias family, rv-*, in its own file — never touches ~/.turboflow_aliases. See docs/RUV-STACK.md.

Plugins (6)

Removed Plugins (9)

Key Commands

turbo-status         # Check all components
turbo-help           # Complete command reference
rf-doctor            # Ruflo health check
rf-plugins           # List installed plugins

rf-wizard            # Interactive setup
rf-swarm             # Hierarchical swarm (8 agents max)
rf-mesh              # Mesh swarm
rf-ring              # Ring swarm
rf-star              # Star swarm
rf-spawn coder       # Spawn a coder agent
rf-daemon            # Start background workers
rf-status            # Ruflo status

bd-ready             # Check project state (session start)
bd-add               # Record issue/decision/blocker
bd-list              # List beads
ruv-remember K V     # Store in AgentDB
ruv-recall Q         # Query AgentDB
mem-search Q         # Search ruflo memory
mem-stats            # Memory statistics

wt-add agent-1       # Create worktree for agent
wt-remove agent-1    # Clean up worktree
wt-list              # Show all worktrees
wt-clean             # Prune stale worktrees

aqe-generate         # Generate tests (Agentic QE plugin)
aqe-gate             # Quality gate
os-init              # Initialize OpenSpec in project
os                   # Run OpenSpec

hooks-train          # Deep pretrain on codebase
hooks-route          # Route task to optimal agent
neural-train         # Train neural patterns
neural-patterns      # View learned patterns
gnx-analyze          # Index repo into knowledge graph
gnx-serve            # Start local server for web UI
gnx-wiki             # Generate repo wiki from graph

rv-vector-init         # npm install ruvector — see AGENTDB-VS-RUVECTOR.md for when to use it
rv-llm-serve           # Start local ruVLLM inference server
rv-llm-route "task"    # Route a task to the local, $0 ruVLLM tier
rv-harness-gen         # npx metaharness — scaffold a branded harness for this repo
rv-sky-demo            # Optional Skygraph demo (only if installed with --with-skygraph)

Migrating from v3.x

1. Your old cf-* aliases are gone — use rf-* instead
2. Slash commands (/sparc, etc.) are gone — Ruflo auto-activates skills
3. Run bd init in your project repos to enable Beads memory
4. Run npx gitnexus analyze in your repos to build the knowledge graph
5. The v3/ directory preserves everything — nothing was deleted

Repository Structure

turbo-flow/
├── V3/                          ← archived v3.0-v3.4.1 (Claude Flow era)
├── .claude/                     ← skills, agents, settings
├── devpods/
│   ├── setup.sh                 ← main setup script
│   ├── post-setup.sh            ← post-setup verification
│   └── context/                 ← devpod context files
├── scripts/
│   ├── generate-claude-md.sh
│   └── setup-ruv-stack.sh       ← optional Ruv Stack Edition add-on
├── docs/
│   └── RUV-STACK.md             ← ruv stack breakdown: what's real, what's wired in
├── CLAUDE.md                    ← workspace context (active)
└── README.md

Post-Setup

# 1. Reload shell
source ~/.bashrc

# 2. Verify installation
turbo-status

# 3. Get help
turbo-help

# 4. Run post-setup verification (13 checks)
# ./devpods/post-setup.sh

# 5. Optional: install the Ruv Stack Edition
# ./scripts/setup-ruv-stack.sh --apply

Version History

Resources

License

MIT — Copyright (c) 2025-2026 Adventure Wave Labs

Ecosystem

Built with and powers these tools — star the ones you use:

Stay Connected

If Turbo Flow ships value for you, follow @marcuspat on GitHub — agentic tooling, Rust crates, and open-source infra drop regularly.

Follow @marcuspat