mcpField
H
hive-mind

hive-mind

github.com/ruvnetAgent workflows80.0k1.1k installsUpdated today
Repository

About hive-mind

hive-mind is a skill for distributed multi-agent coordination and consensus. It offers several topologies and consensus strategies for tasks requiring fault tolerance or collective decisions.

Key features

  1. 01Support multiple swarm topologies
  2. 02Offer varied consensus strategies
  3. 03Spawn a coordinator node
  4. 04View consensus status and sessions

Use cases

  1. 01Coordinate distributed multi-agent tasks
  2. 02Reach consensus in untrusted environments
  3. 03Inspect swarm sessions and consensus state

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/ruvnet/ruflo --skill hive-mind

After installing, type/hive-mindin Claude Code to confirm it loaded.

Details

From the project README

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

TopologyDescriptionUse Case
hierarchicalQueen controls workersDefault, anti-drift
meshFully connected peersResearch, exploration
hierarchical-meshHybridRecommended for complex
adaptiveDynamic based on loadAuto-scaling

Consensus Strategies

StrategyToleranceUse Case
byzantinef < n/3 faultyUntrusted environment
raftf < n/2 faultyLeader-based, consistent
gossipEventualLarge scale, availability
crdtConflict-freeConcurrent updates
quorumConfigurableTunable 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

  1. Use hierarchical for coding tasks (anti-drift)
  2. Use raft consensus for consistency
  3. Keep agent count under 8 for coordination
  4. Run frequent checkpoints

Comments

Markdown supported