How to install hive-mind
npx skills add https://github.com/ruvnet/ruflo --skill hive-mindClaude Code
Cursor
Windsurf
Cline
Full instructions (SKILL.md)
Source of truth, from ruvnet/ruflo.
name: hive-mind description: > Byzantine fault-tolerant consensus and distributed coordination. Queen-led hierarchical swarm management with multiple consensus strategies. Use when: distributed coordination, fault-tolerant operations, multi-agent consensus, collective decision making. Skip when: single-agent tasks, simple operations, local-only work.
Hive-Mind Skill
Purpose
Byzantine fault-tolerant consensus and distributed swarm coordination.
When to Trigger
- Multi-agent distributed tasks
- Fault-tolerant operations needed
- Collective decision making
- Complex coordination patterns
Topologies
| Topology | Description | Use Case |
|---|---|---|
hierarchical | Queen controls workers | Default, anti-drift |
mesh | Fully connected peers | Research, exploration |
hierarchical-mesh | Hybrid | Recommended for complex |
adaptive | Dynamic based on load | Auto-scaling |
Consensus Strategies
| Strategy | Tolerance | Use Case |
|---|---|---|
byzantine | f < n/3 faulty | Untrusted environment |
raft | f < n/2 faulty | Leader-based, consistent |
gossip | Eventual | Large scale, availability |
crdt | Conflict-free | Concurrent updates |
quorum | Configurable | Tunable consistency |
Commands
Initialize Hive-Mind
npx claude-flow hive-mind init --topology hierarchical-mesh --consensus raft
Spawn Queen
npx claude-flow hive-mind spawn --role queen --name coordinator
Check Consensus Status
npx claude-flow hive-mind consensus --status
View Sessions
npx claude-flow hive-mind sessions --active
Best Practices
- Use hierarchical for coding tasks (anti-drift)
- Use raft consensus for consistency
- Keep agent count under 8 for coordination
- Run frequent checkpoints
Related skills
More from ruvnet/ruflo and the wider catalog.
AG
agent-arch-system-design
ruvnet/ruflo
Agent skill for arch-system-design - invoke with $agent-arch-system-design
1.1k installs
AG
agent-workflow
ruvnet/ruflo
Agent skill for workflow - invoke with $agent-workflow
1.1k installsAudited
WO
workflow-automation
ruvnet/ruflo
>
1.1k installs
SE
security-audit
ruvnet/ruflo
>
1.1k installs
AG
agent-swarm
ruvnet/ruflo
Agent skill for swarm - invoke with $agent-swarm
998 installsAudited
AG
agent-spec-mobile-react-native
ruvnet/ruflo
Agent skill for spec-mobile-react-native - invoke with $agent-spec-mobile-react-native
979 installsAudited