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 initreplaces 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
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
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 memo |