Skip to content
Get packs

Ruflo

An agent harness that adds multi-agent swarms, shared memory and coordination on top of Claude Code and Codex.

GitHub Download v3.71.0
Stars
80.6k
Forks
9.5k
Licence
MIT
Language
TypeScript
Last update
4 days ago
Type
Dev tool

What it is

Ruflo is an open-source layer that sits around AI coding assistants such as Claude Code and Codex. It lets several AI agents split up tasks, coordinate as a swarm, and keep memory across sessions. The README describes it as the execution layer that gives a model tools, memory and controls so it can do longer jobs.

  • Run the setup wizard in a project with npx ruflo@latest init wizard
  • Connect an MCP-enabled client to the Ruflo MCP server with npx -y ruflo@latest mcp start
  • Open the optional terminal UI with npx ruflo tui to view swarm, cost and event pages
  • Use the Claude Code plugins to add core tools and the visual console inside Claude Code

Great for

  • Developers already using Claude Code or Codex who want multiple agents working together
  • Teams experimenting with multi-agent workflows and shared memory
  • People who want an MCP server exposing Ruflo tools to an MCP-capable client
  • Users comfortable with the terminal and npm setup

Not ideal for

  • Non-developers looking for a simple chat app, since setup and concepts take time to learn
  • Anyone who needs fully audited, production-hardened security without reviewing the code, because the README says mods run with the account's permissions
  • Users who do not already use Claude Code, Codex or another MCP-enabled client, since most integrations depend on them
Step-by-step guide: how to use RufloInstall, first run, examples, tips and FAQs
Ruflo alternativesCrewAI vs RufloLangGraph vs Rufloplanning-with-files vs Ruflo

How to get it

  1. 1

    Install with a package manager

    You'll need: Claude Code 2.1.287 or later (for the Claude Code plugin path) · Node.js (required for npx; version not stated in the README excerpt)

    Set up the project with the wizard (Codex or other MCP clients)

    npx ruflo@latest init wizard

    Start the MCP server

    npx -y ruflo@latest mcp start

    Open the optional terminal UI

    npx ruflo tui
  2. 2

    Run it

    • Install the Claude Code plugins inside Claude Code using the /plugin commands in the README, then run /reload-plugins
    • Run /ruflo inside Claude Code to start
    • Or run npx ruflo@latest init wizard in your project terminal and connect your MCP client
    • Optionally run npx ruflo tui to see the terminal dashboard
  3. 3

    Get the most out of it

    • Use the plugin install path to get the core tools, visual console and mods together
    • Review mod code before installing, as the README advises
    • Read the User Guide at docs/USERGUIDE.md for the terminal UI and setup details
    • Read docs/ruflo-explained.md, the chaptered guide mentioned in the README
    • Try the --dry-run flag with init --grok to preview project changes before writing files

Downloads

Source code (.zip)main branch · straight from GitHubRelease v3.71.0Release notes and sourceOfficial website & docsCognitum.One

Strengths

  • Works with existing assistants (Claude Code, Codex, MCP clients) rather than replacing them
  • Clear install paths documented in the README, including plugin and npx options
  • MIT licensed with a large public project history and active recent commits

Trade-offs

  • The README is long and promotional in places, and many features and numbers are hard to verify from the text alone
  • Some integrations (console, mods, hooks) are specific to Claude Code, and hook support depends on the client
  • Memory and learning features require embeddings and configured modules, so they are not plug-and-play

How it compares

ProjectStarsTypeLevelUpdatedBest for
ruflo (this)80.6kDev toolintermediate4 days agoDevelopers already using Claude Code or Codex who want multiple agents working together
langgraph44.3kLibraryintermediate4 days agoPython developers building multi-step AI agents that must survive failures or long waits
crewAI60.4kLibraryintermediate4 days agoPython developers prototyping multi-agent workflows
PocketFlow11.3kLibraryintermediate3 months agoDevelopers who want a small, readable LLM framework they can inspect in full
paperclip110kAppadvanced4 days agoDevelopers already running several AI coding agents who want one place to track them
planning-with-files27.8kDev toolbeginner6 days agoDevelopers running long multi-step tasks in Claude Code or Codex CLI

Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.