TurboFlow 4.0.0 Release Notes — The Ruflo Migration

TurboFlow 4.0.0 Release Notes — The Ruflo Migration

**Release Date:** March 7, 2026 **Previous Version:** v3.4.1 (February 2025)

---

Summary

TurboFlow 4.0 is a complete rebuild. Claude Flow graduated to Ruflo v3.5 after 5,800 commits and a rename. Every package reference, alias, and integration point in TurboFlow has been rewritten to match. The setup script went from 15 steps installing ghost packages to 10 steps installing what actually exists.

Three new systems fill gaps that v3.x never addressed: Beads gives agents memory that survives between sessions, GitNexus gives agents structural awareness of the codebase before they touch it, and native git worktrees give each parallel agent its own isolated workspace.

---

By the Numbers

Metric	v3.4.1	v4.0.0
Setup steps	15	10
Setup script lines	~500	771
Core packages to install	4 separate	1 (Ruflo bundles all)
MCP tools	175+	215+
Agents	60+	60+
Plugins	15	6
Cross-session memory	None	Beads (git-native JSONL)
Agent isolation	None	Git worktrees + PG Vector schema namespacing
Codebase awareness	None	GitNexus knowledge graph + MCP
Model routing	Manual	Ruflo 3-tier auto-routing (~75% cost savings)
Browser automation	Playwright MCP + Chrome DevTools MCP	Bundled in Ruflo (59 MCP tools)
Observability	agtrace (separate install)	Bundled in Ruflo
Post-setup verification	15 steps	13 steps

---

What's New

Ruflo v3.5 (replaces Claude Flow)

The core orchestration layer is now a single `npx ruflo@latest init` command. This one install replaces four separate v3.x packages: `claude-flow@alpha`, `@ruvector/cli`, `@ruvector/sona`, and `@claude-flow/browser`. Ruflo v3.5 bundles AgentDB v3 with 8 new controllers, RuVector with WASM acceleration, SONA, 215 MCP tools, 60+ agents, a skills-based system (replacing slash commands), 3-tier intelligent model routing, 59 browser automation MCP tools, and built-in observability.

All `cf-*` aliases are replaced by `rf-*` aliases.

Beads — Cross-Session Project Memory

Agents now remember across sessions. Beads stores issues, decisions, and blockers as git-native JSONL files. The CLAUDE.md template includes a mandatory memory protocol: `bd ready` at session start, `bd create` during work, and automatic AgentDB persistence at session end. This is the three-tier memory system the v3.x PRD called for but never shipped.

GitNexus — Codebase Knowledge Graph

Before agents edit shared code, they can now check the blast radius. GitNexus indexes your repo into a knowledge graph of dependencies, call chains, and execution flows. It runs as an MCP server so Claude Code agents get these tools natively. The `wt-add` worktree helper auto-indexes new worktrees in the background.

Native Git Worktree Helpers

Each parallel agent now operates in its own git worktree with automatic PG Vector schema namespacing. Four bash func