Skip to content

v4.0

Latest
Latest

Choose a tag to compare

View all tags
@marcuspat marcuspat released this 09 Mar 00:09
v4.0
504b130
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

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

Known Issues

  • Ruflo's --wizard flag may fall back to non-interactive init in headless environments (DevPod, Codespaces). This is handled by the setup script.
  • The npx ruflo@latest plugins install -n flag may need --name on some versions. The setup script tries both.
  • Beads bd init requires the workspace to be a git repository.
  • GitNexus indexing runs in the background on wt-add — large repos may take a moment.

What's Next

  • v4.1: OpenFang Hands integration — autonomous agents for research, lead gen, social posting, competitor monitoring per business entity
  • v4.2: Open WebUI 4-instance deployment automation (Rackspace Spot)
  • v4.3: Per-entity CLAUDE.md and knowledge base customization

"The tools change. The composition survives. The businesses run."

Assets 2
Loading