Skip to content
Agentic Levels
Start hereLevelsTracksPromptsAbout
Get my levelGet my level

  • Start hereYour first useful task with AI.
  • Level quiz8 questions. No AI needed.
  • Fluency ScoreYour Level and a score, from your own AI.

  • LevelsThe 11 levels, in order.
  • LessonsShort lessons, filter by level.
  • TracksGuided paths by tool, role or goal.
  • Set up your AI tool
  • Starter packFree files that help AI remember.

  • PromptsReady prompts to copy and adapt.
  • ChatGPT vs Claude vs GeminiPick the right one for the job.
  • How-tos
  • ReferenceCommands for Claude Code, Codex, Antigravity.
  • ResourcesHand-picked reading and tools.

  • Your progress
  • Your next moveAn interview that picks your next skill.
  • Your next lessonsThe next lessons at your level.
  • Updates

  • Pricing
  • About
  • FAQ & Feedback
  • Work with us
  • How we handle your data
Sign inPreferences
AboutPricingHow-tosPromptsStarter packMy stackHow we handle your data

© 2026 Fuentes Studio

PrivacyTermsRefundsAccessibilityAI content policyCredits
yourCouncil
Ready to help
✦

What do you want to understand?

Ask anything about what you're learning.

←How-to guides
  1. Resources
  2. ›How-to guides

How to use Ruflo

Enterprise multi-agent swarm platform for Claude Code: 100+ coordinated agents with HNSW vector memory, cross-org federation, SONA self-learning, and multi-provider LLM routing.

Levels 6 to 8On GitHub

Running one Claude Code session handles one task at a time. Ruflo transforms Claude Code into a collaborative swarm intelligence system: deploy 100+ specialized agents across machines and organizations with hierarchical or mesh coordination and consensus-based decision-making. HNSW-indexed vector memory delivers sub-millisecond retrieval across all agents. Cross-organization federation with zero-trust auth and PII redaction lets enterprise teams share agent capabilities securely. SONA neural pattern learning improves agent behavior from repeated tasks. Web UIs (flo.ruv.io for chat, goal.ruv.io for autonomous goal planning) make the swarm accessible without a terminal. Remote phone control is one of 60+ commands in a 32-plugin system.

Before you start

Claude Code installed. npm or the Claude plugin marketplace. For full swarm features, a machine with at least 8GB RAM, HNSW vector indexing is memory-intensive. The lightweight plugin install covers most individual use cases.

  1. 1Install Ruflo: pick the path that fits your setup
  2. 2Extract commands from the README if you want to inspect first
  3. 3Start a session and connect remotely
  4. 4Send a command and verify the session responded

Steps

01

Install Ruflo: pick the path that fits your setup

Three paths: (A) direct npm install, fastest if you trust the package. (B) Paste the Ruflo README into Claude and ask it to extract the install commands for your platform, useful if you want to inspect before running. (C) Claude plugin install if Ruflo appears in your marketplace.

Option A: direct npm install
npm install -g ruflo ruflo --version
02

Extract commands from the README if you want to inspect first

This option lets you see exactly what you are running before running it, useful any time a README may have changed since a guide was written.

Option B: paste README into Claude
Here is the Ruflo README: [PASTE_README_CONTENTS_HERE] I am on [YOUR_PLATFORM]. Extract only the commands I need to install and start Ruflo. Skip explanations, just the commands, in order, ready to paste into a terminal.
[PASTE_README_CONTENTS_HERE]Full text of the Ruflo README e.g. (paste the raw README from https://github.com/ruvnet/ruflo)
[YOUR_PLATFORM]Your operating system e.g. macOS (Apple Silicon)
03

Start a session and connect remotely

Run `ruflo start` from your terminal. Ruflo gives you a session ID and connection URL. Open that URL in your phone's browser or the Ruflo app. From there you can send commands to Claude Code as if you were at your desk.

Start a session
ruflo start --session-name [SESSION_NAME] --project [PROJECT_PATH]
[SESSION_NAME]A name for this session e.g. overnight-research-run
[PROJECT_PATH]Absolute path to your project e.g. /Users/me/projects/my-app
04

Send a command and verify the session responded

From your phone or remote terminal, send a command. Ruflo streams Claude Code's output back to you. Verify the session is live by checking that the output timestamp matches the current time, a stale timestamp means the session stopped responding.

Send a remote command
ruflo send --session [SESSION_NAME] "[COMMAND_FOR_CLAUDE]"
[SESSION_NAME]Your session name e.g. overnight-research-run
[COMMAND_FOR_CLAUDE]Instruction for Claude Code e.g. Continue with the authentication module. Start with the session token refresh logic.

How do you know it worked?

  • `ruflo --version` prints a version number without errors.
  • You started a session and the dashboard showed it as active.
  • You sent a command from a remote device and Claude Code's response appeared in the output stream.
  • The session stayed active for at least 10 minutes without dropping.

If something looks off

Session drops when your laptop sleeps
Ruflo runs Claude Code on your local machine. If the machine sleeps, the session dies. Use `caffeinate -i ruflo start ...` on macOS to prevent sleep during long sessions.
Sending destructive commands without confirming state
Before any command that writes, deletes, or deploys, send a status check first: 'What are you currently working on?' Confirm the session is where you think it is before acting.
Leaving sessions running with no stopping condition
Set a clear stopping point in your initial command, 'stop after completing the auth module and wait for my input', rather than letting the session run indefinitely.

Skills & Commands Reference

Ruflo commands for starting, connecting to, and directing remote Claude Code sessions.

Command / SkillWhat it doesWhen to use it
ruflo startLaunch a Claude Code session and return a connection URL for remote accessStarting any task you want to monitor or direct from a phone or remote terminal
--session-nameName the session so subsequent commands can reference itEvery ruflo start, unnamed sessions are hard to reconnect to
ruflo sendSend a command to a running session from any terminal or the Ruflo appRedirecting or continuing work while away from your desk
ruflo statusCheck whether a session is live and when it last respondedBefore sending commands, a stale timestamp means the session dropped
caffeinate -i ruflo start ...advancedmacOS prefix that prevents sleep during a long Ruflo sessionAny overnight or multi-hour session running on a laptop

What you'll do, 4 steps

  1. 1Install Ruflo: pick the path that fits your setup
  2. 2Extract commands from the README if you want to inspect first
  3. 3Start a session and connect remotely
  4. 4Send a command and verify the session responded

Was this helpful?