Turbo Flow
Advanced Agentic Development Environment Supporting Devpods, Rackspace Spot Instances, Github Codespaces, Google Cloud Shell, and more! Features 600+ AI subagents, Claude Flow, SPARC methodology, and automatic context loading! Deploy intelligent multi-agent swarms, coordinate autonomous workflows.
Ask AI about Turbo Flow
Powered by Claude Β· Grounded in docs
I know everything about Turbo Flow. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
Turbo Flow v4.0 β The Ruflo Migration
Complete Agentic Development Environment β Ruflo v3.5 + Beads + Worktrees + Agent Teams
Quick Start β’ Installation β’ Plugins β’ Commands β’ Migration β’ Resources
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 |
+------------------------------------------------------------------+
| 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/v4
chmod +x .devcontainer/setup-turboflow-4.sh
./.devcontainer/setup-turboflow-4.sh
source ~/.bashrc
turbo-status
What Gets Installed
The setup-turboflow-4.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-cli | 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 β userf-*instead - Slash commands (
/sparc, etc.) are gone β Ruflo auto-activates skills - Run
bd initin your project repos to enable Beads memory - Run
npx gitnexus analyzein 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 (Claude Flow era)
βββ v4/ β active development (Ruflo era)
β βββ .devcontainer/
β β βββ devcontainer.json
β β βββ setup-turboflow-4.sh
β β βββ post-setup-turboflow-4.sh
β βββ scripts/
β β βββ generate-claude-md.sh
β βββ CLAUDE.md
β βββ README.md
βββ docs/
β βββ migration-v3-to-v4.md
βββ CLAUDE.md β root, points to v4/
βββ 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)
./post-setup-turboflow-4.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 |
|---|---|
| Ruflo | GitHub: ruvnet/ruflo |
| Turbo Flow | GitHub: marcuspat/turbo-flow |
| OpenSpec | npm: @fission-ai/openspec |
| Agentic QE | npm: agentic-qe |
Built for the Claude ecosystem
Ruflo v3.5. 215+ MCP tools. 6 plugins. Beads. GitNexus. Worktrees. One command.
