Turbo Flow v4.0

Complete Agentic Development Environment — Ruflo v3.5 + Beads + Worktrees + Agent Teams

Built & Presented by Adventure Wave Labs

Quick Start • Installation • Plugins • Commands • Migration • Resources

🎬 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.

What's New in v4.0.0

Metric	v3.4.1	v4.0.0	Change
Installation Steps	15	10	-5 (consolidated)
Core Packages	4 separate	1 (Ruflo)	-75%
MCP Tools	175+	215+	+23%
Agents	60+	60+	—
Plugins	15	6	-9 (redundant removed)
Cross-session Memory	None	Beads	New
Agent Isolation	None	Git Worktrees	New
Codebase Graph	None	GitNexus	New
UI/UX Skill	Yes	Yes	Kept
Statusline	Yes	Yes	Updated to 4.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.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                    |
+------------------------------------------------------------------+
|  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

macOS

brew install loft-sh/devpod/devpod

Windows

choco install devpod

Linux

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

What Gets Installed

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

Step 1: System Prerequisites

Package	Purpose
`build-essential`	C/C++ compiler (gcc, g++, make)
`python3`	Python runtime
`git`	Version control
`curl`	HTTP client
`jq`	JSON processor (required for statusline)
`Node.js 20+`	JavaScript runtime (required by Ruflo v3.5)

Step 2: Claude Code + Ruflo v3.5

Component	Purpose
`Claude Code`	Anthropic's agentic coding CLI
`Ruflo v3.5`	Orchestration engine — replaces claude-flow@alpha
Ruflo MCP	Registered as MCP server in Claude Code
Ruflo Doctor	Auto-diagnostic and fix pass

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

Plugin	Purpose
Agentic QE	58 QE agents — TDD, coverage, security scanning, chaos engineering
Code Intelligence	Code analysis, pattern detection, refactoring suggestions
Test Intelligence	Test generation, gap analysis, flaky test detection
Perf Optimizer	Performance profiling, bottleneck detection
Teammate Plugin	Bridges Native Agent Teams with Ruflo swarms (21 MCP tools)
Gastown Bridge	WASM-accelerated orchestration, Beads sync (20 MCP tools)
OpenSpec	Spec-driven development (independent npm package)

Step 4: UI UX Pro Max Skill

Component	Purpose
`uipro-cli`	Design system skill — component patterns, accessibility, responsive layouts, design tokens

Step 5: GitNexus (Codebase Knowledge Graph)

Component	Purpose
`GitNexus`	Indexes dependencies, call chains, execution flows
GitNexus MCP	Registered as MCP server — blast-radius detection

Step 6: Beads (Cross-Session Memory)

Component	Purpose
`@beads/bd`	Git-native JSONL project memory — issues, decisions, blockers

Step 7: Workspace + Agent Teams

Component	Purpose
Directories	`src/` `tests/` `docs/` `scripts/` `config/` `plans/`
Agent Teams	`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` enabled

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

Plugins (6)

Plugin	MCP Tools	Purpose
Agentic QE	16	58 QE agents, TDD, coverage, security, chaos engineering
Code Intelligence	—	Code analysis, patterns, refactoring
Test Intelligence	—	Test generation, gaps, flaky tests
Perf Optimizer	—	Profiling, bottlenecks, optimization
Teammate Plugin	21	Agent Teams ↔ Ruflo swarms bridge, semantic routing
Gastown Bridge	20	WASM orchestration, Beads sync, convoys

Removed Plugins (9)

Plugin	Reason
healthcare-clinical	Domain-specific (HIPAA/FHIR) — not needed
financial-risk	Domain-specific (PCI-DSS/SOX) — not needed
legal-contracts	Domain-specific — not needed
cognitive-kernel	Redundant with Ruflo's neural system
hyperbolic-reasoning	Redundant with RuVector WASM hyperbolic embeddings
quantum-optimizer	Redundant with Ruflo's EWC++ and RVFOptimizer
neural-coordination	Redundant with Ruflo's swarm coordination
prime-radiant	Niche — mathematical interpretability
ruvector-upstream	Redundant — RuVector bundled in Ruflo v3.5

Key Commands

Status & Help

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

Orchestration (Ruflo)

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

Memory

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

Isolation

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

Quality & Testing

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

Intelligence

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

Migrating from v3.x

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

v3.4.1	v4.0.0
`cf-init`	`rf-init`
`cf-swarm`	`rf-swarm`
`cf-doctor`	`rf-doctor`
`cf-mcp`	Automatic via `rf-wizard`
`mem-search`	`mem-search` (unchanged)
`cfb-open`	Via Ruflo's bundled browser MCP tools
No cross-session memory	`bd-ready`, `bd-add`
No isolation	`wt-add`, `wt-remove`
No codebase graph	`gnx-analyze`

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

Version History

Version	Date	Changes
v4.0.0	Mar 2026	Ruflo Migration: Ruflo v3.5, Beads, GitNexus, Worktrees, Agent Teams, 6 plugins, UI UX Pro Max, OpenSpec
v3.4.1	Feb 2025	Fixes: skill install removed, plugins command, npm fallback
v3.4.0	Feb 2025	Complete + Plugins: 36 skills, 15 plugins
v3.3.0	Feb 2025	Complete installation: 41 skills, memory, MCP
v3.0.0	Feb 2025	Initial release with Claude Flow V3

Resources

Resource	Link
Adventure Wave Labs	GitHub: adventurewave-labs
Turbo Flow	GitHub: marcuspat/turbo-flow
Ruflo	GitHub: ruvnet/ruflo
RuVector	GitHub: ruvnet/RuVector
ruVLLM	crates.io: ruvllm
MetaHarness	GitHub: ruvnet/agent-harness-generator
Skygraph (optional)	GitHub: ruvnet/skygraph
OpenSpec	npm: @fission-ai/openspec
Agentic QE	npm: agentic-qe

License

Built & Presented by Adventure Wave Labs

Turbo Flow v4.0 — Ruflo v3.5. 215+ MCP tools. 6 plugins. Beads. GitNexus. Worktrees. One command.

https://github.com/marcuspat/turbo-flow/blob/main/AWLabs.png

Ecosystem

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

Repo	What it does
codescope	Single-binary code-intelligence engine for AI agents — no cloud, no DB, no Python
secret-scan	Rust secret scanner — obfuscation detection, up to ~1,200 files/sec measured
Sentinel	Deny-by-default agentic sysadmin: Investigate → Plan → Approve → Act in Rust
netrain	Matrix-style network monitor in Rust

Stay Connected

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

Name		Name	Last commit message	Last commit date
.devcontainer		.devcontainer
.github		.github
V2		V2
devpods		devpods
.gitignore		.gitignore
AWLabs.png		AWLabs.png
Addendum - Git Operations, Slash Commands & GitHub Integration.md		Addendum - Git Operations, Slash Commands & GitHub Integration.md
CITATION.cff		CITATION.cff
CLAUDE-WEB.md		CLAUDE-WEB.md
CLAUDE.md		CLAUDE.md
CMLabs.png		CMLabs.png
CONTRIBUTING.md		CONTRIBUTING.md
GUIAS_CONFIGURACION_TURBO_FLOW.md		GUIAS_CONFIGURACION_TURBO_FLOW.md
GUIA_COMPLETA_DEVPOD_RACKSPACE.md		GUIA_COMPLETA_DEVPOD_RACKSPACE.md
GUIA_SUPERVIVENCIA_RACKSPACE_KUBERNETES.md		GUIA_SUPERVIVENCIA_RACKSPACE_KUBERNETES.md
LICENSE		LICENSE
README-ES.MD		README-ES.MD
README.md		README.md
Rackspace_Kubernetes_Cluster_Survival_Guide.md		Rackspace_Kubernetes_Cluster_Survival_Guide.md
SECURITY.md		SECURITY.md
github_codespaces_setup.md		github_codespaces_setup.md
google_cloud_shell_setup.md		google_cloud_shell_setup.md
macosx_linux_setup.md		macosx_linux_setup.md
spot_rackspace_setup_guide.md		spot_rackspace_setup_guide.md

Uh oh!

Latest commit

History

Folders and files

Repository files navigation

Turbo Flow v4.0

🎬 Demo

About Adventure Wave Labs

What's New in v4.0.0

Major Changes

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

Architecture

Quick Start

DevPod Installation

Launch

What Gets Installed

Step 1: System Prerequisites

Step 2: Claude Code + Ruflo v3.5

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

Step 9: CLAUDE.md Generation

Step 10: Aliases + Environment + MCP Registration

Plugins (6)

Removed Plugins (9)

Key Commands

Migrating from v3.x

Repository Structure

Post-Setup

Version History

Resources

License

Ecosystem

Stay Connected

About

Topics

Resources

Contributing

Security policy

Stars

Watchers

Forks

Releases

Sponsor this project

Packages

Contributors

Languages