ruflo

name	ruflo
description	Manage multi-agent swarms, memory, tasks, hooks, workflows, and browser automation via CLI. Use when spawning agents, storing/searching memory, orchestrating workflows, coordinating hive-minds, or automating browser interactions.
source_version	3.0.0
source_cli_hash	d3fd1093
generated_at	2026-04-06T08:38:53.305460+00:00

ruflo (via mcp2cli)

Multi-agent orchestration, vector memory, task management, and browser automation.

Shortcuts

No shortcuts configured. Use full form: mcp2cli ruflo <group> <cmd>

Commands

Agent

Command	Description	Example	Ref
mcp2cli ruflo agent spawn	Spawn a new agent	mcp2cli ruflo agent spawn --agent-type worker --model sonnet	ref
mcp2cli ruflo agent list	List all agents	mcp2cli ruflo agent list	ref
mcp2cli ruflo agent status	Get agent status	mcp2cli ruflo agent status --agent-id agent-1	ref
mcp2cli ruflo agent update	Update agent config		ref
mcp2cli ruflo agent terminate	Terminate an agent	mcp2cli ruflo agent terminate --agent-id agent-1	ref
mcp2cli ruflo agent health	Check agent health		ref

Memory

Command	Description	Example	Ref
mcp2cli ruflo memory store	Store value with vector embedding	mcp2cli ruflo memory store --key mykey --value "data"	ref
mcp2cli ruflo memory get	Retrieve value by key	mcp2cli ruflo memory get --key mykey	ref
mcp2cli ruflo memory search	Semantic vector search	mcp2cli ruflo memory search --query "auth patterns"	ref
mcp2cli ruflo memory list	List memory entries		ref
mcp2cli ruflo memory delete	Delete memory entry	mcp2cli ruflo memory delete --key mykey	ref
mcp2cli ruflo memory stats	Get memory statistics		ref

Task

Command	Description	Example	Ref
mcp2cli ruflo task create	Create a new task	mcp2cli ruflo task create --type feature --description "Add login"	ref
mcp2cli ruflo task list	List all tasks	mcp2cli ruflo task list --status pending	ref
mcp2cli ruflo task status	Get task status	mcp2cli ruflo task status --task-id t1	ref
mcp2cli ruflo task update	Update task progress		ref
mcp2cli ruflo task complete	Mark task complete	mcp2cli ruflo task complete --task-id t1	ref
mcp2cli ruflo task assign	Assign task to agents		ref
mcp2cli ruflo task cancel	Cancel a task		ref

Hooks

Command	Description	Example	Ref
mcp2cli ruflo hooks pre-task	Record task start, get agent suggestions	mcp2cli ruflo hooks pre-task --task-id t1 --description "Fix bug"	ref
mcp2cli ruflo hooks post-task	Record task completion	mcp2cli ruflo hooks post-task --task-id t1 --success true	ref
mcp2cli ruflo hooks route	Route task to optimal agent	mcp2cli ruflo hooks route --task "implement OAuth"	ref
mcp2cli ruflo hooks pre-edit	Get context before editing file	mcp2cli ruflo hooks pre-edit --file-path src/auth.ts	ref
mcp2cli ruflo hooks init	Initialize hooks in project	mcp2cli ruflo hooks init --template standard	ref
mcp2cli ruflo hooks metrics	View learning metrics		ref

Hive-Mind

Command	Description	Example	Ref
mcp2cli ruflo hive-mind spawn	Spawn workers and join hive	mcp2cli ruflo hive-mind spawn --count 3 --role worker	ref
mcp2cli ruflo hive-mind init	Initialize hive-mind collective	mcp2cli ruflo hive-mind init --topology mesh	ref
mcp2cli ruflo hive-mind status	Get hive-mind status		ref
mcp2cli ruflo hive-mind consensus	Propose or vote on consensus	mcp2cli ruflo hive-mind consensus --action propose --type config	ref
mcp2cli ruflo hive-mind broadcast	Broadcast to all workers	mcp2cli ruflo hive-mind broadcast --message "Start phase 2"	ref

Workflow

Command	Description	Example	Ref
mcp2cli ruflo workflow run	Run workflow from template	mcp2cli ruflo workflow run --template ci-pipeline	ref
mcp2cli ruflo workflow create	Create a new workflow	mcp2cli ruflo workflow create --name my-flow	ref
mcp2cli ruflo workflow list	List all workflows		ref
mcp2cli ruflo workflow status	Get workflow status	mcp2cli ruflo workflow status --workflow-id wf1	ref
mcp2cli ruflo workflow execute	Execute a workflow	mcp2cli ruflo workflow execute --workflow-id wf1	ref

Claims

Command	Description	Example	Ref
mcp2cli ruflo claims claim	Claim an issue for work	mcp2cli ruflo claims claim --issue-id 123 --claimant "agent:coder-1:coder"	ref
mcp2cli ruflo claims list	List all claims		ref
mcp2cli ruflo claims release	Release a claim	mcp2cli ruflo claims release --issue-id 123 --claimant "agent:coder-1:coder"	ref
mcp2cli ruflo claims handoff	Handoff issue to another agent		ref
mcp2cli ruflo claims load	Get agent load info		ref

Browser

Command	Description	Example	Ref
mcp2cli ruflo browser open	Navigate to URL	mcp2cli ruflo browser open --url https://example.com	ref
mcp2cli ruflo browser snapshot	Get accessibility tree		ref
mcp2cli ruflo browser screenshot	Capture screenshot		ref
mcp2cli ruflo browser click	Click an element	mcp2cli ruflo browser click --ref elem-1	ref
mcp2cli ruflo browser fill	Fill an input field	mcp2cli ruflo browser fill --ref input-1 --value "text"	ref

Swarm

Command	Description	Example	Ref
mcp2cli ruflo swarm init	Initialize a swarm	mcp2cli ruflo swarm init --topology hierarchical	ref
mcp2cli ruflo swarm status	Get swarm status		ref
mcp2cli ruflo swarm health	Check swarm health		ref
mcp2cli ruflo swarm shutdown	Shutdown a swarm		ref

Discover Parameters

Append --help to any command for full parameter list:

mcp2cli ruflo agent spawn --help

Note: Use Ref links above to view detailed parameter reference and more examples.

User Notes

MUST READ users/skill.md for custom workflows and tips. Config: MCP server settings live in ~/.agents/mcp2cli/servers.yaml - edit there to take effect.