Turbo Flow is an open-source agentic development environment for the Claude ecosystem, built by Adventure Wave Labs. Version 4.0 unifies orchestration (Ruflo v3.5), cross-session memory (Beads), codebase intelligence (GitNexus), and git worktree isolation behind a single installer, giving Claude Code 60+ specialized agents and 215+ MCP tools to work with.

Do I need coding experience to take this course?

Yes — this course assumes you're already comfortable writing code and using Claude Code day to day. You don't need prior experience with agent orchestration, swarms, or MCP servers; those concepts are taught from scratch. Basic terminal and Git familiarity is the main prerequisite.

How long does the course take to complete?

The core lessons take roughly two hours to work through at a normal pace, including running the installation steps yourself. Because the course is self-paced and organized by topic in the sidebar, you can complete it in one sitting or spread it across several sessions and jump straight to any section.

Is Turbo Flow free to use?

Yes. Turbo Flow is free and open source, and this Academy — including every lesson, code sample, and command reference — is free to access with no signup required.

What's the difference between Turbo Flow v3 and v4.0?

v4.0 is called 'The Ruflo Migration' because it replaces the legacy claude-flow toolchain and its four separate packages with a single Ruflo v3.5 installation. It also adds three capabilities v3.x never had — Beads memory, GitNexus codebase intelligence, and native git worktree isolation — while trimming 15 plugins down to 6 focused ones.

Do I need to know claude-flow already to follow this course?

No. The course is written to stand on its own for newcomers. If you're upgrading an existing claude-flow project, the Migration & Resources section gives you a direct command-by-command mapping from v3.4.1 to v4.0.0, but it isn't required reading to learn Turbo Flow from scratch.

Turbo Flow v4.0 — The Ruflo Migration

Built by Adventure Wave Labs, Turbo Flow v4.0 is a complete agentic development environment for the Claude ecosystem. This release replaces the legacy claude-flow toolchain with Ruflo v3.5 — a single command that unifies 215+ MCP tools, 60+ agents, cross-session memory (Beads), codebase intelligence (GitNexus), and native git worktree isolation. Turbo Flow Academy is the free, self-paced learning hub for this environment: every lesson in the sidebar mirrors a real capability of the toolchain, so you can read the docs and apply them in your own repository at the same time.

What's New in v4.0.0

Comparison of Turbo Flow v3.4.1 and 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

Consolidated Installation & Tooling

Version 4.0 collapses four separate CLI installs into one: npx ruflo@latest init now bootstraps orchestration, memory, and intelligence in a single pass. That drops the setup from 15 manual steps to 10 automated ones, and cuts the number of redundant or domain-specific plugins from 15 down to 6 focused packages. See Installation for the full walkthrough.

Memory, Intelligence & Isolation

Three capabilities that didn't exist in v3.4.1 ship by default in v4.0: Beads for git-native cross-session memory, GitNexus for a queryable knowledge graph of your codebase, and native git worktree isolation so each agent works in its own sandboxed branch without stepping on another agent's changes. These are covered in depth in System Architecture.

Key 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 blast-radius detection
Native Git Worktrees — Per-agent isolation with auto PG Vector schema namespacing
Native Agent Teams — Anthropic's experimental multi-agent spawning (max 3, depth 2)
6 focused plugins — 9 redundant/domain-specific plugins removed
OpenSpec — Spec-driven development, kept
UI UX Pro Max — Design skill, kept and updated
Statusline Pro v4.0 — Updated with TF 4.0 branding

Orchestration Engine

Ruflo v3.5 is the core engine behind every lesson in this course. It coordinates 60+ specialized agents across swarm topologies (hierarchical, mesh, ring, star), routes work across a 3-tier model system (Opus, Sonnet, Haiku), and exposes 215+ MCP tools that Claude Code can call directly — all covered in the Command Reference section.

Focused Plugin Set

Rather than shipping every possible plugin, v4.0 keeps six that cover the day-to-day loop: Agentic QE, Code Intelligence, Test Intelligence, Perf Optimizer, Teammate, and Gastown Bridge. Nine domain-specific plugins (healthcare, financial, legal, and several redundant neural/quantum modules) were archived rather than deleted — they still live in the repository's v3/ directory. See Plugins & Intelligence for details on each.

Who Turbo Flow Academy Is For

This course is written for developers who already use Claude Code and want to move from ad-hoc prompting to a repeatable, memory-backed agentic workflow. You do not need prior experience with claude-flow, Ruflo, or multi-agent orchestration — the lessons build that knowledge from the ground up, lesson by lesson.

Prerequisites

Comfort working in a terminal and basic Git commands (clone, branch, commit)
Claude Code installed and authenticated
Node.js 20+ available on your machine or dev container
No prior experience with agent orchestration, swarms, or MCP servers required

What You'll Need

A computer running macOS, Windows, or Linux (or a cloud dev environment)
A GitHub account for DevPod, Codespaces, or manual repository setup
About two hours of focused time to work through the core lessons, though the material is fully self-paced and can be revisited at any time

Course Structure & Learning Outcomes

What You'll Learn

The course is organized into six sections that match the sidebar navigation: Getting Started (this overview and background on Adventure Wave Labs), Installation (the 10-step automated setup via DevPod, Codespaces, or manual scripts), Architecture (the seven-layer system design and three-tier memory model), Plugins & Intelligence (the six core plugins plus GitNexus codebase intelligence), Command Reference (50+ aliases across orchestration, memory, isolation, quality, and intelligence), and Migration & Resources (upgrading from v3.x and where to find the source repositories).

Learning Outcomes

By the end of this course you will be able to install Turbo Flow v4.0 from scratch, explain how Ruflo, Beads, and GitNexus fit together in the seven-layer architecture, launch and choose between swarm topologies for a given task, use the bd-*, ruv-*, wt-*, and gnx-* command families from memory, and migrate an existing claude-flow-based project to the v4.0 toolchain without losing any historical context.

Frequently Asked Questions

What is Turbo Flow?: Turbo Flow is an open-source agentic development environment for the Claude ecosystem, built by Adventure Wave Labs. Version 4.0 unifies orchestration (Ruflo v3.5), cross-session memory (Beads), codebase intelligence (GitNexus), and git worktree isolation behind a single installer, giving Claude Code 60+ specialized agents and 215+ MCP tools to work with.
Do I need coding experience to take this course?: Yes — this course assumes you're already comfortable writing code and using Claude Code day to day. You don't need prior experience with agent orchestration, swarms, or MCP servers; those concepts are taught from scratch. Basic terminal and Git familiarity is the main prerequisite.
How long does the course take to complete?: The core lessons take roughly two hours to work through at a normal pace, including running the installation steps yourself. Because the course is self-paced and organized by topic in the sidebar, you can complete it in one sitting or spread it across several sessions and jump straight to any section.
Is Turbo Flow free to use?: Yes. Turbo Flow is free and open source, and this Academy — including every lesson, code sample, and command reference — is free to access with no signup required.
What's the difference between Turbo Flow v3 and v4.0?: v4.0 is called "The Ruflo Migration" because it replaces the legacy claude-flow toolchain and its four separate packages with a single Ruflo v3.5 installation. It also adds three capabilities v3.x never had — Beads memory, GitNexus codebase intelligence, and native git worktree isolation — while trimming 15 plugins down to 6 focused ones. The Migration & Resources section covers the full command mapping.
Do I need to know claude-flow already to follow this course?: No. The course is written to stand on its own for newcomers. If you're upgrading an existing claude-flow project, the Migration & Resources section gives you a direct command-by-command mapping from v3.4.1 to v4.0.0, but it isn't required reading to learn Turbo Flow from scratch.