@monoes/monomindcli 1.8.0 → 1.9.0

package/.claude/commands/github/repo-architect.md

@@ -1,8 +1,12 @@
+---
+name: github:repo-architect
+---
+
 # GitHub Repository Architect
 
 ## Purpose
 
-Repository structure optimization and multi-repo management with ruv-swarm coordination for scalable project architecture and development workflows.
+Repository structure optimization and multi-repo management with Monomind swarm coordination for scalable project architecture and development workflows.
 
 ## Capabilities
 
@@ -35,21 +39,20 @@ mcp__monomind__agent_spawn { type: "optimizer", name: "Structure Optimizer" }
 mcp__monomind__agent_spawn { type: "coordinator", name: "Multi-Repo Coordinator" }
 
 // Analyze current repository structure
-LS("/workspaces/ruv-FANN/claude-code-flow/claude-code-flow")
-LS("/workspaces/ruv-FANN/ruv-swarm/npm")
+LS(".")
 
 // Search for related repositories
 mcp__github__search_repositories {
-  query: "user:nokhodian claude",
+  query: "user::owner",
   sort: "updated",
   order: "desc"
 }
 
 // Orchestrate structure optimization
-mcp__monomind__task_orchestrate {
+mcp__monomind__coordination_orchestrate {
   task: "Analyze and optimize repository structure for scalability and maintainability",
-  strategy: "adaptive",
-  priority: "medium"
+  agents: ["analyst", "architect", "optimizer"],
+  strategy: "parallel"
 }
 ```
 
@@ -59,14 +62,14 @@ mcp__monomind__task_orchestrate {
 // Create standardized repository template
 mcp__github__create_repository {
   name: "claude-project-template",
-  description: "Standardized template for Claude Code projects with ruv-swarm integration",
+  description: "Standardized template for Claude Code projects with monomind integration",
   private: false,
   autoInit: true
 }
 
 // Push template structure
 mcp__github__push_files {
-  owner: "nokhodian",
+  owner: ":owner",
   repo: "claude-project-template",
   branch: "main",
   files: [
@@ -83,16 +86,16 @@ mcp__github__push_files {
       content: JSON.stringify({
         version: "1.0",
         mcp_servers: {
-          "ruv-swarm": {
+          "monomind": {
             command: "npx",
-            args: ["ruv-swarm", "mcp", "start"],
+            args: ["monomind", "mcp", "start"],
             stdio: true
           }
         },
         hooks: {
-          pre_task: "npx ruv-swarm hook pre-task",
-          post_edit: "npx ruv-swarm hook post-edit",
-          notification: "npx ruv-swarm hook notification"
+          pre_task: "npx monomind hooks pre-task",
+          post_edit: "npx monomind hooks post-edit",
+          notification: "npx monomind hooks notify"
         }
       }, null, 2)
     },
@@ -105,10 +108,10 @@ mcp__github__push_files {
       content: JSON.stringify({
         name: "claude-project-template",
         version: "1.0.0",
-        description: "Claude Code project with ruv-swarm integration",
+        description: "Claude Code project with monomind integration",
         engines: { node: ">=20.0.0" },
         dependencies: {
-          "ruv-swarm": "^1.0.11"
+          "@monomind/cli": "latest"
         }
       }, null, 2)
     },
@@ -124,16 +127,16 @@ npx monomind start --ui
 \`\`\`
 
 ## Features
-- 🧠 ruv-swarm integration
-- 🎯 SPARC development modes
-- 🔧 GitHub workflow automation
-- 📊 Advanced coordination capabilities
+- Monomind swarm integration
+- SPARC development modes
+- GitHub workflow automation
+- Advanced coordination capabilities
 
 ## Documentation
 See CLAUDE.md for complete integration instructions.`
     }
   ],
-  message: "feat: Create standardized Claude project template with ruv-swarm integration"
+  message: "feat: Create standardized Claude project template with Monomind integration"
 }
 ```
 
@@ -141,13 +144,13 @@ See CLAUDE.md for complete integration instructions.`
 
 ```javascript
 // Synchronize structure across related repositories
-const repositories = ["claude-code-flow", "ruv-swarm", "claude-extensions"];
+const repositories = ["@monomind/cli", "@monomind/hooks", "@monomind/memory"];
 
 // Update common files across repositories
 repositories.forEach((repo) => {
   mcp__github__create_or_update_file({
     owner: "nokhodian",
-    repo: "ruv-FANN",
+    repo: "monomind",
     path: `${repo}/.github/workflows/integration.yml`,
     content: `name: Integration Tests
 on: [push, pull_request]
@@ -180,10 +183,8 @@ jobs:
   mcp__monomind__agent_spawn { type: "coordinator", name: "Multi-Repo Coordinator" }
 
   // Analyze current repository structures
-  LS("/workspaces/ruv-FANN/claude-code-flow/claude-code-flow")
-  LS("/workspaces/ruv-FANN/ruv-swarm/npm")
-  Read("/workspaces/ruv-FANN/claude-code-flow/claude-code-flow/package.json")
-  Read("/workspaces/ruv-FANN/ruv-swarm/npm/package.json")
+  LS(".")
+  Read("package.json")
 
   // Search for architectural patterns using gh CLI
   ARCH_PATTERNS=$(Bash(`gh search repos "language:javascript template architecture" \
@@ -197,19 +198,19 @@ jobs:
     branch: "architecture/optimization",
     files: [
       {
-        path: "claude-code-flow/claude-code-flow/.github/ISSUE_TEMPLATE/integration.yml",
+        path: ".github/ISSUE_TEMPLATE/integration.yml",
         content: "[Integration issue template]"
       },
       {
-        path: "claude-code-flow/claude-code-flow/.github/PULL_REQUEST_TEMPLATE.md",
+        path: ".github/PULL_REQUEST_TEMPLATE.md",
         content: "[Standardized PR template]"
       },
       {
-        path: "claude-code-flow/claude-code-flow/docs/ARCHITECTURE.md",
+        path: "docs/ARCHITECTURE.md",
         content: "[Architecture documentation]"
       },
       {
-        path: "ruv-swarm/npm/.github/workflows/cross-package-test.yml",
+        path: ".github/workflows/cross-package-test.yml",
         content: "[Cross-package testing workflow]"
       }
     ],
@@ -226,12 +227,10 @@ jobs:
   ]}
 
   // Store architecture analysis
-  mcp__monomind__memory_usage {
-    action: "store",
+  mcp__monomind__memory_store {
     key: "architecture/analysis/results",
     value: {
       timestamp: Date.now(),
-      repositories_analyzed: ["claude-code-flow", "ruv-swarm"],
       optimization_areas: ["structure", "workflows", "templates", "documentation"],
       recommendations: ["standardize_structure", "improve_workflows", "enhance_templates"],
       implementation_status: "in_progress"
@@ -244,15 +243,14 @@ jobs:
 ### 1. **Monorepo Structure Pattern**
 
 ```
-ruv-FANN/
+monomind/
 ├── packages/
-│   ├── claude-code-flow/
+│   ├── @monomind/cli/
 │   │   ├── src/
 │   │   ├── .claude/
 │   │   └── package.json
-│   ├── ruv-swarm/
+│   ├── @monomind/hooks/
 │   │   ├── src/
-│   │   ├── wasm/
 │   │   └── package.json
 │   └── shared/
 │       ├── types/
@@ -301,12 +299,12 @@ ruv-FANN/
 ```javascript
 const integrationPattern = {
   packages: {
-    "claude-code-flow": {
+    "@monomind/cli": {
       role: "orchestration_layer",
-      dependencies: ["ruv-swarm"],
+      dependencies: ["@monomind/hooks", "@monomind/memory"],
       provides: ["CLI", "workflows", "commands"],
     },
-    "ruv-swarm": {
+    "@monomind/hooks": {
       role: "coordination_engine",
       dependencies: [],
       provides: ["MCP_tools", "neural_networks", "memory"],

package/.claude/commands/github/sync-coordinator.md

@@ -1,7 +1,11 @@
+---
+name: github:sync-coordinator
+---
+
 # GitHub Sync Coordinator
 
 ## Purpose
-Multi-package synchronization and version alignment with ruv-swarm coordination for seamless integration between claude-code-flow and ruv-swarm packages.
+Multi-package synchronization and version alignment with monomind swarm coordination for seamless integration across packages.
 
 ## Capabilities
 - **Package synchronization** with intelligent dependency resolution
@@ -31,26 +35,25 @@ mcp__monomind__agent_spawn { type: "coder", name: "Integration Developer" }
 mcp__monomind__agent_spawn { type: "tester", name: "Validation Engineer" }
 
 // Analyze current package states
-Read("/workspaces/ruv-FANN/claude-code-flow/claude-code-flow/package.json")
-Read("/workspaces/ruv-FANN/ruv-swarm/npm/package.json")
+Read("package.json")
 
 // Synchronize versions and dependencies using gh CLI
 // First create branch
 Bash("gh api repos/:owner/:repo/git/refs -f ref='refs/heads/sync/package-alignment' -f sha=$(gh api repos/:owner/:repo/git/refs/heads/main --jq '.object.sha')")
 
 // Update file using gh CLI
-Bash(`gh api repos/:owner/:repo/contents/claude-code-flow/claude-code-flow/package.json \
+Bash(`gh api repos/:owner/:repo/contents/packages/@monomind/cli/package.json \
   --method PUT \
   -f message="feat: Align Node.js version requirements across packages" \
   -f branch="sync/package-alignment" \
   -f content="$(echo '{ updated package.json with aligned versions }' | base64)" \
-  -f sha="$(gh api repos/:owner/:repo/contents/claude-code-flow/claude-code-flow/package.json?ref=sync/package-alignment --jq '.sha')")`)
+  -f sha="$(gh api repos/:owner/:repo/contents/packages/@monomind/cli/package.json?ref=sync/package-alignment --jq '.sha')")`)
 
 // Orchestrate validation
-mcp__monomind__task_orchestrate {
+mcp__monomind__coordination_orchestrate {
   task: "Validate package synchronization and run integration tests",
-  strategy: "parallel",
-  priority: "high"
+  agents: ["coordinator", "analyst", "tester"],
+  strategy: "parallel"
 }
 ```
 
@@ -58,23 +61,22 @@ mcp__monomind__task_orchestrate {
 ```javascript
 // Synchronize CLAUDE.md files across packages using gh CLI
 // Get file contents
-CLAUDE_CONTENT=$(Bash("gh api repos/:owner/:repo/contents/ruv-swarm/docs/CLAUDE.md --jq '.content' | base64 -d"))
+CLAUDE_CONTENT=$(Bash("gh api repos/:owner/:repo/contents/CLAUDE.md --jq '.content' | base64 -d"))
 
-// Update claude-code-flow CLAUDE.md to match using gh CLI
+// Update package CLAUDE.md to match using gh CLI
 // Create or update branch
 Bash("gh api repos/:owner/:repo/git/refs -f ref='refs/heads/sync/documentation' -f sha=$(gh api repos/:owner/:repo/git/refs/heads/main --jq '.object.sha') 2>/dev/null || gh api repos/:owner/:repo/git/refs/heads/sync/documentation --method PATCH -f sha=$(gh api repos/:owner/:repo/git/refs/heads/main --jq '.object.sha')")
 
 // Update file
-Bash(`gh api repos/:owner/:repo/contents/claude-code-flow/claude-code-flow/CLAUDE.md \
+Bash(`gh api repos/:owner/:repo/contents/packages/@monomind/cli/CLAUDE.md \
   --method PUT \
-  -f message="docs: Synchronize CLAUDE.md with ruv-swarm integration patterns" \
+  -f message="docs: Synchronize CLAUDE.md with Monomind integration patterns" \
   -f branch="sync/documentation" \
-  -f content="$(echo '# Claude Code Configuration for ruv-swarm\n\n[synchronized content]' | base64)" \
-  -f sha="$(gh api repos/:owner/:repo/contents/claude-code-flow/claude-code-flow/CLAUDE.md?ref=sync/documentation --jq '.sha' 2>/dev/null || echo '')")`)
+  -f content="$(echo '# Claude Code Configuration for Monomind\n\n[synchronized content]' | base64)" \
+  -f sha="$(gh api repos/:owner/:repo/contents/packages/@monomind/cli/CLAUDE.md?ref=sync/documentation --jq '.sha' 2>/dev/null || echo '')")`)
 
 // Store sync state in memory
-mcp__monomind__memory_usage {
-  action: "store",
+mcp__monomind__memory_store {
   key: "sync/documentation/status",
   value: { timestamp: Date.now(), status: "synchronized", files: ["CLAUDE.md"] }
 }
@@ -85,19 +87,19 @@ mcp__monomind__memory_usage {
 // Coordinate feature implementation across packages
 mcp__github__push_files {
   owner: "nokhodian",
-  repo: "ruv-FANN",
+  repo: "monomind",
   branch: "feature/github-commands",
   files: [
     {
-      path: "claude-code-flow/claude-code-flow/.claude/commands/github/github-modes.md",
+      path: ".claude/commands/github/github-modes.md",
       content: "[GitHub modes documentation]"
     },
     {
-      path: "claude-code-flow/claude-code-flow/.claude/commands/github/pr-manager.md", 
+      path: ".claude/commands/github/pr-manager.md",
       content: "[PR manager documentation]"
     },
     {
-      path: "ruv-swarm/npm/src/github-coordinator/claude-hooks.js",
+      path: "packages/@monomind/hooks/src/github-coordinator/claude-hooks.js",
       content: "[GitHub coordination hooks]"
     }
   ],
@@ -110,17 +112,17 @@ Bash(`gh pr create \
   --title "Feature: GitHub Workflow Integration with Swarm Coordination" \
   --head "feature/github-commands" \
   --base "main" \
-  --body "## 🚀 GitHub Workflow Integration
+  --body "## GitHub Workflow Integration
 
 ### Features Added
-- ✅ Comprehensive GitHub command modes
-- ✅ Swarm-coordinated PR management  
-- ✅ Automated issue tracking
-- ✅ Cross-package synchronization
+- Comprehensive GitHub command modes
+- Swarm-coordinated PR management
+- Automated issue tracking
+- Cross-package synchronization
 
 ### Integration Points
-- Claude-code-flow: GitHub command modes in .claude/commands/github/
-- ruv-swarm: GitHub coordination hooks and utilities
+- Monomind CLI: GitHub command modes in .claude/commands/github/
+- Monomind Hooks: GitHub coordination hooks and utilities
 - Documentation: Synchronized CLAUDE.md instructions
 
 ### Testing
@@ -130,14 +132,14 @@ Bash(`gh pr create \
 - [x] Cross-package compatibility
 
 ### Swarm Coordination
-This integration uses ruv-swarm agents for:
+This integration uses Monomind swarm agents for:
 - Multi-agent GitHub workflow management
 - Automated testing and validation
 - Progress tracking and coordination
 - Memory-based state management
 
 ---
-🤖 Generated with Claude Code using ruv-swarm coordination`
+Generated with Claude Code using Monomind swarm coordination`
 }
 ```
 
@@ -154,27 +156,23 @@ This integration uses ruv-swarm agents for:
   mcp__monomind__agent_spawn { type: "tester", name: "Validation Tester" }
   mcp__monomind__agent_spawn { type: "reviewer", name: "Quality Reviewer" }
   
-  // Read current state of both packages
-  Read("/workspaces/ruv-FANN/claude-code-flow/claude-code-flow/package.json")
-  Read("/workspaces/ruv-FANN/ruv-swarm/npm/package.json")
-  Read("/workspaces/ruv-FANN/claude-code-flow/claude-code-flow/CLAUDE.md")
-  Read("/workspaces/ruv-FANN/ruv-swarm/docs/CLAUDE.md")
+  // Read current state of packages
+  Read("package.json")
+  Read("CLAUDE.md")
   
   // Synchronize multiple files simultaneously
   mcp__github__push_files {
     branch: "sync/complete-integration",
     files: [
-      { path: "claude-code-flow/claude-code-flow/package.json", content: "[aligned package.json]" },
-      { path: "claude-code-flow/claude-code-flow/CLAUDE.md", content: "[synchronized CLAUDE.md]" },
-      { path: "claude-code-flow/claude-code-flow/.claude/commands/github/github-modes.md", content: "[GitHub modes]" }
+      { path: "packages/@monomind/cli/package.json", content: "[aligned package.json]" },
+      { path: "packages/@monomind/cli/CLAUDE.md", content: "[synchronized CLAUDE.md]" },
+      { path: ".claude/commands/github/github-modes.md", content: "[GitHub modes]" }
     ],
     message: "feat: Complete package synchronization with GitHub integration"
   }
   
   // Run validation tests
-  Bash("cd /workspaces/ruv-FANN/claude-code-flow/claude-code-flow && npm install")
-  Bash("cd /workspaces/ruv-FANN/claude-code-flow/claude-code-flow && npm test")
-  Bash("cd /workspaces/ruv-FANN/ruv-swarm/npm && npm test")
+  Bash("npm install && npm test")
   
   // Track synchronization progress
   TodoWrite { todos: [
@@ -186,12 +184,10 @@ This integration uses ruv-swarm agents for:
   ]}
   
   // Store comprehensive sync state
-  mcp__monomind__memory_usage {
-    action: "store",
+  mcp__monomind__memory_store {
     key: "sync/complete/status",
     value: {
       timestamp: Date.now(),
-      packages_synced: ["claude-code-flow", "ruv-swarm"],
       version_alignment: "completed",
       documentation_sync: "completed",
       github_integration: "completed",
@@ -222,14 +218,14 @@ const syncStrategy = {
 ```javascript
 // Keep documentation consistent across packages
 const docSyncPattern = {
-  sourceOfTruth: "ruv-swarm/docs/CLAUDE.md",
+  sourceOfTruth: "CLAUDE.md",
   targets: [
-    "claude-code-flow/claude-code-flow/CLAUDE.md",
-    "CLAUDE.md"  // Root level
+    "packages/@monomind/cli/CLAUDE.md",
+    "packages/@monomind/hooks/CLAUDE.md"
   ],
   customSections: {
-    "claude-code-flow": "GitHub Commands Integration",
-    "ruv-swarm": "MCP Tools Reference"
+    "@monomind/cli": "GitHub Commands Integration",
+    "@monomind/hooks": "MCP Tools Reference"
   }
 }
 ```
@@ -238,7 +234,7 @@ const docSyncPattern = {
 ```javascript
 // Comprehensive testing across synchronized packages
 const testMatrix = {
-  packages: ["claude-code-flow", "ruv-swarm"],
+  packages: ["@monomind/cli", "@monomind/hooks"],
   tests: [
     "unit_tests",
     "integration_tests", 

package/.claude/commands/hive-mind/README.md

@@ -1,17 +1,42 @@
-# Hive-mind Commands
-
-Commands for hive-mind operations in Monomind.
-
-## Available Commands
-
-- [hive-mind](./hive-mind.md)
-- [hive-mind-init](./hive-mind-init.md)
-- [hive-mind-spawn](./hive-mind-spawn.md)
-- [hive-mind-status](./hive-mind-status.md)
-- [hive-mind-resume](./hive-mind-resume.md)
-- [hive-mind-stop](./hive-mind-stop.md)
-- [hive-mind-sessions](./hive-mind-sessions.md)
-- [hive-mind-consensus](./hive-mind-consensus.md)
-- [hive-mind-memory](./hive-mind-memory.md)
-- [hive-mind-metrics](./hive-mind-metrics.md)
-- [hive-mind-wizard](./hive-mind-wizard.md)
+---
+name: hive-mind:README
+---
+
+# Hive-Mind Commands
+
+Queen-led consensus-based multi-agent coordination system. All operations use the `mcp__monomind__hive-mind_*` MCP tools.
+
+## Commands (invoke as slash commands)
+
+- [hive-mind](./hive-mind.md) — overview of all subcommands, topologies, and quick start
+- [hive-mind-init](./hive-mind-init.md) — initialize hive with topology and consensus settings
+- [hive-mind-spawn](./hive-mind-spawn.md) — spawn workers; `--claude` launches Claude Code as Queen
+- [hive-mind-status](./hive-mind-status.md) — show hive status, workers, and metrics
+- [hive-mind-stop](./hive-mind-stop.md) — shutdown the hive (the `shutdown` subcommand)
+- [hive-mind-consensus](./hive-mind-consensus.md) — manage proposals and voting
+- [hive-mind-memory](./hive-mind-memory.md) — access hive shared memory
+
+## Real Subcommands (11 total)
+
+```
+init           Initialize hive with topology and consensus
+spawn          Spawn workers; --claude launches Claude Code as Queen
+status         Show status, workers, and metrics
+task           Submit a task for distributed execution
+join           Add an agent to the hive
+leave          Remove an agent from the hive
+consensus      Manage consensus proposals and voting
+broadcast      Broadcast a message to all workers
+memory         Access hive shared memory
+optimize-memory Optimize memory patterns and consolidation
+shutdown       Gracefully shutdown the hive
+```
+
+## Real Tools Used
+
+- `mcp__monomind__hive-mind_init` / `hive-mind_spawn` / `hive-mind_status` — lifecycle
+- `mcp__monomind__hive-mind_task` / `hive-mind_join` / `hive-mind_leave` — task and agent management
+- `mcp__monomind__hive-mind_consensus` / `hive-mind_broadcast` — coordination
+- `mcp__monomind__hive-mind_memory` / `hive-mind_optimize-memory` / `hive-mind_shutdown` — memory and shutdown
+- `mcp__monomind__coordination_orchestrate` — cross-agent task distribution
+- `mcp__monomind__memory_store` / `memory_retrieve` — global persistent memory

package/.claude/commands/hive-mind/hive-mind-consensus.md

@@ -1,8 +1,72 @@
-# hive-mind-consensus
+---
+name: hive-mind:hive-mind-consensus
+---
 
-Command documentation for hive-mind-consensus in category hive-mind.
+# hive-mind consensus
 
-Usage:
+Manage consensus proposals and voting within the hive.
+
+## Usage
 ```bash
-npx monomind hive-mind hive-mind-consensus [options]
+npx monomind hive-mind consensus [options]
+```
+
+## Options
+
+| Flag | Short | Type | Default | Description |
+|---|---|---|---|---|
+| `--action` | `-a` | string | `list` | Action: `propose`, `vote`, `status`, `list` |
+| `--proposal-id` | `-p` | string | — | Proposal ID (required for `vote` and `status`) |
+| `--type` | `-t` | string | — | Proposal type (used with `propose`) |
+| `--value` | — | string | — | Proposal value (used with `propose`) |
+| `--vote` | `-v` | string | — | Vote to cast: `yes` or `no` (used with `vote`) |
+| `--voter-id` | — | string | — | Voter agent ID (used with `vote`) |
+| `--format` | — | string | — | Output format: `json` |
+
+## Examples
+
+```bash
+# List all pending proposals
+npx monomind hive-mind consensus
+
+# Create a new proposal
+npx monomind hive-mind consensus -a propose -t config-change --value '{"maxAgents":20}'
+
+# Vote on a proposal
+npx monomind hive-mind consensus -a vote -p proposal-abc123 -v yes --voter-id agent-1
+
+# Check proposal status
+npx monomind hive-mind consensus -a status -p proposal-abc123
+
+# List pending proposals as JSON
+npx monomind hive-mind consensus -a list --format json
+```
+
+## Actions
+
+- **`list`** — Show all pending proposals (default)
+- **`propose`** — Create a new consensus proposal (requires `--type` and `--value`)
+- **`vote`** — Cast a vote on a proposal (requires `--proposal-id`, `--vote`, and `--voter-id`)
+- **`status`** — Check the current vote tally for a proposal (requires `--proposal-id`)
+
+## MCP Tool
+
+```javascript
+// List proposals
+mcp__monomind__hive-mind_consensus({ action: "list" })
+
+// Create proposal
+mcp__monomind__hive-mind_consensus({
+  action: "propose",
+  type: "config-change",
+  value: '{"maxAgents":20}'
+})
+
+// Vote
+mcp__monomind__hive-mind_consensus({
+  action: "vote",
+  proposalId: "proposal-abc123",
+  vote: true,
+  voterId: "agent-1"
+})
 ```

package/.claude/commands/hive-mind/hive-mind-init.md

@@ -1,6 +1,10 @@
-# hive-mind-init
+---
+name: hive-mind:hive-mind-init
+---
 
-Initialize the Hive Mind collective intelligence system.
+# hive-mind init
+
+Initialize a hive mind with topology and consensus settings.
 
 ## Usage
 ```bash
@@ -8,11 +12,57 @@ npx monomind hive-mind init [options]
 ```
 
 ## Options
-- `--force` - Force reinitialize
-- `--config <file>` - Configuration file
+
+| Flag | Short | Type | Default | Description |
+|---|---|---|---|---|
+| `--topology` | `-t` | string | `hierarchical-mesh` | Hive topology: `hierarchical`, `mesh`, `hierarchical-mesh`, `adaptive` |
+| `--consensus` | `-c` | string | `byzantine` | Consensus strategy: `byzantine`, `raft`, `gossip`, `crdt`, `quorum` |
+| `--max-agents` | `-m` | number | `15` | Maximum number of agents |
+| `--persist` | `-p` | boolean | `true` | Enable persistent state across sessions |
+| `--memory-backend` | — | string | `hybrid` | Memory backend: `agentdb`, `sqlite`, `hybrid` |
 
 ## Examples
+
 ```bash
+# Initialize with recommended settings (interactive topology/consensus selection)
 npx monomind hive-mind init
-npx monomind hive-mind init --force
+
+# Initialize hierarchical-mesh with Byzantine consensus
+npx monomind hive-mind init -t hierarchical-mesh -c byzantine
+
+# Large hive with 20 agents and CRDT consensus
+npx monomind hive-mind init -t mesh -c crdt -m 20
+
+# Minimal hive with no persistence
+npx monomind hive-mind init -t hierarchical -c raft --persist false
+
+# Output as JSON
+npx monomind hive-mind init -t hierarchical-mesh --format json
+```
+
+## Topology Guide
+
+- **`hierarchical`** — Queen controls workers directly. Best for small teams (< 8 agents). Prevents drift.
+- **`mesh`** — Fully connected peers. Best when all agents are equals.
+- **`hierarchical-mesh`** — Queen + peer communication. Recommended for 10+ agents. Most resilient.
+- **`adaptive`** — Dynamically adjusts topology based on current load and task type.
+
+## Consensus Guide
+
+- **`byzantine`** — Tolerates up to 1/3 faulty or malicious agents. Most robust. Default.
+- **`raft`** — Leader-based. Tolerates up to 1/2 failures. Faster than byzantine.
+- **`gossip`** — Epidemic propagation. Eventually consistent. Best for very large swarms.
+- **`crdt`** — Conflict-free. No coordination overhead. Best for parallel writes.
+- **`quorum`** — Simple majority. Configurable threshold.
+
+## MCP Tool
+
+```javascript
+mcp__monomind__hive-mind_init({
+  topology: "hierarchical-mesh",
+  consensus: "byzantine",
+  maxAgents: 15,
+  persist: true,
+  memoryBackend: "hybrid"
+})
 ```