Turbo Flow v4.1.0 — Ruv Stack Edition

🎬 Demo

A real, unedited run of the full onboarding chain — codespace_setup.sh → setup.sh → post-setup.sh → tmux-workspace.sh (11 install steps, 6-plugin verify: Claude Code, Ruflo v3.5, Dolt + Beads, GitNexus, OpenSpec) — sped up, then a real reattach to the live tmux session it creates: a tour through all four workspace windows (Claude-2, Claude-Monitor, a live htop), then the real claude CLI launched through to its actual login screen. Not a mockup, not a scripted animation — no API key on the recording box, so that's the genuine first-run auth screen. Recorded with VHS from demo/demo-a-setup.tape + demo/demo-b-tmux-claude.tape (demo/build-demo.sh reproduces it end to end).

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 packaging, setup automation, plugin curation, and workflow integration that brings together orchestration, memory, codebase intelligence, and agent isolation into a single streamlined install. The orchestration core itself — the 215+ MCP tools and 60+ agents referenced throughout this README — is Ruflo v3.5, built by ruvnet ("rUv"); Turbo Flow integrates and configures it rather than building it from scratch. See the Ruv Stack Edition section below for the full breakdown of what's original to this repo versus wired in from rUv's ecosystem.

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/marcuspat/turbo-flow --ide vscode

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

# Manual
git clone https://github.com/marcuspat/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.