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.