π The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
TypeScript agentic-aiagentic-frameworkagentic-workflowagentsai-agentsai-assistantai-skillsautonomous-agentsclaudecodexdsh-pluginharnessmcp-servermulti-agentmulti-agent-systemsnpmskillsswarmswarm-intelligencetypescript
chore: revert to alpha.118 release with sublinear removal
rUv54081fe4e3ea
diff --git a/.claude-flow/metrics/performance.json b/.claude-flow/metrics/performance.jsonindex a61dd9e04e..4dbe3192e7 100644--- a/.claude-flow/metrics/performance.json+++ b/.claude-flow/metrics/performance.json@@ -1,5 +1,5 @@{- "startTime": 1758729081065,+ "startTime": 1758729778432,"totalTasks": 1,"successfulTasks": 1,"failedTasks": 0,diff --git a/.claude-flow/metrics/system-metrics.json b/.claude-flow/metrics/system-metrics.jsonindex b1dafbc946..1341cf46a1 100644--- a/.claude-flow/metrics/system-metrics.json+++ b/.claude-flow/metrics/system-metrics.json@@ -466,5 +466,293 @@"cpuLoad": 0.09875,"platform": "linux","uptime": 37779.28+ },+ {+ "timestamp": 1758729088895,+ "memoryTotal": 67427545088,+ "memoryUsed": 9350144000,+ "memoryFree": 58077401088,+ "memoryUsagePercent": 13.866950054012916,+ "memoryEfficiency": 86.13304994598708,+ "cpuCount": 16,+ "cpuLoad": 0.085,+ "platform": "linux",+ "uptime": 37809.28+ },+ {+ "timestamp": 1758729118925,+ "memoryTotal": 67427545088,+ "memoryUsed": 9392656384,+ "memoryFree": 58034888704,+ "memoryUsagePercent": 13.929999040809808,+ "memoryEfficiency": 86.0700009591902,+ "cpuCount": 16,+ "cpuLoad": 0.095625,+ "platform": "linux",+ "uptime": 37839.31+ },+ {+ "timestamp": 1758729148954,+ "memoryTotal": 67427545088,+ "memoryUsed": 9309093888,+ "memoryFree": 58118451200,+ "memoryUsagePercent": 13.806069723954295,+ "memoryEfficiency": 86.1939302760457,+ "cpuCount": 16,+ "cpuLoad": 0.099375,+ "platform": "linux",+ "uptime": 37869.34+ },+ {+ "timestamp": 1758729178985,+ "memoryTotal": 67427545088,+ "memoryUsed": 9314066432,+ "memoryFree": 58113478656,+ "memoryUsagePercent": 13.813444371798155,+ "memoryEfficiency": 86.18655562820184,+ "cpuCount": 16,+ "cpuLoad": 0.12,+ "platform": "linux",+ "uptime": 37899.37+ },+ {+ "timestamp": 1758729209016,+ "memoryTotal": 67427545088,+ "memoryUsed": 9531478016,+ "memoryFree": 57896067072,+ "memoryUsagePercent": 14.135881713564425,+ "memoryEfficiency": 85.86411828643557,+ "cpuCount": 16,+ "cpuLoad": 0.093125,+ "platform": "linux",+ "uptime": 37929.41+ },+ {+ "timestamp": 1758729239035,+ "memoryTotal": 67427545088,+ "memoryUsed": 9353138176,+ "memoryFree": 58074406912,+ "memoryUsagePercent": 13.871390636857944,+ "memoryEfficiency": 86.12860936314206,+ "cpuCount": 16,+ "cpuLoad": 0.079375,+ "platform": "linux",+ "uptime": 37959.42+ },+ {+ "timestamp": 1758729269066,+ "memoryTotal": 67427545088,+ "memoryUsed": 9380093952,+ "memoryFree": 58047451136,+ "memoryUsagePercent": 13.911368031800647,+ "memoryEfficiency": 86.08863196819935,+ "cpuCount": 16,+ "cpuLoad": 0.083125,+ "platform": "linux",+ "uptime": 37989.46+ },+ {+ "timestamp": 1758729299096,+ "memoryTotal": 67427545088,+ "memoryUsed": 9476898816,+ "memoryFree": 57950646272,+ "memoryUsagePercent": 14.054936752675268,+ "memoryEfficiency": 85.94506324732473,+ "cpuCount": 16,+ "cpuLoad": 0.0875,+ "platform": "linux",+ "uptime": 38019.49+ },+ {+ "timestamp": 1758729329126,+ "memoryTotal": 67427545088,+ "memoryUsed": 9360125952,+ "memoryFree": 58067419136,+ "memoryUsagePercent": 13.88175402171925,+ "memoryEfficiency": 86.11824597828075,+ "cpuCount": 16,+ "cpuLoad": 0.0675,+ "platform": "linux",+ "uptime": 38049.52+ },+ {+ "timestamp": 1758729359157,+ "memoryTotal": 67427545088,+ "memoryUsed": 9456672768,+ "memoryFree": 57970872320,+ "memoryUsagePercent": 14.024940038463587,+ "memoryEfficiency": 85.97505996153642,+ "cpuCount": 16,+ "cpuLoad": 0.068125,+ "platform": "linux",+ "uptime": 38079.55+ },+ {+ "timestamp": 1758729389187,+ "memoryTotal": 67427545088,+ "memoryUsed": 9606746112,+ "memoryFree": 57820798976,+ "memoryUsagePercent": 14.24750982623228,+ "memoryEfficiency": 85.75249017376773,+ "cpuCount": 16,+ "cpuLoad": 0.06125,+ "platform": "linux",+ "uptime": 38109.58+ },+ {+ "timestamp": 1758729419218,+ "memoryTotal": 67427545088,+ "memoryUsed": 9219379200,+ "memoryFree": 58208165888,+ "memoryUsagePercent": 13.673016254659348,+ "memoryEfficiency": 86.32698374534066,+ "cpuCount": 16,+ "cpuLoad": 0.04125,+ "platform": "linux",+ "uptime": 38139.61+ },+ {+ "timestamp": 1758729449248,+ "memoryTotal": 67427545088,+ "memoryUsed": 9425985536,+ "memoryFree": 58001559552,+ "memoryUsagePercent": 13.979428620303622,+ "memoryEfficiency": 86.02057137969638,+ "cpuCount": 16,+ "cpuLoad": 0.034375,+ "platform": "linux",+ "uptime": 38169.64+ },+ {+ "timestamp": 1758729479254,+ "memoryTotal": 67427545088,+ "memoryUsed": 9374261248,+ "memoryFree": 58053283840,+ "memoryUsagePercent": 13.902717703522512,+ "memoryEfficiency": 86.09728229647749,+ "cpuCount": 16,+ "cpuLoad": 0.08,+ "platform": "linux",+ "uptime": 38199.64+ },+ {+ "timestamp": 1758729509284,+ "memoryTotal": 67427545088,+ "memoryUsed": 9273810944,+ "memoryFree": 58153734144,+ "memoryUsagePercent": 13.753742527474056,+ "memoryEfficiency": 86.24625747252594,+ "cpuCount": 16,+ "cpuLoad": 0.051875,+ "platform": "linux",+ "uptime": 38229.67+ },+ {+ "timestamp": 1758729539315,+ "memoryTotal": 67427545088,+ "memoryUsed": 9278726144,+ "memoryFree": 58148818944,+ "memoryUsagePercent": 13.76103212995563,+ "memoryEfficiency": 86.23896787004438,+ "cpuCount": 16,+ "cpuLoad": 0.044375,+ "platform": "linux",+ "uptime": 38259.7+ },+ {+ "timestamp": 1758729569345,+ "memoryTotal": 67427545088,+ "memoryUsed": 9681489920,+ "memoryFree": 57746055168,+ "memoryUsagePercent": 14.358360381302097,+ "memoryEfficiency": 85.64163961869791,+ "cpuCount": 16,+ "cpuLoad": 0.065625,+ "platform": "linux",+ "uptime": 38289.73+ },+ {+ "timestamp": 1758729599376,+ "memoryTotal": 67427545088,+ "memoryUsed": 9773809664,+ "memoryFree": 57653735424,+ "memoryUsagePercent": 14.49527733991228,+ "memoryEfficiency": 85.50472266008772,+ "cpuCount": 16,+ "cpuLoad": 0.055625,+ "platform": "linux",+ "uptime": 38319.77+ },+ {+ "timestamp": 1758729629406,+ "memoryTotal": 67427545088,+ "memoryUsed": 9750794240,+ "memoryFree": 57676750848,+ "memoryUsagePercent": 14.461143776292303,+ "memoryEfficiency": 85.5388562237077,+ "cpuCount": 16,+ "cpuLoad": 0.084375,+ "platform": "linux",+ "uptime": 38349.8+ },+ {+ "timestamp": 1758729659429,+ "memoryTotal": 67427545088,+ "memoryUsed": 9925410816,+ "memoryFree": 57502134272,+ "memoryUsagePercent": 14.720112979118994,+ "memoryEfficiency": 85.279887020881,+ "cpuCount": 16,+ "cpuLoad": 0.065,+ "platform": "linux",+ "uptime": 38379.82+ },+ {+ "timestamp": 1758729689441,+ "memoryTotal": 67427545088,+ "memoryUsed": 9698496512,+ "memoryFree": 57729048576,+ "memoryUsagePercent": 14.383582405888346,+ "memoryEfficiency": 85.61641759411165,+ "cpuCount": 16,+ "cpuLoad": 0.065625,+ "platform": "linux",+ "uptime": 38409.83+ },+ {+ "timestamp": 1758729719470,+ "memoryTotal": 67427545088,+ "memoryUsed": 9783840768,+ "memoryFree": 57643704320,+ "memoryUsagePercent": 14.510154203643427,+ "memoryEfficiency": 85.48984579635658,+ "cpuCount": 16,+ "cpuLoad": 0.0775,+ "platform": "linux",+ "uptime": 38439.86+ },+ {+ "timestamp": 1758729749500,+ "memoryTotal": 67427545088,+ "memoryUsed": 9673531392,+ "memoryFree": 57754013696,+ "memoryUsagePercent": 14.34655729995068,+ "memoryEfficiency": 85.65344270004933,+ "cpuCount": 16,+ "cpuLoad": 0.075,+ "platform": "linux",+ "uptime": 38469.89+ },+ {+ "timestamp": 1758729779531,+ "memoryTotal": 67427545088,+ "memoryUsed": 9646624768,+ "memoryFree": 57780920320,+ "memoryUsagePercent": 14.30665280103279,+ "memoryEfficiency": 85.69334719896722,+ "cpuCount": 16,+ "cpuLoad": 0.079375,+ "platform": "linux",+ "uptime": 38499.92}]\ No newline at end of filediff --git a/.claude-flow/metrics/task-metrics.json b/.claude-flow/metrics/task-metrics.jsonindex 3b0b88ab27..f04adbe3a1 100644--- a/.claude-flow/metrics/task-metrics.json+++ b/.claude-flow/metrics/task-metrics.json@@ -1,10 +1,10 @@[{- "id": "cmd-hooks-1758729081172",+ "id": "cmd-hooks-1758729778532","type": "hooks","success": true,- "duration": 8.784733000000017,- "timestamp": 1758729081180,+ "duration": 6.953766000000002,+ "timestamp": 1758729778540,"metadata": {}}]\ No newline at end of filediff --git a/CHANGELOG.md b/CHANGELOG.mdindex aec54d5823..0888a8f4a3 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -5,9 +5,9 @@ All notable changes to this project will be documented in this file.The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).-## [2.0.0] - 2025-09-24+## [2.0.0-alpha.118] - 2025-09-24-> **π STABLE RELEASE**: Claude Flow v2.0.0 is now stable! Removed sublinear-time-solver MCP dependency for cleaner initialization and focused core functionality.+> **π§Ή CLEANUP RELEASE**: Removed sublinear-time-solver MCP dependency for cleaner initialization and focused core functionality.### ποΈ Removed- **Sublinear-time-solver Integration**: Removed sublinear-time-solver MCP server from initializationdiff --git a/CLAUDE.md b/CLAUDE.mdindex 523aeebef5..8e6129143c 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -31,9 +31,9 @@```**MCP tools are ONLY for coordination setup:**-- `mcp__claude-flow__swarm_init` - Initialize coordination topology-- `mcp__claude-flow__agent_spawn` - Define agent types for coordination-- `mcp__claude-flow__task_orchestrate` - Orchestrate high-level workflows+- `mcp__claude-flow@alpha__swarm_init` - Initialize coordination topology+- `mcp__claude-flow@alpha__agent_spawn` - Define agent types for coordination+- `mcp__claude-flow@alpha__task_orchestrate` - Orchestrate high-level workflows### π File Organization Rules@@ -52,15 +52,15 @@ This project uses SPARC (Specification, Pseudocode, Architecture, Refinement, Co## SPARC Commands### Core Commands-- `npx claude-flow sparc modes` - List available modes-- `npx claude-flow sparc run <mode> "<task>"` - Execute specific mode-- `npx claude-flow sparc tdd "<feature>"` - Run complete TDD workflow-- `npx claude-flow sparc info <mode>` - Get mode details+- `npx claude-flow@alpha sparc modes` - List available modes+- `npx claude-flow@alpha sparc run <mode> "<task>"` - Execute specific mode+- `npx claude-flow@alpha sparc tdd "<feature>"` - Run complete TDD workflow+- `npx claude-flow@alpha sparc info <mode>` - Get mode details### Batchtools Commands-- `npx claude-flow sparc batch <modes> "<task>"` - Parallel execution-- `npx claude-flow sparc pipeline "<task>"` - Full pipeline processing-- `npx claude-flow sparc concurrent <mode> "<tasks-file>"` - Multi-task processing+- `npx claude-flow@alpha sparc batch <modes> "<task>"` - Parallel execution+- `npx claude-flow@alpha sparc pipeline "<task>"` - Full pipeline processing+- `npx claude-flow@alpha sparc concurrent <mode> "<tasks-file>"` - Multi-task processing### Build Commands- `npm run build` - Build project@@ -142,7 +142,7 @@ This project uses SPARC (Specification, Pseudocode, Architecture, Refinement, Co```bash# Add MCP servers (Claude Flow required, others optional)-claude mcp add claude-flow npx claude-flow@alpha mcp start+claude mcp add claude-flow@alpha npx claude-flow@alpha mcp startclaude mcp add ruv-swarm npx ruv-swarm mcp start # Optional: Enhanced coordinationclaude mcp add flow-nexus npx flow-nexus@latest mcp start # Optional: Cloud features```@@ -240,10 +240,10 @@ npx claude-flow@alpha hooks session-end --export-metrics true```javascript// Step 1: MCP tools set up coordination (optional, for complex tasks)[Single Message - Coordination Setup]:- mcp__claude-flow__swarm_init { topology: "mesh", maxAgents: 6 }- mcp__claude-flow__agent_spawn { type: "researcher" }- mcp__claude-flow__agent_spawn { type: "coder" }- mcp__claude-flow__agent_spawn { type: "tester" }+ mcp__claude-flow@alpha__swarm_init { topology: "mesh", maxAgents: 6 }+ mcp__claude-flow@alpha__agent_spawn { type: "researcher" }+ mcp__claude-flow@alpha__agent_spawn { type: "coder" }+ mcp__claude-flow@alpha__agent_spawn { type: "tester" }// Step 2: Claude Code Task tool spawns ACTUAL agents that do the work[Single Message - Parallel Agent Execution]:@@ -276,7 +276,7 @@ npx claude-flow@alpha hooks session-end --export-metrics true### β WRONG (Multiple Messages):```javascript-Message 1: mcp__claude-flow__swarm_init+Message 1: mcp__claude-flow@alpha__swarm_initMessage 2: Task("agent 1")Message 3: TodoWrite { todos: [single todo] }Message 4: Write "file.js"@@ -336,8 +336,8 @@ Message 4: Write "file.js"## Support-- Documentation: https://github.com/ruvnet/claude-flow-- Issues: https://github.com/ruvnet/claude-flow/issues+- Documentation: https://github.com/ruvnet/claude-flow@alpha+- Issues: https://github.com/ruvnet/claude-flow@alpha/issues- Flow-Nexus Platform: https://flow-nexus.ruv.io (registration required for cloud features)---diff --git a/bin/claude-flow b/bin/claude-flowindex a08c4feb4b..260cc77c1f 100755--- a/bin/claude-flow+++ b/bin/claude-flow@@ -1,7 +1,7 @@#!/bin/sh# Claude-Flow Smart Dispatcher - Detects and uses the best available runtime-VERSION="2.0.0"+VERSION="2.0.0-alpha.118"# Determine the correct path based on how the script is invokedif [ -L "$0" ]; thendiff --git a/bin/init/claude-commands/sparc-commands.js b/bin/init/claude-commands/sparc-commands.jsindex 1806c42038..b48895fc22 100644--- a/bin/init/claude-commands/sparc-commands.js+++ b/bin/init/claude-commands/sparc-commands.js@@ -41,7 +41,7 @@ ${### Option 1: Using MCP Tools (Preferred in Claude Code)\`\`\`javascript-mcp__claude-flow__sparc_mode {+mcp__claude-flow@alpha__sparc_mode {mode: "${mode.slug}",task_description: "${getExampleTask(mode.slug)}",options: {@@ -54,22 +54,22 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)\`\`\`bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run ${mode.slug} "${getExampleTask(mode.slug)}"+npx claude-flow@alpha sparc run ${mode.slug} "${getExampleTask(mode.slug)}"# For alpha featuresnpx claude-flow@alpha sparc run ${mode.slug} "${getExampleTask(mode.slug)}"# With namespace-npx claude-flow sparc run ${mode.slug} "your task" --namespace ${mode.slug}+npx claude-flow@alpha sparc run ${mode.slug} "your task" --namespace ${mode.slug}# Non-interactive mode-npx claude-flow sparc run ${mode.slug} "your task" --non-interactive+npx claude-flow@alpha sparc run ${mode.slug} "your task" --non-interactive\`\`\`### Option 3: Local Installation\`\`\`bash-# If claude-flow is installed locally-./claude-flow sparc run ${mode.slug} "${getExampleTask(mode.slug)}"+# If claude-flow@alpha is installed locally+./claude-flow@alpha sparc run ${mode.slug} "${getExampleTask(mode.slug)}"\`\`\`## Memory Integration@@ -77,7 +77,7 @@ npx claude-flow sparc run ${mode.slug} "your task" --non-interactive### Using MCP Tools (Preferred)\`\`\`javascript// Store mode-specific context-mcp__claude-flow__memory_usage {+mcp__claude-flow@alpha__memory_usage {action: "store",key: "${mode.slug}_context",value: "important decisions",@@ -85,7 +85,7 @@ mcp__claude-flow__memory_usage {}// Query previous work-mcp__claude-flow__memory_search {+mcp__claude-flow@alpha__memory_search {pattern: "${mode.slug}",namespace: "${mode.slug}",limit: 5@@ -95,10 +95,10 @@ mcp__claude-flow__memory_search {### Using NPX CLI (Fallback)\`\`\`bash# Store mode-specific context-npx claude-flow memory store "${mode.slug}_context" "important decisions" --namespace ${mode.slug}+npx claude-flow@alpha memory store "${mode.slug}_context" "important decisions" --namespace ${mode.slug}# Query previous work-npx claude-flow memory query "${mode.slug}" --limit 5+npx claude-flow@alpha memory query "${mode.slug}" --limit 5\`\`\``;}@@ -172,19 +172,19 @@ ${modeList}### Option 1: Using MCP Tools (Preferred in Claude Code)\`\`\`javascript// Run SPARC orchestrator (default)-mcp__claude-flow__sparc_mode {+mcp__claude-flow@alpha__sparc_mode {mode: "sparc",task_description: "build complete authentication system"}// Run a specific mode-mcp__claude-flow__sparc_mode {+mcp__claude-flow@alpha__sparc_mode {mode: "architect",task_description: "design API structure"}// TDD workflow-mcp__claude-flow__sparc_mode {+mcp__claude-flow@alpha__sparc_mode {mode: "tdd",task_description: "implement user authentication",options: {workflow: "full"}@@ -194,17 +194,17 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)\`\`\`bash# Run SPARC orchestrator (default)-npx claude-flow sparc "build complete authentication system"+npx claude-flow@alpha sparc "build complete authentication system"# Run a specific mode-npx claude-flow sparc run architect "design API structure"-npx claude-flow sparc run tdd "implement user service"+npx claude-flow@alpha sparc run architect "design API structure"+npx claude-flow@alpha sparc run tdd "implement user service"# Execute full TDD workflow-npx claude-flow sparc tdd "implement user authentication"+npx claude-flow@alpha sparc tdd "implement user authentication"# List all modes with details-npx claude-flow sparc modes --verbose+npx claude-flow@alpha sparc modes --verbose# For alpha featuresnpx claude-flow@alpha sparc run <mode> "your task"@@ -212,9 +212,9 @@ npx claude-flow@alpha sparc run <mode> "your task"### Option 3: Local Installation\`\`\`bash-# If claude-flow is installed locally-./claude-flow sparc "build complete authentication system"-./claude-flow sparc run architect "design API structure"+# If claude-flow@alpha is installed locally+./claude-flow@alpha sparc "build complete authentication system"+./claude-flow@alpha sparc run architect "design API structure"\`\`\`## SPARC Methodology Phases@@ -230,7 +230,7 @@ npx claude-flow@alpha sparc run <mode> "your task"### Using MCP Tools (Preferred)\`\`\`javascript// Store specifications-mcp__claude-flow__memory_usage {+mcp__claude-flow@alpha__memory_usage {action: "store",key: "spec_auth",value: "OAuth2 + JWT requirements",@@ -238,7 +238,7 @@ mcp__claude-flow__memory_usage {}// Store architectural decisions-mcp__claude-flow__memory_usage {+mcp__claude-flow@alpha__memory_usage {action: "store",key: "arch_decisions",value: "Microservices with API Gateway",@@ -249,16 +249,16 @@ mcp__claude-flow__memory_usage {### Using NPX CLI (Fallback)\`\`\`bash# Store specifications-npx claude-flow memory store "spec_auth" "OAuth2 + JWT requirements" --namespace spec+npx claude-flow@alpha memory store "spec_auth" "OAuth2 + JWT requirements" --namespace spec# Store architectural decisions-./claude-flow memory store "arch_api" "RESTful microservices design" --namespace arch+./claude-flow@alpha memory store "arch_api" "RESTful microservices design" --namespace arch# Query previous work-./claude-flow memory query "authentication" --limit 10+./claude-flow@alpha memory query "authentication" --limit 10# Export project memory-./claude-flow memory export sparc-project-backup.json+./claude-flow@alpha memory export sparc-project-backup.json\`\`\`## Advanced Swarm Mode@@ -266,21 +266,21 @@ npx claude-flow memory store "spec_auth" "OAuth2 + JWT requirements" --namespaceFor complex tasks requiring multiple agents with timeout-free execution:\`\`\`bash# Development swarm with monitoring-./claude-flow swarm "Build e-commerce platform" --strategy development --monitor --review+./claude-flow@alpha swarm "Build e-commerce platform" --strategy development --monitor --review# Background optimization swarm-./claude-flow swarm "Optimize system performance" --strategy optimization --background+./claude-flow@alpha swarm "Optimize system performance" --strategy optimization --background# Distributed research swarm-./claude-flow swarm "Analyze market trends" --strategy research --distributed --ui+./claude-flow@alpha swarm "Analyze market trends" --strategy research --distributed --ui\`\`\`## Non-Interactive ModeFor CI/CD integration and automation:\`\`\`bash-./claude-flow sparc run code "implement API" --non-interactive-./claude-flow sparc tdd "user tests" --non-interactive --enable-permissions+./claude-flow@alpha sparc run code "implement API" --non-interactive+./claude-flow@alpha sparc tdd "user tests" --non-interactive --enable-permissions\`\`\`## Best Practices@@ -291,6 +291,6 @@ For CI/CD integration and automation:β **Memory Usage**: Store important decisions and contextβ **Task Completion**: All tasks should end with \`attempt_completion\`-See \`/claude-flow-help\` for all available commands.+See \`/claude-flow@alpha-help\` for all available commands.`;}diff --git a/bin/init/help.js b/bin/init/help.jsindex 3d88b44df1..5afce79906 100644--- a/bin/init/help.js+++ b/bin/init/help.js@@ -3,10 +3,10 @@export function showInitHelp() {console.log('Initialize Claude Code integration files with Claude Flow v2.0.0');console.log();- console.log('Usage: claude-flow init [options]');+ console.log('Usage: claude-flow@alpha init [options]');console.log();console.log('π DEFAULT BEHAVIOR:');- console.log(' claude-flow init Initialize with Claude Flow v2.0.0 enhanced features');+ console.log(' claude-flow@alpha init Initialize with Claude Flow v2.0.0 enhanced features');console.log(' Creates CLAUDE.md & .claude/commands for MCP integration');console.log();console.log('Standard Options:');@@ -45,43 +45,43 @@ export function showInitHelp() {console.log();console.log('Examples:');console.log('π CLAUDE FLOW v2.0.0 (DEFAULT):');- console.log(' claude-flow init # β DEFAULT: Full Claude Flow v2.0.0 setup');- console.log(' claude-flow init --force # Overwrite existing configuration');- console.log(' claude-flow init --dry-run # Preview what will be created');- console.log(' claude-flow init --monitoring # Initialize with token tracking enabled');+ console.log(' claude-flow@alpha init # β DEFAULT: Full Claude Flow v2.0.0 setup');+ console.log(' claude-flow@alpha init --force # Overwrite existing configuration');+ console.log(' claude-flow@alpha init --dry-run # Preview what will be created');+ console.log(' claude-flow@alpha init --monitoring # Initialize with token tracking enabled');console.log();console.log('π STANDARD INITIALIZATION:');- console.log(' npx claude-flow@latest init --sparc --force # β RECOMMENDED: Optimized setup');- console.log(' npx claude-flow@latest init --sparc # Standard SPARC setup');+ console.log(' npx claude-flow@alpha@latest init --sparc --force # β RECOMMENDED: Optimized setup');+ console.log(' npx claude-flow@alpha@latest init --sparc # Standard SPARC setup');console.log(- ' claude-flow init --sparc --force # Optimized setup (existing project)',+ ' claude-flow@alpha init --sparc --force # Optimized setup (existing project)',);- console.log(' claude-flow init --sparc --modes architect,tdd,code # Selective initialization');- console.log(' claude-flow init --dry-run --sparc # Preview initialization');- console.log(' claude-flow init --minimal # Minimal setup');+ console.log(' claude-flow@alpha init --sparc --modes architect,tdd,code # Selective initialization');+ console.log(' claude-flow@alpha init --dry-run --sparc # Preview initialization');+ console.log(' claude-flow@alpha init --minimal # Minimal setup');console.log();console.log('π VERIFICATION & PAIR PROGRAMMING:');- console.log(' claude-flow init --verify # Truth Verification System setup');- console.log(' claude-flow init --pair # Pair Programming mode setup');- console.log(' claude-flow init --verify --pair # Both verification and pairing');+ console.log(' claude-flow@alpha init --verify # Truth Verification System setup');+ console.log(' claude-flow@alpha init --pair # Pair Programming mode setup');+ console.log(' claude-flow@alpha init --verify --pair # Both verification and pairing');console.log(' npx claude-flow@alpha init --verify --pair # Complete verification setup');console.log();console.log('π VALIDATION & ROLLBACK:');- console.log(' claude-flow init --validate # Validate existing setup');- console.log(' claude-flow init --rollback --full # Full system rollback');- console.log(' claude-flow init --rollback --partial --phase sparc-init # Rollback SPARC only');- console.log(' claude-flow init --list-backups # Show available backups');+ console.log(' claude-flow@alpha init --validate # Validate existing setup');+ console.log(' claude-flow@alpha init --rollback --full # Full system rollback');+ console.log(' claude-flow@alpha init --rollback --partial --phase sparc-init # Rollback SPARC only');+ console.log(' claude-flow@alpha init --list-backups # Show available backups');console.log();console.log('What gets created:');console.log(' β’ .claude/settings.json - Claude Code configuration with hooks');console.log(' β’ .claude/settings.local.json - Pre-approved MCP permissions (no prompts!)');console.log(' β’ .mcp.json - Project-scoped MCP server configuration');- console.log(' β’ claude-flow.config.json - Claude Flow features and performance settings');+ console.log(' β’ [email protected] - Claude Flow features and performance settings');console.log(' β’ .claude/commands/ directory with 20+ Claude Code slash commands');console.log(' β’ CLAUDE.md with project instructions (v2.0.0 enhanced by default)');console.log(' β’ memory/ directory for persistent context storage');console.log(' β’ coordination/ directory for agent orchestration');- console.log(' β’ ./claude-flow local executable wrapper');+ console.log(' β’ ./claude-flow@alpha local executable wrapper');console.log(' β’ .gitignore entries for Claude Flow generated files');console.log(' β’ Automatic MCP server setup if Claude Code CLI is installed');console.log(' β’ Pre-configured for TDD, architecture, and code generation');@@ -89,9 +89,9 @@ export function showInitHelp() {console.log('Claude Code Slash Commands Created:');console.log(' β’ /sparc - Execute SPARC methodology workflows');console.log(' β’ /sparc-<mode> - Run specific SPARC modes (17+ modes)');- console.log(' β’ /claude-flow-help - Show all claude-flow commands');- console.log(' β’ /claude-flow-memory - Interact with memory system');- console.log(' β’ /claude-flow-swarm - Coordinate multi-agent swarms');+ console.log(' β’ /claude-flow@alpha-help - Show all claude-flow@alpha commands');+ console.log(' β’ /claude-flow@alpha-memory - Interact with memory system');+ console.log(' β’ /claude-flow@alpha-swarm - Coordinate multi-agent swarms');console.log();console.log('Available SPARC modes:');console.log(' β’ architect - System design and architecture');diff --git a/bin/init/index.js b/bin/init/index.jsindex f99ddc6a79..6f789029de 100644--- a/bin/init/index.js+++ b/bin/init/index.js@@ -101,7 +101,7 @@ async function setupMcpServers(dryRun = false) {const servers = [{- name: 'claude-flow',+ name: 'claude-flow@alpha',command: 'npx claude-flow@alpha mcp start',description: 'Claude Flow MCP server with swarm orchestration (alpha)',},@@ -332,11 +332,11 @@ export async function initCommand(subArgs, flags) {// Memory README files and persistence database are created by template copier- // Create local claude-flow executable wrapper+ // Create local claude-flow@alpha executable wrapperif (!initDryRun) {await createLocalExecutable(workingDir);} else {- console.log(' [DRY RUN] Would create local claude-flow executable wrapper');+ console.log(' [DRY RUN] Would create local claude-flow@alpha executable wrapper');}// SPARC initialization@@ -415,7 +415,7 @@ export async function initCommand(subArgs, flags) {);console.log(' β’ Core files: CLAUDE.md, memory-bank.md, coordination.md');console.log(' β’ Directory structure: memory/, coordination/, .claude/');- console.log(' β’ Local executable: ./claude-flow');+ console.log(' β’ Local executable: ./claude-flow@alpha');if (initSparc) {console.log(` β’ Claude Code slash commands: ${selectedModes ? selectedModes.length : 'All'} SPARC mode commands`,@@ -448,8 +448,8 @@ export async function initCommand(subArgs, flags) {` β coordination.md (${initOptimized ? 'Enhanced with batchtools' : 'Standard coordination'})`,);console.log(' β Directory structure with memory/ and coordination/');- console.log(' β Local executable at ./claude-flow');- console.log(' β Persistence database at memory/claude-flow-data.json');+ console.log(' β Local executable at ./claude-flow@alpha');+ console.log(' β Persistence database at memory/[email protected]');console.log(' β Agent system with 64 specialized agents in .claude/agents/');if (initSparc) {@@ -460,21 +460,21 @@ export async function initCommand(subArgs, flags) {console.log('\nπ Next steps:');console.log('1. Review and customize the generated files for your project');- console.log("2. Run './claude-flow start' to begin the orchestration system");- console.log("3. Use './claude-flow' instead of 'npx claude-flow' for all commands");+ console.log("2. Run './claude-flow@alpha start' to begin the orchestration system");+ console.log("3. Use './claude-flow@alpha' instead of 'npx claude-flow@alpha' for all commands");console.log("4. Use 'claude --dangerously-skip-permissions' for unattended operation");if (initSparc) {console.log('5. Use Claude Code slash commands: /sparc, /sparc-architect, /sparc-tdd, etc.',);- console.log("6. Explore SPARC modes with './claude-flow sparc modes'");- console.log('7. Try TDD workflow with \'./claude-flow sparc tdd "your task"\'');+ console.log("6. Explore SPARC modes with './claude-flow@alpha sparc modes'");+ console.log('7. Try TDD workflow with \'./claude-flow@alpha sparc tdd "your task"\'');if (initOptimized) {console.log('8. Use batchtools commands: /batchtools, /performance for optimization');console.log('9. Enable parallel processing with --parallel flags');- console.log("10. Monitor performance with './claude-flow performance monitor'");+ console.log("10. Monitor performance with './claude-flow@alpha performance monitor'");}}@@ -492,8 +492,8 @@ export async function initCommand(subArgs, flags) {console.log('\nπ‘ Tips:');console.log(" β’ Type '/' in Claude Code to see all available slash commands");- console.log(" β’ Use './claude-flow status' to check system health");- console.log(" β’ Store important context with './claude-flow memory store'");+ console.log(" β’ Use './claude-flow@alpha status' to check system health");+ console.log(" β’ Store important context with './claude-flow@alpha memory store'");if (initOptimized) {console.log(' β’ Use --parallel flags for concurrent operations');@@ -565,7 +565,7 @@ export async function initCommand(subArgs, flags) {console.log('\nβ οΈ Claude Code CLI not detected!');console.log(' π₯ Install with: npm install -g @anthropic-ai/claude-code');console.log(' π Then add MCP servers manually with:');- console.log(' claude mcp add claude-flow npx claude-flow@alpha mcp start');+ console.log(' claude mcp add claude-flow@alpha npx claude-flow@alpha mcp start');console.log(' claude mcp add ruv-swarm npx ruv-swarm mcp start');console.log(' claude mcp add flow-nexus npx flow-nexus@latest mcp start');}@@ -1012,7 +1012,7 @@ async function setupMemorySystem(workingDir, dryRun = false) {if (!dryRun) {const initialData = { agents: [], tasks: [], lastUpdated: Date.now() };await fs.writeFile(- `${workingDir}/memory/claude-flow-data.json`, JSON.stringify(initialData, null, 2), 'utf8'+ `${workingDir}/memory/[email protected]`, JSON.stringify(initialData, null, 2), 'utf8');await fs.writeFile(`${workingDir}/memory/agents/README.md`, createAgentsReadme(), 'utf8');@@ -1035,8 +1035,8 @@ async function setupMonitoring(workingDir) {const path = await import('path');try {- // Create .claude-flow directory for tracking data- const trackingDir = path.join(workingDir, '.claude-flow');+ // Create .claude-flow@alpha directory for tracking data+ const trackingDir = path.join(workingDir, '.claude-flow@alpha');await fs.mkdir(trackingDir, { recursive: true });// Create initial token usage file@@ -1091,7 +1091,7 @@ async function setupMonitoring(workingDir) {sessions: true},storage: {- location: '.claude-flow/token-usage.json',+ location: '.claude-flow@alpha/token-usage.json',format: 'json',rotation: 'monthly'}@@ -1117,9 +1117,9 @@ export CLAUDE_CODE_ENABLE_TELEMETRY=1console.log('\n π To enable Claude Code telemetry:');console.log(' 1. Add to your shell profile: export CLAUDE_CODE_ENABLE_TELEMETRY=1');- console.log(' 2. Or run: source .claude-flow/env-setup.sh');- console.log('\n π‘ Token usage will be tracked in .claude-flow/token-usage.json');- console.log(' Run: claude-flow analysis token-usage --breakdown --cost-analysis');+ console.log(' 2. Or run: source .claude-flow@alpha/env-setup.sh');+ console.log('\n π‘ Token usage will be tracked in .claude-flow@alpha/token-usage.json');+ console.log(' Run: claude-flow@alpha analysis token-usage --breakdown --cost-analysis');} catch (err) {printError(` Failed to setup monitoring: ${err.message}`);@@ -1152,7 +1152,7 @@ async function enhancedClaudeFlowInit(flags, subArgs = []) {'CLAUDE.md','.claude/settings.json','.mcp.json',- 'claude-flow.config.json',+ '[email protected]',];for (const file of filesToCheck) {@@ -1197,7 +1197,7 @@ async function enhancedClaudeFlowInit(flags, subArgs = []) {// Create settings.local.json with default MCP permissionsconst settingsLocal = {permissions: {- allow: ['mcp__ruv-swarm', 'mcp__claude-flow'],+ allow: ['mcp__ruv-swarm', 'mcp__claude-flow@alpha'],deny: [],},};@@ -1216,7 +1216,7 @@ async function enhancedClaudeFlowInit(flags, subArgs = []) {// Create .mcp.json at project root for MCP server configurationconst mcpConfig = {mcpServers: {- 'claude-flow': {+ 'claude-flow@alpha': {command: 'npx',args: ['claude-flow@alpha', 'mcp', 'start'],type: 'stdio',@@ -1236,7 +1236,7 @@ async function enhancedClaudeFlowInit(flags, subArgs = []) {console.log('[DRY RUN] Would create .mcp.json at project root for MCP server configuration');}- // Create claude-flow.config.json for Claude Flow specific settings+ // Create [email protected] for Claude Flow specific settingsconst claudeFlowConfig = {features: {autoTopologySelection: true,@@ -1260,11 +1260,11 @@ async function enhancedClaudeFlowInit(flags, subArgs = []) {if (!dryRun) {await fs.writeFile(- `${workingDir}/claude-flow.config.json`, JSON.stringify(claudeFlowConfig, null, 2, 'utf8'),+ `${workingDir}/[email protected]`, JSON.stringify(claudeFlowConfig, null, 2, 'utf8'),);- printSuccess('β Created claude-flow.config.json for Claude Flow settings');+ printSuccess('β Created [email protected] for Claude Flow settings');} else {- console.log('[DRY RUN] Would create claude-flow.config.json for Claude Flow settings');+ console.log('[DRY RUN] Would create [email protected] for Claude Flow settings');}// Create command documentation@@ -1303,14 +1303,14 @@ ${commands.map((cmd) => `- [${cmd}](./${cmd}.md)`).join('\n')}if (!dryRun) {// Unix wrapper - now uses universal ES module compatible wrapperconst unixWrapper = createWrapperScript('unix');- await fs.writeFile(`${workingDir}/claude-flow`, unixWrapper, 'utf8');- await fs.chmod(`${workingDir}/claude-flow`, 0o755);+ await fs.writeFile(`${workingDir}/claude-flow@alpha`, unixWrapper, 'utf8');+ await fs.chmod(`${workingDir}/claude-flow@alpha`, 0o755);// Windows wrapper- await fs.writeFile(`${workingDir}/claude-flow.bat`, createWrapperScript('windows', 'utf8'));+ await fs.writeFile(`${workingDir}/[email protected]`, createWrapperScript('windows', 'utf8'));// PowerShell wrapper- await fs.writeFile(`${workingDir}/claude-flow.ps1`, createWrapperScript('powershell', 'utf8'));+ await fs.writeFile(`${workingDir}/[email protected]`, createWrapperScript('powershell', 'utf8'));printSuccess('β Created platform-specific wrapper scripts');} else {@@ -1361,7 +1361,7 @@ ${commands.map((cmd) => `- [${cmd}](./${cmd}.md)`).join('\n')}// Initialize memory systemconst initialData = { agents: [], tasks: [], lastUpdated: Date.now() };await fs.writeFile(- `${workingDir}/memory/claude-flow-data.json`, JSON.stringify(initialData, null, 2, 'utf8'),+ `${workingDir}/memory/[email protected]`, JSON.stringify(initialData, null, 2, 'utf8'),);// Create README files@@ -1474,7 +1474,7 @@ ${commands.map((cmd) => `- [${cmd}](./${cmd}.md)`).join('\n')}} else {console.log(' βΉοΈ Skipping MCP setup (--skip-mcp flag used)');console.log('\n π To add MCP servers manually:');- console.log(' claude mcp add claude-flow npx claude-flow@alpha mcp start');+ console.log(' claude mcp add claude-flow@alpha npx claude-flow@alpha mcp start');console.log(' claude mcp add ruv-swarm npx ruv-swarm@latest mcp start');console.log(' claude mcp add flow-nexus npx flow-nexus@latest mcp start');console.log('\n π‘ MCP servers are defined in .mcp.json (project scope)');@@ -1484,7 +1484,7 @@ ${commands.map((cmd) => `- [${cmd}](./${cmd}.md)`).join('\n')}console.log('\n π₯ To install Claude Code:');console.log(' npm install -g @anthropic-ai/claude-code');console.log('\n π After installing, add MCP servers:');- console.log(' claude mcp add claude-flow npx claude-flow@alpha mcp start');+ console.log(' claude mcp add claude-flow@alpha npx claude-flow@alpha mcp start');console.log(' claude mcp add ruv-swarm npx ruv-swarm@latest mcp start');console.log(' claude mcp add flow-nexus npx flow-nexus@latest mcp start');console.log('\n π‘ MCP servers are defined in .mcp.json (project scope)');diff --git a/bin/init/templates/CLAUDE.md b/bin/init/templates/CLAUDE.mdindex 6d14b93b9d..d33e2f7db3 100644--- a/bin/init/templates/CLAUDE.md+++ b/bin/init/templates/CLAUDE.md@@ -61,15 +61,15 @@ This project uses the SPARC (Specification, Pseudocode, Architecture, Refinement## SPARC Development Commands### Core SPARC Commands-- `npx claude-flow sparc modes`: List all available SPARC development modes-- `npx claude-flow sparc run <mode> "<task>"`: Execute specific SPARC mode for a task-- `npx claude-flow sparc tdd "<feature>"`: Run complete TDD workflow using SPARC methodology-- `npx claude-flow sparc info <mode>`: Get detailed information about a specific mode+- `npx claude-flow@alpha sparc modes`: List all available SPARC development modes+- `npx claude-flow@alpha sparc run <mode> "<task>"`: Execute specific SPARC mode for a task+- `npx claude-flow@alpha sparc tdd "<feature>"`: Run complete TDD workflow using SPARC methodology+- `npx claude-flow@alpha sparc info <mode>`: Get detailed information about a specific mode### Batchtools Commands (Optimized)-- `npx claude-flow sparc batch <modes> "<task>"`: Execute multiple SPARC modes in parallel-- `npx claude-flow sparc pipeline "<task>"`: Execute full SPARC pipeline with parallel processing-- `npx claude-flow sparc concurrent <mode> "<tasks-file>"`: Process multiple tasks concurrently+- `npx claude-flow@alpha sparc batch <modes> "<task>"`: Execute multiple SPARC modes in parallel+- `npx claude-flow@alpha sparc pipeline "<task>"`: Execute full SPARC pipeline with parallel processing+- `npx claude-flow@alpha sparc concurrent <mode> "<tasks-file>"`: Process multiple tasks concurrently### Standard Build Commands- `npm run build`: Build the project@@ -82,35 +82,35 @@ This project uses the SPARC (Specification, Pseudocode, Architecture, Refinement### 1. Specification Phase (Parallel Analysis)```bash# Create detailed specifications with concurrent requirements analysis-npx claude-flow sparc run spec-pseudocode "Define user authentication requirements" --parallel+npx claude-flow@alpha sparc run spec-pseudocode "Define user authentication requirements" --parallel```**Batchtools Optimization**: Simultaneously analyze multiple requirement sources, validate constraints in parallel, and generate comprehensive specifications.### 2. Pseudocode Phase (Concurrent Logic Design)```bash# Develop algorithmic logic with parallel pattern analysis-npx claude-flow sparc run spec-pseudocode "Create authentication flow pseudocode" --batch-optimize+npx claude-flow@alpha sparc run spec-pseudocode "Create authentication flow pseudocode" --batch-optimize```**Batchtools Optimization**: Process multiple algorithm patterns concurrently, validate logic flows in parallel, and optimize data structures simultaneously.### 3. Architecture Phase (Parallel Component Design)```bash# Design system architecture with concurrent component analysis-npx claude-flow sparc run architect "Design authentication service architecture" --parallel+npx claude-flow@alpha sparc run architect "Design authentication service architecture" --parallel```**Batchtools Optimization**: Generate multiple architectural alternatives simultaneously, validate integration points in parallel, and create comprehensive documentation concurrently.### 4. Refinement Phase (Parallel TDD Implementation)```bash# Execute Test-Driven Development with parallel test generation-npx claude-flow sparc tdd "implement user authentication system" --batch-tdd+npx claude-flow@alpha sparc tdd "implement user authentication system" --batch-tdd```**Batchtools Optimization**: Generate multiple test scenarios simultaneously, implement and validate code in parallel, and optimize performance concurrently.### 5. Completion Phase (Concurrent Integration)```bash# Integration with parallel validation and documentation-npx claude-flow sparc run integration "integrate authentication with user management" --parallel+npx claude-flow@alpha sparc run integration "integrate authentication with user management" --parallel```**Batchtools Optimization**: Run integration tests in parallel, generate documentation concurrently, and validate requirements simultaneously.@@ -402,17 +402,17 @@ If ANY answer is "No", you MUST combine operations into a single message!**β CORRECT Workflow:**-1. **MCP**: `mcp__claude-flow__swarm_init` (coordination setup)-2. **MCP**: `mcp__claude-flow__agent_spawn` (planning agents)-3. **MCP**: `mcp__claude-flow__task_orchestrate` (task coordination)+1. **MCP**: `mcp__claude-flow@alpha__swarm_init` (coordination setup)+2. **MCP**: `mcp__claude-flow@alpha__agent_spawn` (planning agents)+3. **MCP**: `mcp__claude-flow@alpha__task_orchestrate` (task coordination)4. **Claude Code**: `Task` tool to spawn agents with coordination instructions5. **Claude Code**: `TodoWrite` with ALL todos batched (5-10+ in ONE call)6. **Claude Code**: `Read`, `Write`, `Edit`, `Bash` (actual work)-7. **MCP**: `mcp__claude-flow__memory_usage` (store results)+7. **MCP**: `mcp__claude-flow@alpha__memory_usage` (store results)**β WRONG Workflow:**-1. **MCP**: `mcp__claude-flow__terminal_execute` (DON'T DO THIS)+1. **MCP**: `mcp__claude-flow@alpha__terminal_execute` (DON'T DO THIS)2. **MCP**: File creation via MCP (DON'T DO THIS)3. **MCP**: Code generation via MCP (DON'T DO THIS)4. **Claude Code**: Sequential Task calls (DON'T DO THIS)@@ -455,12 +455,12 @@ If you need to do X operations, they should be in 1 message, not X messages```javascript[Single Message with BatchTool]:// MCP coordination setup- mcp__claude-flow__swarm_init { topology: "mesh", maxAgents: 6 }- mcp__claude-flow__agent_spawn { type: "researcher" }- mcp__claude-flow__agent_spawn { type: "coder" }- mcp__claude-flow__agent_spawn { type: "code-analyzer" }- mcp__claude-flow__agent_spawn { type: "tester" }- mcp__claude-flow__agent_spawn { type: "task-orchestrator" }+ mcp__claude-flow@alpha__swarm_init { topology: "mesh", maxAgents: 6 }+ mcp__claude-flow@alpha__agent_spawn { type: "researcher" }+ mcp__claude-flow@alpha__agent_spawn { type: "coder" }+ mcp__claude-flow@alpha__agent_spawn { type: "code-analyzer" }+ mcp__claude-flow@alpha__agent_spawn { type: "tester" }+ mcp__claude-flow@alpha__agent_spawn { type: "task-orchestrator" }// Claude Code execution - ALL in parallelTask("You are researcher agent. MUST coordinate via hooks...")@@ -479,7 +479,7 @@ If you need to do X operations, they should be in 1 message, not X messages**β WRONG - Multiple Messages (NEVER DO THIS):**```javascript-Message 1: mcp__claude-flow__swarm_init+Message 1: mcp__claude-flow@alpha__swarm_initMessage 2: Task("researcher agent")Message 3: Task("coder agent")Message 4: TodoWrite({ todo: "single todo" })@@ -522,7 +522,7 @@ Message 6: Write "package.json"```bash# Add Claude Flow MCP server to Claude Code using stdio-claude mcp add claude-flow npx claude-flow@alpha mcp start+claude mcp add claude-flow@alpha npx claude-flow@alpha mcp start```### 2. Use MCP Tools for Coordination in Claude Code@@ -531,19 +531,19 @@ Once configured, Claude Flow MCP tools enhance Claude Code's coordination:**Initialize a swarm:**-- Use the `mcp__claude-flow__swarm_init` tool to set up coordination topology+- Use the `mcp__claude-flow@alpha__swarm_init` tool to set up coordination topology- Choose: mesh, hierarchical, ring, or star- This creates a coordination framework for Claude Code's work**Spawn agents:**-- Use `mcp__claude-flow__agent_spawn` tool to create specialized coordinators+- Use `mcp__claude-flow@alpha__agent_spawn` tool to create specialized coordinators- Agent types represent different thinking patterns, not actual coders- They help Claude Code approach problems from different angles**Orchestrate tasks:**-- Use `mcp__claude-flow__task_orchestrate` tool to coordinate complex workflows+- Use `mcp__claude-flow@alpha__task_orchestrate` tool to coordinate complex workflows- This breaks down tasks for Claude Code to execute systematically- The agents don't write code - they coordinate Claude Code's actions@@ -551,38 +551,38 @@ Once configured, Claude Flow MCP tools enhance Claude Code's coordination:### Coordination Tools:-- `mcp__claude-flow__swarm_init` - Set up coordination topology for Claude Code-- `mcp__claude-flow__agent_spawn` - Create cognitive patterns to guide Claude Code-- `mcp__claude-flow__task_orchestrate` - Break down and coordinate complex tasks+- `mcp__claude-flow@alpha__swarm_init` - Set up coordination topology for Claude Code+- `mcp__claude-flow@alpha__agent_spawn` - Create cognitive patterns to guide Claude Code+- `mcp__claude-flow@alpha__task_orchestrate` - Break down and coordinate complex tasks### Monitoring Tools:-- `mcp__claude-flow__swarm_status` - Monitor coordination effectiveness-- `mcp__claude-flow__agent_list` - View active cognitive patterns-- `mcp__claude-flow__agent_metrics` - Track coordination performance-- `mcp__claude-flow__task_status` - Check workflow progress-- `mcp__claude-flow__task_results` - Review coordination outcomes+- `mcp__claude-flow@alpha__swarm_status` - Monitor coordination effectiveness+- `mcp__claude-flow@alpha__agent_list` - View active cognitive patterns+- `mcp__claude-flow@alpha__agent_metrics` - Track coordination performance+- `mcp__claude-flow@alpha__task_status` - Check workflow progress+- `mcp__claude-flow@alpha__task_results` - Review coordination outcomes### Memory & Neural Tools:-- `mcp__claude-flow__memory_usage` - Persistent memory across sessions-- `mcp__claude-flow__neural_status` - Neural pattern effectiveness-- `mcp__claude-flow__neural_train` - Improve coordination patterns-- `mcp__claude-flow__neural_patterns` - Analyze thinking approaches+- `mcp__claude-flow@alpha__memory_usage` - Persistent memory across sessions+- `mcp__claude-flow@alpha__neural_status` - Neural pattern effectiveness+- `mcp__claude-flow@alpha__neural_train` - Improve coordination patterns+- `mcp__claude-flow@alpha__neural_patterns` - Analyze thinking approaches### GitHub Integration Tools (NEW!):-- `mcp__claude-flow__github_swarm` - Create specialized GitHub management swarms-- `mcp__claude-flow__repo_analyze` - Deep repository analysis with AI-- `mcp__claude-flow__pr_enhance` - AI-powered pull request improvements-- `mcp__claude-flow__issue_triage` - Intelligent issue classification-- `mcp__claude-flow__code_review` - Automated code review with swarms+- `mcp__claude-flow@alpha__github_swarm` - Create specialized GitHub management swarms+- `mcp__claude-flow@alpha__repo_analyze` - Deep repository analysis with AI+- `mcp__claude-flow@alpha__pr_enhance` - AI-powered pull request improvements+- `mcp__claude-flow@alpha__issue_triage` - Intelligent issue classification+- `mcp__claude-flow@alpha__code_review` - Automated code review with swarms### System Tools:-- `mcp__claude-flow__benchmark_run` - Measure coordination efficiency-- `mcp__claude-flow__features_detect` - Available capabilities-- `mcp__claude-flow__swarm_monitor` - Real-time coordination tracking+- `mcp__claude-flow@alpha__benchmark_run` - Measure coordination efficiency+- `mcp__claude-flow@alpha__features_detect` - Available capabilities+- `mcp__claude-flow@alpha__swarm_monitor` - Real-time coordination tracking## Workflow Examples (Coordination-Focused)@@ -592,21 +592,21 @@ Once configured, Claude Flow MCP tools enhance Claude Code's coordination:**Step 1:** Set up research coordination-- Tool: `mcp__claude-flow__swarm_init`+- Tool: `mcp__claude-flow@alpha__swarm_init`- Parameters: `{"topology": "mesh", "maxAgents": 5, "strategy": "balanced"}`- Result: Creates a mesh topology for comprehensive exploration**Step 2:** Define research perspectives-- Tool: `mcp__claude-flow__agent_spawn`+- Tool: `mcp__claude-flow@alpha__agent_spawn`- Parameters: `{"type": "researcher", "name": "Literature Review"}`-- Tool: `mcp__claude-flow__agent_spawn`+- Tool: `mcp__claude-flow@alpha__agent_spawn`- Parameters: `{"type": "code-analyzer", "name": "Data Analysis"}`- Result: Different cognitive patterns for Claude Code to use**Step 3:** Coordinate research execution-- Tool: `mcp__claude-flow__task_orchestrate`+- Tool: `mcp__claude-flow@alpha__task_orchestrate`- Parameters: `{"task": "Research neural architecture search papers", "strategy": "adaptive"}`- Result: Claude Code systematically searches, reads, and analyzes papers@@ -627,19 +627,19 @@ Once configured, Claude Flow MCP tools enhance Claude Code's coordination:**Step 1:** Set up development coordination-- Tool: `mcp__claude-flow__swarm_init`+- Tool: `mcp__claude-flow@alpha__swarm_init`- Parameters: `{"topology": "hierarchical", "maxAgents": 8, "strategy": "specialized"}`- Result: Hierarchical structure for organized development**Step 2:** Define development perspectives-- Tool: `mcp__claude-flow__agent_spawn`+- Tool: `mcp__claude-flow@alpha__agent_spawn`- Parameters: `{"type": "system-architect", "name": "System Design"}`- Result: Architectural thinking pattern for Claude Code**Step 3:** Coordinate implementation-- Tool: `mcp__claude-flow__task_orchestrate`+- Tool: `mcp__claude-flow@alpha__task_orchestrate`- Parameters: `{"task": "Implement user authentication with JWT", "strategy": "parallel"}`- Result: Claude Code implements features using its native tools@@ -660,19 +660,19 @@ Once configured, Claude Flow MCP tools enhance Claude Code's coordination:**Step 1:** Initialize GitHub swarm-- Tool: `mcp__claude-flow__github_swarm`+- Tool: `mcp__claude-flow@alpha__github_swarm`- Parameters: `{"repository": "owner/repo", "agents": 5, "focus": "maintenance"}`- Result: Specialized swarm for repository management**Step 2:** Analyze repository health-- Tool: `mcp__claude-flow__repo_analyze`+- Tool: `mcp__claude-flow@alpha__repo_analyze`- Parameters: `{"deep": true, "include": ["issues", "prs", "code"]}`- Result: Comprehensive repository analysis**Step 3:** Enhance pull requests-- Tool: `mcp__claude-flow__pr_enhance`+- Tool: `mcp__claude-flow@alpha__pr_enhance`- Parameters: `{"pr_number": 123, "add_tests": true, "improve_docs": true}`- Result: AI-powered PR improvements@@ -790,7 +790,7 @@ See `.claude/commands/` for detailed documentation on all features.1. **SPAWN ALL AGENTS IN ONE BATCH** - Use multiple tool calls in a SINGLE message2. **EXECUTE TASKS IN PARALLEL** - Never wait for one task before starting another3. **USE BATCHTOOL FOR EVERYTHING** - Multiple operations = Single message with multiple tools-4. **ALL AGENTS MUST USE COORDINATION TOOLS** - Every spawned agent MUST use claude-flow hooks and memory+4. **ALL AGENTS MUST USE COORDINATION TOOLS** - Every spawned agent MUST use claude-flow@alpha hooks and memory### π― AGENT COUNT CONFIGURATION@@ -893,12 +893,12 @@ Message 6: TodoWrite (another single todo)```Message 1: [BatchTool]// MCP coordination setup- - mcp__claude-flow__swarm_init- - mcp__claude-flow__agent_spawn (researcher)- - mcp__claude-flow__agent_spawn (coder)- - mcp__claude-flow__agent_spawn (code-analyzer)- - mcp__claude-flow__agent_spawn (tester)- - mcp__claude-flow__agent_spawn (task-orchestrator)+ - mcp__claude-flow@alpha__swarm_init+ - mcp__claude-flow@alpha__agent_spawn (researcher)+ - mcp__claude-flow@alpha__agent_spawn (coder)+ - mcp__claude-flow@alpha__agent_spawn (code-analyzer)+ - mcp__claude-flow@alpha__agent_spawn (tester)+ - mcp__claude-flow@alpha__agent_spawn (task-orchestrator)Message 2: [BatchTool - Claude Code execution]// Task agents with full coordination instructions@@ -932,7 +932,7 @@ When given ANY complex task with swarms:STEP 1: IMMEDIATE PARALLEL SPAWN (Single Message!)[BatchTool]:// IMPORTANT: Check CLI args for agent count, otherwise auto-decide based on task complexity- - mcp__claude-flow__swarm_init {+ - mcp__claude-flow@alpha__swarm_init {topology: "hierarchical",maxAgents: CLI_ARGS.agents || AUTO_DECIDE(task_complexity), // Use CLI args or auto-decidestrategy: "parallel"@@ -940,19 +940,19 @@ STEP 1: IMMEDIATE PARALLEL SPAWN (Single Message!)// Spawn agents based on maxAgents count and task requirements// If CLI specifies 3 agents, spawn 3. If no args, auto-decide optimal count (3-12)- - mcp__claude-flow__agent_spawn { type: "system-architect", name: "System Designer" }- - mcp__claude-flow__agent_spawn { type: "coder", name: "API Developer" }- - mcp__claude-flow__agent_spawn { type: "coder", name: "Frontend Dev" }- - mcp__claude-flow__agent_spawn { type: "code-analyzer", name: "DB Designer" }- - mcp__claude-flow__agent_spawn { type: "tester", name: "QA Engineer" }- - mcp__claude-flow__agent_spawn { type: "researcher", name: "Tech Lead" }- - mcp__claude-flow__agent_spawn { type: "task-orchestrator", name: "PM" }+ - mcp__claude-flow@alpha__agent_spawn { type: "system-architect", name: "System Designer" }+ - mcp__claude-flow@alpha__agent_spawn { type: "coder", name: "API Developer" }+ - mcp__claude-flow@alpha__agent_spawn { type: "coder", name: "Frontend Dev" }+ - mcp__claude-flow@alpha__agent_spawn { type: "code-analyzer", name: "DB Designer" }+ - mcp__claude-flow@alpha__agent_spawn { type: "tester", name: "QA Engineer" }+ - mcp__claude-flow@alpha__agent_spawn { type: "researcher", name: "Tech Lead" }+ - mcp__claude-flow@alpha__agent_spawn { type: "task-orchestrator", name: "PM" }- TodoWrite { todos: [multiple todos at once] }STEP 2: PARALLEL TASK EXECUTION (Single Message!)[BatchTool]:- - mcp__claude-flow__task_orchestrate { task: "main task", strategy: "parallel" }- - mcp__claude-flow__memory_usage { action: "store", key: "init", value: {...} }+ - mcp__claude-flow@alpha__task_orchestrate { task: "main task", strategy: "parallel" }+ - mcp__claude-flow@alpha__memory_usage { action: "store", key: "init", value: {...} }- Multiple Read operations- Multiple Write operations- Multiple Bash commands@@ -997,13 +997,13 @@ Dependencies: β³ X deps | Actionable: βΆ// β CORRECT: SINGLE MESSAGE with ALL operations[BatchTool - Message 1]:// Initialize and spawn ALL agents at once- mcp__claude-flow__swarm_init { topology: "hierarchical", maxAgents: 8, strategy: "parallel" }- mcp__claude-flow__agent_spawn { type: "system-architect", name: "System Designer" }- mcp__claude-flow__agent_spawn { type: "coder", name: "API Developer" }- mcp__claude-flow__agent_spawn { type: "coder", name: "Auth Expert" }- mcp__claude-flow__agent_spawn { type: "code-analyzer", name: "DB Designer" }- mcp__claude-flow__agent_spawn { type: "tester", name: "Test Engineer" }- mcp__claude-flow__agent_spawn { type: "task-orchestrator", name: "Lead" }+ mcp__claude-flow@alpha__swarm_init { topology: "hierarchical", maxAgents: 8, strategy: "parallel" }+ mcp__claude-flow@alpha__agent_spawn { type: "system-architect", name: "System Designer" }+ mcp__claude-flow@alpha__agent_spawn { type: "coder", name: "API Developer" }+ mcp__claude-flow@alpha__agent_spawn { type: "coder", name: "Auth Expert" }+ mcp__claude-flow@alpha__agent_spawn { type: "code-analyzer", name: "DB Designer" }+ mcp__claude-flow@alpha__agent_spawn { type: "tester", name: "Test Engineer" }+ mcp__claude-flow@alpha__agent_spawn { type: "task-orchestrator", name: "Lead" }// Update ALL todos at once - NEVER split todos!TodoWrite { todos: [@@ -1018,10 +1018,10 @@ Dependencies: β³ X deps | Actionable: βΆ]}// Start orchestration- mcp__claude-flow__task_orchestrate { task: "Build REST API", strategy: "parallel" }+ mcp__claude-flow@alpha__task_orchestrate { task: "Build REST API", strategy: "parallel" }// Store initial memory- mcp__claude-flow__memory_usage { action: "store", key: "project/init", value: { started: Date.now() } }+ mcp__claude-flow@alpha__memory_usage { action: "store", key: "project/init", value: { started: Date.now() } }[BatchTool - Message 2]:// Create ALL directories at once@@ -1052,9 +1052,9 @@ Dependencies: β³ X deps | Actionable: βΆ```javascript// β WRONG: Multiple messages, one operation each-Message 1: mcp__claude-flow__swarm_init-Message 2: mcp__claude-flow__agent_spawn (just one agent)-Message 3: mcp__claude-flow__agent_spawn (another agent)+Message 1: mcp__claude-flow@alpha__swarm_init+Message 2: mcp__claude-flow@alpha__agent_spawn (just one agent)+Message 3: mcp__claude-flow@alpha__agent_spawn (another agent)Message 4: TodoWrite (single todo)Message 5: Write (single file)// This is 5x slower and wastes swarm coordination!@@ -1066,7 +1066,7 @@ Every agent coordination step MUST use memory:```// After each major decision or implementation-mcp__claude-flow__memory_usage+mcp__claude-flow@alpha__memory_usageaction: "store"key: "swarm-{id}/agent-{name}/{step}"value: {@@ -1078,12 +1078,12 @@ mcp__claude-flow__memory_usage}// To retrieve coordination data-mcp__claude-flow__memory_usage+mcp__claude-flow@alpha__memory_usageaction: "retrieve"key: "swarm-{id}/agent-{name}/{step}"// To check all swarm progress-mcp__claude-flow__memory_usage+mcp__claude-flow@alpha__memory_usageaction: "list"pattern: "swarm-{id}/*"```@@ -1093,7 +1093,7 @@ mcp__claude-flow__memory_usage1. **Batch Everything**: Never operate on single files when multiple are needed2. **Parallel First**: Always think "what can run simultaneously?"3. **Memory is Key**: Use memory for ALL cross-agent coordination-4. **Monitor Progress**: Use mcp**claude-flow**swarm_monitor for real-time tracking+4. **Monitor Progress**: Use mcp**claude-flow@alpha**swarm_monitor for real-time tracking5. **Auto-Optimize**: Let hooks handle topology and agent selection### π¨ VISUAL SWARM STATUS@@ -1176,10 +1176,10 @@ Claude Flow extends the base coordination with:## Support-- Documentation: https://github.com/ruvnet/claude-flow-- Issues: https://github.com/ruvnet/claude-flow/issues-- Examples: https://github.com/ruvnet/claude-flow/tree/main/examples+- Documentation: https://github.com/ruvnet/claude-flow@alpha+- Issues: https://github.com/ruvnet/claude-flow@alpha/issues+- Examples: https://github.com/ruvnet/claude-flow@alpha/tree/main/examples----Remember: **Claude Flow coordinates, Claude Code creates!** Start with `mcp__claude-flow__swarm_init` to enhance your development workflow.+Remember: **Claude Flow coordinates, Claude Code creates!** Start with `mcp__claude-flow@alpha__swarm_init` to enhance your development workflow.diff --git a/bin/init/templates/claude-md.js b/bin/init/templates/claude-md.jsindex 137acd4062..54859da4ab 100644--- a/bin/init/templates/claude-md.js+++ b/bin/init/templates/claude-md.js@@ -85,7 +85,7 @@ mcp__flow-nexus__swarm_init { topology: "mesh", maxAgents: 5 }mcp__flow-nexus__sandbox_create { template: "node", name: "api-dev" }\`\`\`-Learn more: https://github.com/ruvnet/claude-flow#flow-nexus+Learn more: https://github.com/ruvnet/claude-flow@alpha#flow-nexus## Project InfoThis is a Claude-Flow AI agent orchestration system.@@ -153,8 +153,8 @@ If ANY answer is "No", you MUST combine operations into a single message!- \`npm run test\`: Run the full test suite- \`npm run lint\`: Run ESLint and format checks- \`npm run typecheck\`: Run TypeScript type checking-- \`./claude-flow start\`: Start the orchestration system-- \`./claude-flow --help\`: Show all available commands+- \`./claude-flow@alpha start\`: Start the orchestration system+- \`./claude-flow@alpha --help\`: Show all available commands## Code Style Preferences- Use ES modules (import/export) syntax, not CommonJS (require)@@ -188,9 +188,9 @@ This is a Claude-Flow AI agent orchestration system with the following component- All components are event-driven for scalability## Debugging-- Check logs in \`./claude-flow.log\`-- Use \`./claude-flow status\` to check system health-- Monitor with \`./claude-flow monitor\` for real-time updates+- Check logs in \`./[email protected]\`+- Use \`./claude-flow@alpha status\` to check system health+- Monitor with \`./claude-flow@alpha monitor\` for real-time updates- Verbose output available with \`--verbose\` flag on most commands## π Flow Nexus Cloud Platform@@ -242,7 +242,7 @@ mcp__flow-nexus__swarm_init { topology: "mesh", maxAgents: 5 }mcp__flow-nexus__sandbox_create { template: "node", name: "api-dev" }\`\`\`-Learn more: https://github.com/ruvnet/claude-flow#flow-nexus+Learn more: https://github.com/ruvnet/claude-flow@alpha#flow-nexus`;}@@ -308,10 +308,10 @@ This project uses the SPARC (Specification, Pseudocode, Architecture, Refinement## SPARC Development Commands### Core SPARC Commands-- \`./claude-flow sparc modes\`: List all available SPARC development modes-- \`./claude-flow sparc run <mode> "<task>"\`: Execute specific SPARC mode for a task-- \`./claude-flow sparc tdd "<feature>"\`: Run complete TDD workflow using SPARC methodology-- \`./claude-flow sparc info <mode>\`: Get detailed information about a specific mode+- \`./claude-flow@alpha sparc modes\`: List all available SPARC development modes+- \`./claude-flow@alpha sparc run <mode> "<task>"\`: Execute specific SPARC mode for a task+- \`./claude-flow@alpha sparc tdd "<feature>"\`: Run complete TDD workflow using SPARC methodology+- \`./claude-flow@alpha sparc info <mode>\`: Get detailed information about a specific mode### Standard Build Commands- \`npm run build\`: Build the project@@ -324,7 +324,7 @@ This project uses the SPARC (Specification, Pseudocode, Architecture, Refinement### 1. Specification Phase\`\`\`bash# Create detailed specifications and requirements-./claude-flow sparc run spec-pseudocode "Define user authentication requirements"+./claude-flow@alpha sparc run spec-pseudocode "Define user authentication requirements"\`\`\`- Define clear functional requirements- Document edge cases and constraints@@ -334,7 +334,7 @@ This project uses the SPARC (Specification, Pseudocode, Architecture, Refinement### 2. Pseudocode Phase\`\`\`bash# Develop algorithmic logic and data flows-./claude-flow sparc run spec-pseudocode "Create authentication flow pseudocode"+./claude-flow@alpha sparc run spec-pseudocode "Create authentication flow pseudocode"\`\`\`- Break down complex logic into steps- Define data structures and interfaces@@ -344,7 +344,7 @@ This project uses the SPARC (Specification, Pseudocode, Architecture, Refinement### 3. Architecture Phase\`\`\`bash# Design system architecture and component structure-./claude-flow sparc run architect "Design authentication service architecture"+./claude-flow@alpha sparc run architect "Design authentication service architecture"\`\`\`- Create system diagrams and component relationships- Define API contracts and interfaces@@ -354,7 +354,7 @@ This project uses the SPARC (Specification, Pseudocode, Architecture, Refinement### 4. Refinement Phase (TDD Implementation)\`\`\`bash# Execute Test-Driven Development cycle-./claude-flow sparc tdd "implement user authentication system"+./claude-flow@alpha sparc tdd "implement user authentication system"\`\`\`**TDD Cycle:**@@ -366,7 +366,7 @@ This project uses the SPARC (Specification, Pseudocode, Architecture, Refinement### 5. Completion Phase\`\`\`bash# Integration, documentation, and validation-./claude-flow sparc run integration "integrate authentication with user management"+./claude-flow@alpha sparc run integration "integrate authentication with user management"\`\`\`- Integrate all components- Perform end-to-end testing@@ -400,9 +400,9 @@ Claude Code slash commands are available in \`.claude/commands/\`:### Project Commands- \`/sparc\`: Execute SPARC methodology workflows- \`/sparc-<mode>\`: Run specific SPARC mode (e.g., /sparc-architect)-- \`/claude-flow-help\`: Show all Claude-Flow commands-- \`/claude-flow-memory\`: Interact with memory system-- \`/claude-flow-swarm\`: Coordinate multi-agent swarms+- \`/claude-flow@alpha-help\`: Show all Claude-Flow commands+- \`/claude-flow@alpha-memory\`: Interact with memory system+- \`/claude-flow@alpha-swarm\`: Coordinate multi-agent swarms### Using Slash Commands1. Type \`/\` in Claude Code to see available commands@@ -427,7 +427,7 @@ Claude Code slash commands are available in \`.claude/commands/\`:- Prefer composition over inheritance### Memory and State Management-- Use claude-flow memory system for persistent state across sessions+- Use claude-flow@alpha memory system for persistent state across sessions- Store progress and findings using namespaced keys- Query previous work before starting new tasks- Export/import memory for backup and sharing@@ -437,19 +437,19 @@ Claude Code slash commands are available in \`.claude/commands/\`:### Memory Commands for SPARC Development\`\`\`bash# Store project specifications-./claude-flow memory store spec_auth "User authentication requirements and constraints"+./claude-flow@alpha memory store spec_auth "User authentication requirements and constraints"# Store architectural decisions-./claude-flow memory store arch_decisions "Database schema and API design choices"+./claude-flow@alpha memory store arch_decisions "Database schema and API design choices"# Store test results and coverage-./claude-flow memory store test_coverage "Authentication module: 95% coverage, all tests passing"+./claude-flow@alpha memory store test_coverage "Authentication module: 95% coverage, all tests passing"# Query previous work-./claude-flow memory query auth_implementation+./claude-flow@alpha memory query auth_implementation# Export project memory-./claude-flow memory export project_backup.json+./claude-flow@alpha memory export project_backup.json\`\`\`### Memory Namespaces@@ -464,37 +464,37 @@ Claude Code slash commands are available in \`.claude/commands/\`:### Feature Development Workflow\`\`\`bash# 1. Start with specification-./claude-flow sparc run spec-pseudocode "User profile management feature"+./claude-flow@alpha sparc run spec-pseudocode "User profile management feature"# 2. Design architecture-./claude-flow sparc run architect "Profile service architecture with data validation"+./claude-flow@alpha sparc run architect "Profile service architecture with data validation"# 3. Implement with TDD-./claude-flow sparc tdd "user profile CRUD operations"+./claude-flow@alpha sparc tdd "user profile CRUD operations"# 4. Security review-./claude-flow sparc run security-review "profile data access and validation"+./claude-flow@alpha sparc run security-review "profile data access and validation"# 5. Integration testing-./claude-flow sparc run integration "profile service with authentication system"+./claude-flow@alpha sparc run integration "profile service with authentication system"# 6. Documentation-./claude-flow sparc run docs-writer "profile service API documentation"+./claude-flow@alpha sparc run docs-writer "profile service API documentation"\`\`\`### Bug Fix Workflow\`\`\`bash# 1. Debug and analyze-./claude-flow sparc run debug "authentication token expiration issue"+./claude-flow@alpha sparc run debug "authentication token expiration issue"# 2. Write regression tests-./claude-flow sparc run tdd "token refresh mechanism tests"+./claude-flow@alpha sparc run tdd "token refresh mechanism tests"# 3. Implement fix-./claude-flow sparc run code "fix token refresh in authentication service"+./claude-flow@alpha sparc run code "fix token refresh in authentication service"# 4. Security review-./claude-flow sparc run security-review "token handling security implications"+./claude-flow@alpha sparc run security-review "token handling security implications"\`\`\`## Configuration Files@@ -537,16 +537,16 @@ Claude Code slash commands are available in \`.claude/commands/\`:### Debug Commands\`\`\`bash# Check SPARC configuration-./claude-flow sparc modes+./claude-flow@alpha sparc modes# Verify memory system-./claude-flow memory stats+./claude-flow@alpha memory stats# Check system status-./claude-flow status+./claude-flow@alpha status# View detailed mode information-./claude-flow sparc info <mode-name>+./claude-flow@alpha sparc info <mode-name>\`\`\`## Project Architecture@@ -618,7 +618,7 @@ mcp__flow-nexus__swarm_init { topology: "mesh", maxAgents: 5 }mcp__flow-nexus__sandbox_create { template: "node", name: "api-dev" }\`\`\`-Learn more: https://github.com/ruvnet/claude-flow#flow-nexus+Learn more: https://github.com/ruvnet/claude-flow@alpha#flow-nexus`;}@@ -639,9 +639,9 @@ export function createOptimizedSparcClaudeMd() {Before complex tasks, use psycho-symbolic reasoning:\`\`\`javascript// Use MCP tools for advanced coordination:-// - mcp__claude-flow__swarm_init for agent orchestration-// - mcp__claude-flow__neural_patterns for intelligent analysis-// - mcp__claude-flow__memory_usage for persistent context+// - mcp__claude-flow@alpha__swarm_init for agent orchestration+// - mcp__claude-flow@alpha__neural_patterns for intelligent analysis+// - mcp__claude-flow@alpha__memory_usage for persistent context\`\`\`### Cognitive Role Specialization@@ -683,9 +683,9 @@ Agents now have cognitive patterns:\`\`\`**MCP tools are ONLY for coordination setup:**-- \`mcp__claude-flow__swarm_init\` - Initialize coordination topology-- \`mcp__claude-flow__agent_spawn\` - Define agent types for coordination-- \`mcp__claude-flow__task_orchestrate\` - Orchestrate high-level workflows+- \`mcp__claude-flow@alpha__swarm_init\` - Initialize coordination topology+- \`mcp__claude-flow@alpha__agent_spawn\` - Define agent types for coordination+- \`mcp__claude-flow@alpha__task_orchestrate\` - Orchestrate high-level workflows### π File Organization Rules@@ -704,15 +704,15 @@ This project uses SPARC (Specification, Pseudocode, Architecture, Refinement, Co## SPARC Commands### Core Commands-- \`npx claude-flow sparc modes\` - List available modes-- \`npx claude-flow sparc run <mode> "<task>"\` - Execute specific mode-- \`npx claude-flow sparc tdd "<feature>"\` - Run complete TDD workflow-- \`npx claude-flow sparc info <mode>\` - Get mode details+- \`npx claude-flow@alpha sparc modes\` - List available modes+- \`npx claude-flow@alpha sparc run <mode> "<task>"\` - Execute specific mode+- \`npx claude-flow@alpha sparc tdd "<feature>"\` - Run complete TDD workflow+- \`npx claude-flow@alpha sparc info <mode>\` - Get mode details### Batchtools Commands-- \`npx claude-flow sparc batch <modes> "<task>"\` - Parallel execution-- \`npx claude-flow sparc pipeline "<task>"\` - Full pipeline processing-- \`npx claude-flow sparc concurrent <mode> "<tasks-file>"\` - Multi-task processing+- \`npx claude-flow@alpha sparc batch <modes> "<task>"\` - Parallel execution+- \`npx claude-flow@alpha sparc pipeline "<task>"\` - Full pipeline processing+- \`npx claude-flow@alpha sparc concurrent <mode> "<tasks-file>"\` - Multi-task processing### Build Commands- \`npm run build\` - Build project@@ -794,7 +794,7 @@ This project uses SPARC (Specification, Pseudocode, Architecture, Refinement, Co\`\`\`bash# Add MCP servers (Claude Flow required, others optional)-claude mcp add claude-flow npx claude-flow@alpha mcp start+claude mcp add claude-flow@alpha npx claude-flow@alpha mcp startclaude mcp add ruv-swarm npx ruv-swarm mcp start # Optional: Enhanced coordinationclaude mcp add flow-nexus npx flow-nexus@latest mcp start # Optional: Cloud features\`\`\`@@ -903,13 +903,13 @@ npx claude-flow@alpha hooks session-end --export-metrics true\`\`\`javascript// Step 1: MCP tools set up coordination with cognitive patterns[Single Message - Enhanced Coordination Setup]:- mcp__claude-flow__swarm_init { topology: "mesh", maxAgents: 6 }- mcp__claude-flow__agent_spawn { type: "researcher", cognitivePattern: "divergent" }- mcp__claude-flow__agent_spawn { type: "coder", cognitivePattern: "systems" }- mcp__claude-flow__agent_spawn { type: "tester", cognitivePattern: "critical" }+ mcp__claude-flow@alpha__swarm_init { topology: "mesh", maxAgents: 6 }+ mcp__claude-flow@alpha__agent_spawn { type: "researcher", cognitivePattern: "divergent" }+ mcp__claude-flow@alpha__agent_spawn { type: "coder", cognitivePattern: "systems" }+ mcp__claude-flow@alpha__agent_spawn { type: "tester", cognitivePattern: "critical" }// Initialize psycho-symbolic reasoning for the swarm- mcp__claude-flow__neural_patterns {+ mcp__claude-flow@alpha__neural_patterns {action: "analyze",operation: "What patterns should guide this implementation?",metadata: { depth: 10, cache: true }@@ -946,7 +946,7 @@ npx claude-flow@alpha hooks session-end --export-metrics true### β WRONG (Multiple Messages):\`\`\`javascript-Message 1: mcp__claude-flow__swarm_init+Message 1: mcp__claude-flow@alpha__swarm_initMessage 2: Task("agent 1")Message 3: TodoWrite { todos: [single todo] }Message 4: Write "file.js"@@ -1006,8 +1006,8 @@ Message 4: Write "file.js"## Support-- Documentation: https://github.com/ruvnet/claude-flow-- Issues: https://github.com/ruvnet/claude-flow/issues+- Documentation: https://github.com/ruvnet/claude-flow@alpha+- Issues: https://github.com/ruvnet/claude-flow@alpha/issues- Flow-Nexus Platform: https://flow-nexus.ruv.io (registration required for cloud features)---@@ -1133,7 +1133,7 @@ Flow Nexus seamlessly integrates with Claude Code through MCP (Model Context Pro### π Learn More-- Documentation: https://github.com/ruvnet/claude-flow#flow-nexus+- Documentation: https://github.com/ruvnet/claude-flow@alpha#flow-nexus- MCP Integration: Use \`mcp__flow-nexus__*\` tools in Claude Code- Agent Usage: Type \`/\` in Claude Code to see Flow Nexus commands- Community: Join discussions and share templatesdiff --git a/bin/init/templates/enhanced-templates.js b/bin/init/templates/enhanced-templates.jsindex f57c85bac1..e6e3e36a27 100644--- a/bin/init/templates/enhanced-templates.js+++ b/bin/init/templates/enhanced-templates.js@@ -36,14 +36,14 @@ export function createEnhancedSettingsJson() {export function createWrapperScript(type = 'unix') {// For unix, use the universal wrapper that works in both CommonJS and ES modulesif (type === 'unix') {- const universalTemplate = loadTemplate('claude-flow-universal');+ const universalTemplate = loadTemplate('claude-flow@alpha-universal');if (universalTemplate) {return universalTemplate;}}const filename =- type === 'unix' ? 'claude-flow' : type === 'windows' ? 'claude-flow.bat' : 'claude-flow.ps1';+ type === 'unix' ? 'claude-flow@alpha' : type === 'windows' ? '[email protected]' : '[email protected]';const template = loadTemplate(filename);if (!template) {@@ -71,7 +71,7 @@ Automatically detect performance bottlenecks in your swarm operations.## Usage\`\`\`bash-npx claude-flow analysis bottleneck-detect [options]+npx claude-flow@alpha analysis bottleneck-detect [options]\`\`\`## Options@@ -82,13 +82,13 @@ npx claude-flow analysis bottleneck-detect [options]## Examples\`\`\`bash# Detect bottlenecks in current swarm-npx claude-flow analysis bottleneck-detect+npx claude-flow@alpha analysis bottleneck-detect# Set custom threshold-npx claude-flow analysis bottleneck-detect --threshold 500+npx claude-flow@alpha analysis bottleneck-detect --threshold 500# Export results-npx claude-flow analysis bottleneck-detect --export bottlenecks.json+npx claude-flow@alpha analysis bottleneck-detect --export bottlenecks.json\`\`\``,'token-usage': `# token-usage@@ -97,7 +97,7 @@ Analyze token usage patterns and optimize for efficiency.## Usage\`\`\`bash-npx claude-flow analysis token-usage [options]+npx claude-flow@alpha analysis token-usage [options]\`\`\`## Options@@ -108,13 +108,13 @@ npx claude-flow analysis token-usage [options]## Examples\`\`\`bash# Last 24 hours token usage-npx claude-flow analysis token-usage --period 24h+npx claude-flow@alpha analysis token-usage --period 24h# By agent breakdown-npx claude-flow analysis token-usage --by-agent+npx claude-flow@alpha analysis token-usage --by-agent# Export detailed report-npx claude-flow analysis token-usage --period 7d --export tokens.csv+npx claude-flow@alpha analysis token-usage --period 7d --export tokens.csv\`\`\``,'performance-report': `# performance-report@@ -123,7 +123,7 @@ Generate comprehensive performance reports for swarm operations.## Usage\`\`\`bash-npx claude-flow analysis performance-report [options]+npx claude-flow@alpha analysis performance-report [options]\`\`\`## Options@@ -134,13 +134,13 @@ npx claude-flow analysis performance-report [options]## Examples\`\`\`bash# Generate HTML report-npx claude-flow analysis performance-report --format html+npx claude-flow@alpha analysis performance-report --format html# Compare swarms-npx claude-flow analysis performance-report --compare swarm-123+npx claude-flow@alpha analysis performance-report --compare swarm-123# Full metrics report-npx claude-flow analysis performance-report --include-metrics --format markdown+npx claude-flow@alpha analysis performance-report --include-metrics --format markdown\`\`\``,},@@ -151,7 +151,7 @@ Automatically assign agents based on task analysis.## Usage\`\`\`bash-npx claude-flow automation auto-agent [options]+npx claude-flow@alpha automation auto-agent [options]\`\`\`## Options@@ -162,13 +162,13 @@ npx claude-flow automation auto-agent [options]## Examples\`\`\`bash# Auto-assign for task-npx claude-flow automation auto-agent --task "Build REST API"+npx claude-flow@alpha automation auto-agent --task "Build REST API"# Limit agents-npx claude-flow automation auto-agent --task "Fix bugs" --max-agents 3+npx claude-flow@alpha automation auto-agent --task "Fix bugs" --max-agents 3# Use specific strategy-npx claude-flow automation auto-agent --strategy specialized+npx claude-flow@alpha automation auto-agent --strategy specialized\`\`\``,'smart-spawn': `# smart-spawn@@ -177,7 +177,7 @@ Intelligently spawn agents based on workload analysis.## Usage\`\`\`bash-npx claude-flow automation smart-spawn [options]+npx claude-flow@alpha automation smart-spawn [options]\`\`\`## Options@@ -188,13 +188,13 @@ npx claude-flow automation smart-spawn [options]## Examples\`\`\`bash# Smart spawn with analysis-npx claude-flow automation smart-spawn --analyze+npx claude-flow@alpha automation smart-spawn --analyze# Set spawn threshold-npx claude-flow automation smart-spawn --threshold 5+npx claude-flow@alpha automation smart-spawn --threshold 5# Force topology-npx claude-flow automation smart-spawn --topology hierarchical+npx claude-flow@alpha automation smart-spawn --topology hierarchical\`\`\``,'workflow-select': `# workflow-select@@ -203,7 +203,7 @@ Automatically select optimal workflow based on task type.## Usage\`\`\`bash-npx claude-flow automation workflow-select [options]+npx claude-flow@alpha automation workflow-select [options]\`\`\`## Options@@ -214,13 +214,13 @@ npx claude-flow automation workflow-select [options]## Examples\`\`\`bash# Select workflow for task-npx claude-flow automation workflow-select --task "Deploy to production"+npx claude-flow@alpha automation workflow-select --task "Deploy to production"# With constraints-npx claude-flow automation workflow-select --constraints "no-downtime,rollback"+npx claude-flow@alpha automation workflow-select --constraints "no-downtime,rollback"# Preview mode-npx claude-flow automation workflow-select --task "Database migration" --preview+npx claude-flow@alpha automation workflow-select --task "Database migration" --preview\`\`\``,},@@ -231,7 +231,7 @@ Initialize a new agent swarm with specified topology.## Usage\`\`\`bash-npx claude-flow swarm init [options]+npx claude-flow@alpha swarm init [options]\`\`\`## Options@@ -242,13 +242,13 @@ npx claude-flow swarm init [options]## Examples\`\`\`bash# Initialize hierarchical swarm-npx claude-flow swarm init --topology hierarchical+npx claude-flow@alpha swarm init --topology hierarchical# With agent limit-npx claude-flow swarm init --topology mesh --max-agents 8+npx claude-flow@alpha swarm init --topology mesh --max-agents 8# Parallel execution-npx claude-flow swarm init --strategy parallel+npx claude-flow@alpha swarm init --strategy parallel\`\`\``,'agent-spawn': `# agent-spawn@@ -257,7 +257,7 @@ Spawn a new agent in the current swarm.## Usage\`\`\`bash-npx claude-flow agent spawn [options]+npx claude-flow@alpha agent spawn [options]\`\`\`## Options@@ -268,13 +268,13 @@ npx claude-flow agent spawn [options]## Examples\`\`\`bash# Spawn coder agent-npx claude-flow agent spawn --type coder+npx claude-flow@alpha agent spawn --type coder# With custom name-npx claude-flow agent spawn --type researcher --name "API Expert"+npx claude-flow@alpha agent spawn --type researcher --name "API Expert"# With specific skills-npx claude-flow agent spawn --type coder --skills "python,fastapi,testing"+npx claude-flow@alpha agent spawn --type coder --skills "python,fastapi,testing"\`\`\``,'task-orchestrate': `# task-orchestrate@@ -283,7 +283,7 @@ Orchestrate complex tasks across the swarm.## Usage\`\`\`bash-npx claude-flow task orchestrate [options]+npx claude-flow@alpha task orchestrate [options]\`\`\`## Options@@ -294,13 +294,13 @@ npx claude-flow task orchestrate [options]## Examples\`\`\`bash# Orchestrate development task-npx claude-flow task orchestrate --task "Implement user authentication"+npx claude-flow@alpha task orchestrate --task "Implement user authentication"# High priority task-npx claude-flow task orchestrate --task "Fix production bug" --priority critical+npx claude-flow@alpha task orchestrate --task "Fix production bug" --priority critical# With specific strategy-npx claude-flow task orchestrate --task "Refactor codebase" --strategy parallel+npx claude-flow@alpha task orchestrate --task "Refactor codebase" --strategy parallel\`\`\``,},@@ -311,7 +311,7 @@ Create a specialized swarm for GitHub repository management.## Usage\`\`\`bash-npx claude-flow github swarm [options]+npx claude-flow@alpha github swarm [options]\`\`\`## Options@@ -322,13 +322,13 @@ npx claude-flow github swarm [options]## Examples\`\`\`bash# Create GitHub swarm-npx claude-flow github swarm --repository myorg/myrepo+npx claude-flow@alpha github swarm --repository myorg/myrepo# With specific focus-npx claude-flow github swarm --repository myorg/myrepo --focus security+npx claude-flow@alpha github swarm --repository myorg/myrepo --focus security# Custom agent count-npx claude-flow github swarm --repository myorg/myrepo --agents 6+npx claude-flow@alpha github swarm --repository myorg/myrepo --agents 6\`\`\``,'repo-analyze': `# repo-analyze@@ -337,7 +337,7 @@ Deep analysis of GitHub repository with AI insights.## Usage\`\`\`bash-npx claude-flow github repo-analyze [options]+npx claude-flow@alpha github repo-analyze [options]\`\`\`## Options@@ -348,13 +348,13 @@ npx claude-flow github repo-analyze [options]## Examples\`\`\`bash# Basic analysis-npx claude-flow github repo-analyze --repository myorg/myrepo+npx claude-flow@alpha github repo-analyze --repository myorg/myrepo# Deep analysis-npx claude-flow github repo-analyze --repository myorg/myrepo --deep+npx claude-flow@alpha github repo-analyze --repository myorg/myrepo --deep# Specific areas-npx claude-flow github repo-analyze --repository myorg/myrepo --include issues,prs+npx claude-flow@alpha github repo-analyze --repository myorg/myrepo --include issues,prs\`\`\``,'pr-enhance': `# pr-enhance@@ -363,7 +363,7 @@ AI-powered pull request enhancements.## Usage\`\`\`bash-npx claude-flow github pr-enhance [options]+npx claude-flow@alpha github pr-enhance [options]\`\`\`## Options@@ -375,13 +375,13 @@ npx claude-flow github pr-enhance [options]## Examples\`\`\`bash# Enhance PR-npx claude-flow github pr-enhance --pr-number 123+npx claude-flow@alpha github pr-enhance --pr-number 123# Add tests-npx claude-flow github pr-enhance --pr-number 123 --add-tests+npx claude-flow@alpha github pr-enhance --pr-number 123 --add-tests# Full enhancement-npx claude-flow github pr-enhance --pr-number 123 --add-tests --improve-docs+npx claude-flow@alpha github pr-enhance --pr-number 123 --add-tests --improve-docs\`\`\``,'issue-triage': `# issue-triage@@ -390,7 +390,7 @@ Intelligent issue classification and triage.## Usage\`\`\`bash-npx claude-flow github issue-triage [options]+npx claude-flow@alpha github issue-triage [options]\`\`\`## Options@@ -401,13 +401,13 @@ npx claude-flow github issue-triage [options]## Examples\`\`\`bash# Triage issues-npx claude-flow github issue-triage --repository myorg/myrepo+npx claude-flow@alpha github issue-triage --repository myorg/myrepo# With auto-labeling-npx claude-flow github issue-triage --repository myorg/myrepo --auto-label+npx claude-flow@alpha github issue-triage --repository myorg/myrepo --auto-label# Full automation-npx claude-flow github issue-triage --repository myorg/myrepo --auto-label --assign+npx claude-flow@alpha github issue-triage --repository myorg/myrepo --auto-label --assign\`\`\``,'code-review': `# code-review@@ -416,7 +416,7 @@ Automated code review with swarm intelligence.## Usage\`\`\`bash-npx claude-flow github code-review [options]+npx claude-flow@alpha github code-review [options]\`\`\`## Options@@ -427,13 +427,13 @@ npx claude-flow github code-review [options]## Examples\`\`\`bash# Review PR-npx claude-flow github code-review --pr-number 456+npx claude-flow@alpha github code-review --pr-number 456# Security focus-npx claude-flow github code-review --pr-number 456 --focus security+npx claude-flow@alpha github code-review --pr-number 456 --focus security# With fix suggestions-npx claude-flow github code-review --pr-number 456 --suggest-fixes+npx claude-flow@alpha github code-review --pr-number 456 --suggest-fixes\`\`\``,},@@ -444,7 +444,7 @@ Hook executed before task execution.## Usage\`\`\`bash-npx claude-flow hook pre-task [options]+npx claude-flow@alpha hook pre-task [options]\`\`\`## Options@@ -455,13 +455,13 @@ npx claude-flow hook pre-task [options]## Examples\`\`\`bash# Basic pre-task hook-npx claude-flow hook pre-task --description "Building API endpoints"+npx claude-flow@alpha hook pre-task --description "Building API endpoints"# With auto-spawn-npx claude-flow hook pre-task --description "Complex refactoring" --auto-spawn-agents+npx claude-flow@alpha hook pre-task --description "Complex refactoring" --auto-spawn-agents# Load context-npx claude-flow hook pre-task --description "Continue feature" --load-context+npx claude-flow@alpha hook pre-task --description "Continue feature" --load-context\`\`\``,'post-task': `# post-task@@ -470,7 +470,7 @@ Hook executed after task completion.## Usage\`\`\`bash-npx claude-flow hook post-task [options]+npx claude-flow@alpha hook post-task [options]\`\`\`## Options@@ -481,13 +481,13 @@ npx claude-flow hook post-task [options]## Examples\`\`\`bash# Basic post-task-npx claude-flow hook post-task --task-id task-123+npx claude-flow@alpha hook post-task --task-id task-123# With performance analysis-npx claude-flow hook post-task --task-id task-123 --analyze-performance+npx claude-flow@alpha hook post-task --task-id task-123 --analyze-performance# Update memory-npx claude-flow hook post-task --task-id task-123 --update-memory+npx claude-flow@alpha hook post-task --task-id task-123 --update-memory\`\`\``,'pre-edit': `# pre-edit@@ -496,7 +496,7 @@ Hook executed before file edits.## Usage\`\`\`bash-npx claude-flow hook pre-edit [options]+npx claude-flow@alpha hook pre-edit [options]\`\`\`## Options@@ -507,13 +507,13 @@ npx claude-flow hook pre-edit [options]## Examples\`\`\`bash# Pre-edit hook-npx claude-flow hook pre-edit --file src/api.js+npx claude-flow@alpha hook pre-edit --file src/api.js# With validation-npx claude-flow hook pre-edit --file src/api.js --validate-syntax+npx claude-flow@alpha hook pre-edit --file src/api.js --validate-syntax# Create backup-npx claude-flow hook pre-edit --file src/api.js --backup+npx claude-flow@alpha hook pre-edit --file src/api.js --backup\`\`\``,'post-edit': `# post-edit@@ -522,7 +522,7 @@ Hook executed after file edits.## Usage\`\`\`bash-npx claude-flow hook post-edit [options]+npx claude-flow@alpha hook post-edit [options]\`\`\`## Options@@ -533,13 +533,13 @@ npx claude-flow hook post-edit [options]## Examples\`\`\`bash# Post-edit hook-npx claude-flow hook post-edit --file src/api.js+npx claude-flow@alpha hook post-edit --file src/api.js# Store in memory-npx claude-flow hook post-edit --file src/api.js --memory-key "api-changes"+npx claude-flow@alpha hook post-edit --file src/api.js --memory-key "api-changes"# With formatting-npx claude-flow hook post-edit --file src/api.js --format+npx claude-flow@alpha hook post-edit --file src/api.js --format\`\`\``,'session-end': `# session-end@@ -548,7 +548,7 @@ Hook executed at session end.## Usage\`\`\`bash-npx claude-flow hook session-end [options]+npx claude-flow@alpha hook session-end [options]\`\`\`## Options@@ -559,13 +559,13 @@ npx claude-flow hook session-end [options]## Examples\`\`\`bash# End session-npx claude-flow hook session-end+npx claude-flow@alpha hook session-end# Export metrics-npx claude-flow hook session-end --export-metrics+npx claude-flow@alpha hook session-end --export-metrics# Full closure-npx claude-flow hook session-end --export-metrics --generate-summary --persist-state+npx claude-flow@alpha hook session-end --export-metrics --generate-summary --persist-state\`\`\``,},@@ -576,7 +576,7 @@ Manage persistent memory storage.## Usage\`\`\`bash-npx claude-flow memory usage [options]+npx claude-flow@alpha memory usage [options]\`\`\`## Options@@ -587,13 +587,13 @@ npx claude-flow memory usage [options]## Examples\`\`\`bash# Store memory-npx claude-flow memory usage --action store --key "project-config" --value '{"api": "v2"}'+npx claude-flow@alpha memory usage --action store --key "project-config" --value '{"api": "v2"}'# Retrieve memory-npx claude-flow memory usage --action retrieve --key "project-config"+npx claude-flow@alpha memory usage --action retrieve --key "project-config"# List all keys-npx claude-flow memory usage --action list+npx claude-flow@alpha memory usage --action list\`\`\``,'memory-persist': `# memory-persist@@ -602,7 +602,7 @@ Persist memory across sessions.## Usage\`\`\`bash-npx claude-flow memory persist [options]+npx claude-flow@alpha memory persist [options]\`\`\`## Options@@ -613,13 +613,13 @@ npx claude-flow memory persist [options]## Examples\`\`\`bash# Export memory-npx claude-flow memory persist --export memory-backup.json+npx claude-flow@alpha memory persist --export memory-backup.json# Import memory-npx claude-flow memory persist --import memory-backup.json+npx claude-flow@alpha memory persist --import memory-backup.json# Compressed export-npx claude-flow memory persist --export memory.gz --compress+npx claude-flow@alpha memory persist --export memory.gz --compress\`\`\``,'memory-search': `# memory-search@@ -628,7 +628,7 @@ Search through stored memory.## Usage\`\`\`bash-npx claude-flow memory search [options]+npx claude-flow@alpha memory search [options]\`\`\`## Options@@ -639,13 +639,13 @@ npx claude-flow memory search [options]## Examples\`\`\`bash# Search memory-npx claude-flow memory search --query "authentication"+npx claude-flow@alpha memory search --query "authentication"# Pattern search-npx claude-flow memory search --pattern "api-.*"+npx claude-flow@alpha memory search --pattern "api-.*"# Limited results-npx claude-flow memory search --query "config" --limit 10+npx claude-flow@alpha memory search --query "config" --limit 10\`\`\``,},@@ -656,7 +656,7 @@ Real-time swarm monitoring.## Usage\`\`\`bash-npx claude-flow swarm monitor [options]+npx claude-flow@alpha swarm monitor [options]\`\`\`## Options@@ -667,13 +667,13 @@ npx claude-flow swarm monitor [options]## Examples\`\`\`bash# Start monitoring-npx claude-flow swarm monitor+npx claude-flow@alpha swarm monitor# Custom interval-npx claude-flow swarm monitor --interval 5000+npx claude-flow@alpha swarm monitor --interval 5000# With metrics-npx claude-flow swarm monitor --metrics+npx claude-flow@alpha swarm monitor --metrics\`\`\``,'agent-metrics': `# agent-metrics@@ -682,7 +682,7 @@ View agent performance metrics.## Usage\`\`\`bash-npx claude-flow agent metrics [options]+npx claude-flow@alpha agent metrics [options]\`\`\`## Options@@ -693,13 +693,13 @@ npx claude-flow agent metrics [options]## Examples\`\`\`bash# All agents metrics-npx claude-flow agent metrics+npx claude-flow@alpha agent metrics# Specific agent-npx claude-flow agent metrics --agent-id agent-001+npx claude-flow@alpha agent metrics --agent-id agent-001# Last hour-npx claude-flow agent metrics --period 1h+npx claude-flow@alpha agent metrics --period 1h\`\`\``,'real-time-view': `# real-time-view@@ -708,7 +708,7 @@ Real-time view of swarm activity.## Usage\`\`\`bash-npx claude-flow monitoring real-time-view [options]+npx claude-flow@alpha monitoring real-time-view [options]\`\`\`## Options@@ -719,13 +719,13 @@ npx claude-flow monitoring real-time-view [options]## Examples\`\`\`bash# Start real-time view-npx claude-flow monitoring real-time-view+npx claude-flow@alpha monitoring real-time-view# Filter errors-npx claude-flow monitoring real-time-view --filter errors+npx claude-flow@alpha monitoring real-time-view --filter errors# Highlight pattern-npx claude-flow monitoring real-time-view --highlight "API"+npx claude-flow@alpha monitoring real-time-view --highlight "API"\`\`\``,},@@ -736,7 +736,7 @@ Optimize swarm topology for current workload.## Usage\`\`\`bash-npx claude-flow optimization topology-optimize [options]+npx claude-flow@alpha optimization topology-optimize [options]\`\`\`## Options@@ -747,13 +747,13 @@ npx claude-flow optimization topology-optimize [options]## Examples\`\`\`bash# Analyze and suggest-npx claude-flow optimization topology-optimize --analyze-first+npx claude-flow@alpha optimization topology-optimize --analyze-first# Optimize for speed-npx claude-flow optimization topology-optimize --target speed+npx claude-flow@alpha optimization topology-optimize --target speed# Apply changes-npx claude-flow optimization topology-optimize --target efficiency --apply+npx claude-flow@alpha optimization topology-optimize --target efficiency --apply\`\`\``,'parallel-execute': `# parallel-execute@@ -762,7 +762,7 @@ Execute tasks in parallel for maximum efficiency.## Usage\`\`\`bash-npx claude-flow optimization parallel-execute [options]+npx claude-flow@alpha optimization parallel-execute [options]\`\`\`## Options@@ -773,13 +773,13 @@ npx claude-flow optimization parallel-execute [options]## Examples\`\`\`bash# Execute task list-npx claude-flow optimization parallel-execute --tasks tasks.json+npx claude-flow@alpha optimization parallel-execute --tasks tasks.json# Limit parallelism-npx claude-flow optimization parallel-execute --tasks tasks.json --max-parallel 5+npx claude-flow@alpha optimization parallel-execute --tasks tasks.json --max-parallel 5# Custom strategy-npx claude-flow optimization parallel-execute --strategy adaptive+npx claude-flow@alpha optimization parallel-execute --strategy adaptive\`\`\``,'cache-manage': `# cache-manage@@ -788,7 +788,7 @@ Manage operation cache for performance.## Usage\`\`\`bash-npx claude-flow optimization cache-manage [options]+npx claude-flow@alpha optimization cache-manage [options]\`\`\`## Options@@ -799,13 +799,13 @@ npx claude-flow optimization cache-manage [options]## Examples\`\`\`bash# View cache stats-npx claude-flow optimization cache-manage --action view+npx claude-flow@alpha optimization cache-manage --action view# Clear cache-npx claude-flow optimization cache-manage --action clear+npx claude-flow@alpha optimization cache-manage --action clear# Set limits-npx claude-flow optimization cache-manage --max-size 100 --ttl 3600+npx claude-flow@alpha optimization cache-manage --max-size 100 --ttl 3600\`\`\``,},@@ -816,7 +816,7 @@ Train neural patterns from operations.## Usage\`\`\`bash-npx claude-flow training neural-train [options]+npx claude-flow@alpha training neural-train [options]\`\`\`## Options@@ -827,13 +827,13 @@ npx claude-flow training neural-train [options]## Examples\`\`\`bash# Train from recent ops-npx claude-flow training neural-train --data recent+npx claude-flow@alpha training neural-train --data recent# Specific model-npx claude-flow training neural-train --model task-predictor+npx claude-flow@alpha training neural-train --model task-predictor# Custom epochs-npx claude-flow training neural-train --epochs 100+npx claude-flow@alpha training neural-train --epochs 100\`\`\``,'pattern-learn': `# pattern-learn@@ -842,7 +842,7 @@ Learn patterns from successful operations.## Usage\`\`\`bash-npx claude-flow training pattern-learn [options]+npx claude-flow@alpha training pattern-learn [options]\`\`\`## Options@@ -853,13 +853,13 @@ npx claude-flow training pattern-learn [options]## Examples\`\`\`bash# Learn from all ops-npx claude-flow training pattern-learn+npx claude-flow@alpha training pattern-learn# High success only-npx claude-flow training pattern-learn --threshold 0.9+npx claude-flow@alpha training pattern-learn --threshold 0.9# Save patterns-npx claude-flow training pattern-learn --save optimal-patterns+npx claude-flow@alpha training pattern-learn --save optimal-patterns\`\`\``,'model-update': `# model-update@@ -868,7 +868,7 @@ Update neural models with new data.## Usage\`\`\`bash-npx claude-flow training model-update [options]+npx claude-flow@alpha training model-update [options]\`\`\`## Options@@ -879,13 +879,13 @@ npx claude-flow training model-update [options]## Examples\`\`\`bash# Update all models-npx claude-flow training model-update+npx claude-flow@alpha training model-update# Specific model-npx claude-flow training model-update --model agent-selector+npx claude-flow@alpha training model-update --model agent-selector# Incremental with validation-npx claude-flow training model-update --incremental --validate+npx claude-flow@alpha training model-update --incremental --validate\`\`\``,},@@ -896,7 +896,7 @@ Create reusable workflow templates.## Usage\`\`\`bash-npx claude-flow workflow create [options]+npx claude-flow@alpha workflow create [options]\`\`\`## Options@@ -907,13 +907,13 @@ npx claude-flow workflow create [options]## Examples\`\`\`bash# Create workflow-npx claude-flow workflow create --name "deploy-api"+npx claude-flow@alpha workflow create --name "deploy-api"# From history-npx claude-flow workflow create --name "test-suite" --from-history+npx claude-flow@alpha workflow create --name "test-suite" --from-history# Interactive mode-npx claude-flow workflow create --interactive+npx claude-flow@alpha workflow create --interactive\`\`\``,'workflow-execute': `# workflow-execute@@ -922,7 +922,7 @@ Execute saved workflows.## Usage\`\`\`bash-npx claude-flow workflow execute [options]+npx claude-flow@alpha workflow execute [options]\`\`\`## Options@@ -933,13 +933,13 @@ npx claude-flow workflow execute [options]## Examples\`\`\`bash# Execute workflow-npx claude-flow workflow execute --name "deploy-api"+npx claude-flow@alpha workflow execute --name "deploy-api"# With parameters-npx claude-flow workflow execute --name "test-suite" --params '{"env": "staging"}'+npx claude-flow@alpha workflow execute --name "test-suite" --params '{"env": "staging"}'# Dry run-npx claude-flow workflow execute --name "deploy-api" --dry-run+npx claude-flow@alpha workflow execute --name "deploy-api" --dry-run\`\`\``,'workflow-export': `# workflow-export@@ -948,7 +948,7 @@ Export workflows for sharing.## Usage\`\`\`bash-npx claude-flow workflow export [options]+npx claude-flow@alpha workflow export [options]\`\`\`## Options@@ -959,13 +959,13 @@ npx claude-flow workflow export [options]## Examples\`\`\`bash# Export workflow-npx claude-flow workflow export --name "deploy-api"+npx claude-flow@alpha workflow export --name "deploy-api"# As YAML-npx claude-flow workflow export --name "test-suite" --format yaml+npx claude-flow@alpha workflow export --name "test-suite" --format yaml# With history-npx claude-flow workflow export --name "deploy-api" --include-history+npx claude-flow@alpha workflow export --name "deploy-api" --include-history\`\`\``,},@@ -976,7 +976,7 @@ Main swarm orchestration command for Claude Flow.## Usage\`\`\`bash-npx claude-flow swarm <objective> [options]+npx claude-flow@alpha swarm <objective> [options]\`\`\`## Options@@ -989,13 +989,13 @@ npx claude-flow swarm <objective> [options]## Examples\`\`\`bash# Basic swarm-npx claude-flow swarm "Build REST API"+npx claude-flow@alpha swarm "Build REST API"# With strategy-npx claude-flow swarm "Research AI patterns" --strategy research+npx claude-flow@alpha swarm "Research AI patterns" --strategy research# Open in Claude Code-npx claude-flow swarm "Build API" --claude+npx claude-flow@alpha swarm "Build API" --claude\`\`\``,'swarm-init': `# swarm-init@@ -1004,7 +1004,7 @@ Initialize a new swarm with specified topology.## Usage\`\`\`bash-npx claude-flow swarm init [options]+npx claude-flow@alpha swarm init [options]\`\`\`## Options@@ -1014,8 +1014,8 @@ npx claude-flow swarm init [options]## Examples\`\`\`bash-npx claude-flow swarm init --topology mesh-npx claude-flow swarm init --topology hierarchical --max-agents 8+npx claude-flow@alpha swarm init --topology mesh+npx claude-flow@alpha swarm init --topology hierarchical --max-agents 8\`\`\``,'swarm-spawn': `# swarm-spawn@@ -1024,7 +1024,7 @@ Spawn agents in the swarm.## Usage\`\`\`bash-npx claude-flow swarm spawn [options]+npx claude-flow@alpha swarm spawn [options]\`\`\`## Options@@ -1034,8 +1034,8 @@ npx claude-flow swarm spawn [options]## Examples\`\`\`bash-npx claude-flow swarm spawn --type coder --count 3-npx claude-flow swarm spawn --type researcher --capabilities "web-search,analysis"+npx claude-flow@alpha swarm spawn --type coder --count 3+npx claude-flow@alpha swarm spawn --type researcher --capabilities "web-search,analysis"\`\`\``,},@@ -1046,7 +1046,7 @@ Hive Mind collective intelligence system for advanced swarm coordination.## Usage\`\`\`bash-npx claude-flow hive-mind [subcommand] [options]+npx claude-flow@alpha hive-mind [subcommand] [options]\`\`\`## Subcommands@@ -1059,13 +1059,13 @@ npx claude-flow hive-mind [subcommand] [options]## Examples\`\`\`bash# Initialize hive mind-npx claude-flow hive-mind init+npx claude-flow@alpha hive-mind init# Spawn swarm-npx claude-flow hive-mind spawn "Build microservices"+npx claude-flow@alpha hive-mind spawn "Build microservices"# Check status-npx claude-flow hive-mind status+npx claude-flow@alpha hive-mind status\`\`\``,'hive-mind-init': `# hive-mind-init@@ -1074,7 +1074,7 @@ Initialize the Hive Mind collective intelligence system.## Usage\`\`\`bash-npx claude-flow hive-mind init [options]+npx claude-flow@alpha hive-mind init [options]\`\`\`## Options@@ -1083,8 +1083,8 @@ npx claude-flow hive-mind init [options]## Examples\`\`\`bash-npx claude-flow hive-mind init-npx claude-flow hive-mind init --force+npx claude-flow@alpha hive-mind init+npx claude-flow@alpha hive-mind init --force\`\`\``,'hive-mind-spawn': `# hive-mind-spawn@@ -1093,7 +1093,7 @@ Spawn a Hive Mind swarm with queen-led coordination.## Usage\`\`\`bash-npx claude-flow hive-mind spawn <objective> [options]+npx claude-flow@alpha hive-mind spawn <objective> [options]\`\`\`## Options@@ -1104,9 +1104,9 @@ npx claude-flow hive-mind spawn <objective> [options]## Examples\`\`\`bash-npx claude-flow hive-mind spawn "Build API"-npx claude-flow hive-mind spawn "Research patterns" --queen-type adaptive-npx claude-flow hive-mind spawn "Build service" --claude+npx claude-flow@alpha hive-mind spawn "Build API"+npx claude-flow@alpha hive-mind spawn "Research patterns" --queen-type adaptive+npx claude-flow@alpha hive-mind spawn "Build service" --claude\`\`\``,},@@ -1135,7 +1135,7 @@ Complete guide to all 54 available agent types in Claude Flow.For full list and details:\`\`\`bash-npx claude-flow agents list+npx claude-flow@alpha agents list\`\`\``,'agent-capabilities': `# agent-capabilities@@ -1154,10 +1154,10 @@ Matrix of agent capabilities and their specializations.## Querying Capabilities\`\`\`bash# List all capabilities-npx claude-flow agents capabilities+npx claude-flow@alpha agents capabilities# For specific agent-npx claude-flow agents capabilities --type coder+npx claude-flow@alpha agents capabilities --type coder\`\`\``,'agent-coordination': `# agent-coordination@@ -1169,19 +1169,19 @@ Coordination patterns for multi-agent collaboration.### HierarchicalQueen-led with worker specialization\`\`\`bash-npx claude-flow swarm init --topology hierarchical+npx claude-flow@alpha swarm init --topology hierarchical\`\`\`### MeshPeer-to-peer collaboration\`\`\`bash-npx claude-flow swarm init --topology mesh+npx claude-flow@alpha swarm init --topology mesh\`\`\`### AdaptiveDynamic topology based on workload\`\`\`bash-npx claude-flow swarm init --topology adaptive+npx claude-flow@alpha swarm init --topology adaptive\`\`\`## Best Practices@@ -1208,8 +1208,8 @@ Task("Tester", "Create tests...", "tester")MCP tools are ONLY for coordination:\`\`\`javascript-mcp__claude-flow__swarm_init { topology: "mesh" }-mcp__claude-flow__agent_spawn { type: "researcher" }+mcp__claude-flow@alpha__swarm_init { topology: "mesh" }+mcp__claude-flow@alpha__agent_spawn { type: "researcher" }\`\`\`## Best Practices@@ -1223,7 +1223,7 @@ mcp__claude-flow__agent_spawn { type: "researcher" }return (docs[category]?.[command] ||- `# ${command}\n\nCommand documentation for ${command} in category ${category}.\n\nUsage:\n\`\`\`bash\nnpx claude-flow ${category} ${command} [options]\n\`\`\`\n`+ `# ${command}\n\nCommand documentation for ${command} in category ${category}.\n\nUsage:\n\`\`\`bash\nnpx claude-flow@alpha ${category} ${command} [options]\n\`\`\`\n`);}@@ -1261,10 +1261,10 @@ fi# Add MCP serverecho "π¦ Adding Claude Flow MCP server..."-claude mcp add claude-flow npx claude-flow mcp start+claude mcp add claude-flow@alpha npx claude-flow@alpha mcp startecho "β MCP server setup complete!"-echo "π― You can now use mcp__claude-flow__ tools in Claude Code"+echo "π― You can now use mcp__claude-flow@alpha__ tools in Claude Code"`,'quick-start.sh': `#!/bin/bash# Quick start guide for Claude Flow@@ -1273,16 +1273,16 @@ echo "π Claude Flow Quick Start"echo "=========================="echo ""echo "1. Initialize a swarm:"-echo " npx claude-flow swarm init --topology hierarchical"+echo " npx claude-flow@alpha swarm init --topology hierarchical"echo ""echo "2. Spawn agents:"-echo " npx claude-flow agent spawn --type coder --name \"API Developer\""+echo " npx claude-flow@alpha agent spawn --type coder --name \"API Developer\""echo ""echo "3. Orchestrate tasks:"-echo " npx claude-flow task orchestrate --task \"Build REST API\""+echo " npx claude-flow@alpha task orchestrate --task \"Build REST API\""echo ""echo "4. Monitor progress:"-echo " npx claude-flow swarm monitor"+echo " npx claude-flow@alpha swarm monitor"echo ""echo "π For more examples, see .claude/commands/"`,@@ -1310,10 +1310,10 @@ fiecho ""echo "π¦ GitHub swarm commands available:"-echo " - npx claude-flow github swarm"-echo " - npx claude-flow repo analyze"-echo " - npx claude-flow pr enhance"-echo " - npx claude-flow issue triage"+echo " - npx claude-flow@alpha github swarm"+echo " - npx claude-flow@alpha repo analyze"+echo " - npx claude-flow@alpha pr enhance"+echo " - npx claude-flow@alpha issue triage"`,'github-safe.js': `#!/usr/bin/env node@@ -2066,12 +2066,12 @@ function createWrapperScriptFallback(type) {// Fallback for CommonJS}- // Try multiple strategies to find claude-flow+ // Try multiple strategies to find claude-flow@alphaconst strategies = [// 1. Local node_modulesasync () => {try {- const localPath = resolve(process.cwd(), 'node_modules/.bin/claude-flow');+ const localPath = resolve(process.cwd(), 'node_modules/.bin/claude-flow@alpha');const { existsSync } = await import('fs');if (existsSync(localPath)) {return spawn(localPath, process.argv.slice(2), { stdio: 'inherit' });@@ -2082,7 +2082,7 @@ function createWrapperScriptFallback(type) {// 2. Parent node_modules (monorepo)async () => {try {- const parentPath = resolve(process.cwd(), '../node_modules/.bin/claude-flow');+ const parentPath = resolve(process.cwd(), '../node_modules/.bin/claude-flow@alpha');const { existsSync } = await import('fs');if (existsSync(parentPath)) {return spawn(parentPath, process.argv.slice(2), { stdio: 'inherit' });@@ -2092,7 +2092,7 @@ function createWrapperScriptFallback(type) {// 3. NPX with latest alpha version (prioritized over global)async () => {- return spawn('npx', ['[email protected]', ...process.argv.slice(2)], { stdio: 'inherit' });+ return spawn('npx', ['claude-flow@[email protected]', ...process.argv.slice(2)], { stdio: 'inherit' });}];@@ -2113,7 +2113,7 @@ function createWrapperScriptFallback(type) {} catch {}}- console.error('Could not find claude-flow. Please install it with: npm install claude-flow');+ console.error('Could not find claude-flow@alpha. Please install it with: npm install claude-flow@alpha');process.exit(1);})();`;} else if (type === 'windows') {@@ -2189,10 +2189,10 @@ function createEnhancedClaudeMdFallback() {## Quick Start-1. Add MCP server: \`claude mcp add claude-flow npx claude-flow mcp start\`-2. Initialize swarm: \`mcp__claude-flow__swarm_init { topology: "hierarchical" }\`-3. Spawn agents: \`mcp__claude-flow__agent_spawn { type: "coder" }\`-4. Orchestrate: \`mcp__claude-flow__task_orchestrate { task: "Build feature" }\`+1. Add MCP server: \`claude mcp add claude-flow@alpha npx claude-flow@alpha mcp start\`+2. Initialize swarm: \`mcp__claude-flow@alpha__swarm_init { topology: "hierarchical" }\`+3. Spawn agents: \`mcp__claude-flow@alpha__agent_spawn { type: "coder" }\`+4. Orchestrate: \`mcp__claude-flow@alpha__task_orchestrate { task: "Build feature" }\`See full documentation in \`.claude/commands/\``;@@ -2212,7 +2212,7 @@ function createEnhancedSettingsJsonFallback() {},permissions: {allow: [- 'Bash(npx claude-flow *)',+ 'Bash(npx claude-flow@alpha *)','Bash(npm run lint)','Bash(npm run test:*)','Bash(npm test *)',@@ -2235,7 +2235,7 @@ function createEnhancedSettingsJsonFallback() {],deny: ['Bash(rm -rf /)', 'Bash(curl * | bash)', 'Bash(wget * | sh)', 'Bash(eval *)'],},- enabledMcpjsonServers: ['claude-flow', 'ruv-swarm'],+ enabledMcpjsonServers: ['claude-flow@alpha', 'ruv-swarm'],hooks: {PreToolUse: [{diff --git a/bin/init/templates/sparc-modes.js b/bin/init/templates/sparc-modes.jsindex 72357a1800..c51779bb20 100644--- a/bin/init/templates/sparc-modes.js+++ b/bin/init/templates/sparc-modes.js@@ -35,13 +35,13 @@ SPARC (Specification, Planning, Architecture, Review, Code) is a comprehensive d## Usage\`\`\`bash# Run a specific mode-./claude-flow sparc run <mode> "task description"+./claude-flow@alpha sparc run <mode> "task description"# List all modes-./claude-flow sparc modes+./claude-flow@alpha sparc modes# Get help for a mode-./claude-flow sparc help <mode>+./claude-flow@alpha sparc help <mode>\`\`\``;}@@ -68,13 +68,13 @@ Comprehensive analysis through distributed agent coordination.### Option 1: Using MCP Tools (Preferred in Claude Code)\`\`\`javascript-mcp__claude-flow__swarm_init {+mcp__claude-flow@alpha__swarm_init {topology: "mesh",strategy: "analysis",maxAgents: 6}-mcp__claude-flow__task_orchestrate {+mcp__claude-flow@alpha__task_orchestrate {task: "analyze system performance",strategy: "distributed"}@@ -83,7 +83,7 @@ mcp__claude-flow__task_orchestrate {### Option 2: Using NPX CLI (Fallback when MCP not available)\`\`\`bash# Use when running from terminal or MCP tools unavailable-npx claude-flow swarm "analyze system performance" --strategy analysis+npx claude-flow@alpha swarm "analyze system performance" --strategy analysis# For alpha featuresnpx claude-flow@alpha swarm "analyze system performance" --strategy analysis@@ -91,8 +91,8 @@ npx claude-flow@alpha swarm "analyze system performance" --strategy analysis### Option 3: Local Installation\`\`\`bash-# If claude-flow is installed locally-./claude-flow swarm "analyze system performance" --strategy analysis+# If claude-flow@alpha is installed locally+./claude-flow@alpha swarm "analyze system performance" --strategy analysis\`\`\`## Agent Roles@@ -118,13 +118,13 @@ Coordinated development through specialized agent teams.### Option 1: Using MCP Tools (Preferred in Claude Code)\`\`\`javascript-mcp__claude-flow__swarm_init {+mcp__claude-flow@alpha__swarm_init {topology: "hierarchical",strategy: "development",maxAgents: 8}-mcp__claude-flow__task_orchestrate {+mcp__claude-flow@alpha__task_orchestrate {task: "build feature X",strategy: "parallel"}@@ -133,7 +133,7 @@ mcp__claude-flow__task_orchestrate {### Option 2: Using NPX CLI (Fallback when MCP not available)\`\`\`bash# Use when running from terminal or MCP tools unavailable-npx claude-flow swarm "build feature X" --strategy development+npx claude-flow@alpha swarm "build feature X" --strategy development# For alpha featuresnpx claude-flow@alpha swarm "build feature X" --strategy development@@ -141,8 +141,8 @@ npx claude-flow@alpha swarm "build feature X" --strategy development### Option 3: Local Installation\`\`\`bash-# If claude-flow is installed locally-./claude-flow swarm "build feature X" --strategy development+# If claude-flow@alpha is installed locally+./claude-flow@alpha swarm "build feature X" --strategy development\`\`\`## Agent Roles@@ -166,7 +166,7 @@ function createExamplesStrategy() {### Research Swarm\`\`\`bash-./claude-flow swarm "research AI trends" \\+./claude-flow@alpha swarm "research AI trends" \\--strategy research \\--mode distributed \\--max-agents 6 \\@@ -175,7 +175,7 @@ function createExamplesStrategy() {### Development Swarm\`\`\`bash-./claude-flow swarm "build REST API" \\+./claude-flow@alpha swarm "build REST API" \\--strategy development \\--mode hierarchical \\--monitor \\@@ -184,7 +184,7 @@ function createExamplesStrategy() {### Analysis Swarm\`\`\`bash-./claude-flow swarm "analyze codebase" \\+./claude-flow@alpha swarm "analyze codebase" \\--strategy analysis \\--mode mesh \\--parallel \\@@ -203,13 +203,13 @@ System maintenance and updates through coordinated agents.### Option 1: Using MCP Tools (Preferred in Claude Code)\`\`\`javascript-mcp__claude-flow__swarm_init {+mcp__claude-flow@alpha__swarm_init {topology: "hierarchical",strategy: "maintenance",maxAgents: 5}-mcp__claude-flow__task_orchestrate {+mcp__claude-flow@alpha__task_orchestrate {task: "update dependencies",strategy: "sequential",priority: "high"@@ -219,7 +219,7 @@ mcp__claude-flow__task_orchestrate {### Option 2: Using NPX CLI (Fallback when MCP not available)\`\`\`bash# Use when running from terminal or MCP tools unavailable-npx claude-flow swarm "update dependencies" --strategy maintenance+npx claude-flow@alpha swarm "update dependencies" --strategy maintenance# For alpha featuresnpx claude-flow@alpha swarm "update dependencies" --strategy maintenance@@ -227,8 +227,8 @@ npx claude-flow@alpha swarm "update dependencies" --strategy maintenance### Option 3: Local Installation\`\`\`bash-# If claude-flow is installed locally-./claude-flow swarm "update dependencies" --strategy maintenance+# If claude-flow@alpha is installed locally+./claude-flow@alpha swarm "update dependencies" --strategy maintenance\`\`\`## Agent Roles@@ -254,13 +254,13 @@ Performance optimization through specialized analysis.### Option 1: Using MCP Tools (Preferred in Claude Code)\`\`\`javascript-mcp__claude-flow__swarm_init {+mcp__claude-flow@alpha__swarm_init {topology: "mesh",strategy: "optimization",maxAgents: 6}-mcp__claude-flow__task_orchestrate {+mcp__claude-flow@alpha__task_orchestrate {task: "optimize performance",strategy: "parallel"}@@ -269,7 +269,7 @@ mcp__claude-flow__task_orchestrate {### Option 2: Using NPX CLI (Fallback when MCP not available)\`\`\`bash# Use when running from terminal or MCP tools unavailable-npx claude-flow swarm "optimize performance" --strategy optimization+npx claude-flow@alpha swarm "optimize performance" --strategy optimization# For alpha featuresnpx claude-flow@alpha swarm "optimize performance" --strategy optimization@@ -277,8 +277,8 @@ npx claude-flow@alpha swarm "optimize performance" --strategy optimization### Option 3: Local Installation\`\`\`bash-# If claude-flow is installed locally-./claude-flow swarm "optimize performance" --strategy optimization+# If claude-flow@alpha is installed locally+./claude-flow@alpha swarm "optimize performance" --strategy optimization\`\`\`## Agent Roles@@ -305,13 +305,13 @@ Deep research through parallel information gathering.### Option 1: Using MCP Tools (Preferred in Claude Code)\`\`\`javascript-mcp__claude-flow__swarm_init {+mcp__claude-flow@alpha__swarm_init {topology: "distributed",strategy: "research",maxAgents: 6}-mcp__claude-flow__task_orchestrate {+mcp__claude-flow@alpha__task_orchestrate {task: "research topic X",strategy: "parallel"}@@ -320,7 +320,7 @@ mcp__claude-flow__task_orchestrate {### Option 2: Using NPX CLI (Fallback when MCP not available)\`\`\`bash# Use when running from terminal or MCP tools unavailable-npx claude-flow swarm "research topic X" --strategy research+npx claude-flow@alpha swarm "research topic X" --strategy research# For alpha featuresnpx claude-flow@alpha swarm "research topic X" --strategy research@@ -328,8 +328,8 @@ npx claude-flow@alpha swarm "research topic X" --strategy research### Option 3: Local Installation\`\`\`bash-# If claude-flow is installed locally-./claude-flow swarm "research topic X" --strategy research+# If claude-flow@alpha is installed locally+./claude-flow@alpha swarm "research topic X" --strategy research\`\`\`## Agent Roles@@ -355,13 +355,13 @@ Comprehensive testing through distributed execution.### Option 1: Using MCP Tools (Preferred in Claude Code)\`\`\`javascript-mcp__claude-flow__swarm_init {+mcp__claude-flow@alpha__swarm_init {topology: "distributed",strategy: "testing",maxAgents: 5}-mcp__claude-flow__task_orchestrate {+mcp__claude-flow@alpha__task_orchestrate {task: "test application",strategy: "parallel"}@@ -370,7 +370,7 @@ mcp__claude-flow__task_orchestrate {### Option 2: Using NPX CLI (Fallback when MCP not available)\`\`\`bash# Use when running from terminal or MCP tools unavailable-npx claude-flow swarm "test application" --strategy testing+npx claude-flow@alpha swarm "test application" --strategy testing# For alpha featuresnpx claude-flow@alpha swarm "test application" --strategy testing@@ -378,8 +378,8 @@ npx claude-flow@alpha swarm "test application" --strategy testing### Option 3: Local Installation\`\`\`bash-# If claude-flow is installed locally-./claude-flow swarm "test application" --strategy testing+# If claude-flow@alpha is installed locally+./claude-flow@alpha swarm "test application" --strategy testing\`\`\`## Agent Roles@@ -428,7 +428,7 @@ Deep code and data analysis with batch processing capabilities.### Option 1: Using MCP Tools (Preferred in Claude Code)\`\`\`javascript-mcp__claude-flow__sparc_mode {+mcp__claude-flow@alpha__sparc_mode {mode: "analyzer",task_description: "analyze codebase performance",options: {@@ -441,7 +441,7 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)\`\`\`bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run analyzer "analyze codebase performance"+npx claude-flow@alpha sparc run analyzer "analyze codebase performance"# For alpha featuresnpx claude-flow@alpha sparc run analyzer "analyze codebase performance"@@ -449,8 +449,8 @@ npx claude-flow@alpha sparc run analyzer "analyze codebase performance"### Option 3: Local Installation\`\`\`bash-# If claude-flow is installed locally-./claude-flow sparc run analyzer "analyze codebase performance"+# If claude-flow@alpha is installed locally+./claude-flow@alpha sparc run analyzer "analyze codebase performance"\`\`\`## Core Capabilities@@ -484,7 +484,7 @@ System design with Memory-based coordination for scalable architectures.### Option 1: Using MCP Tools (Preferred in Claude Code)\`\`\`javascript-mcp__claude-flow__sparc_mode {+mcp__claude-flow@alpha__sparc_mode {mode: "architect",task_description: "design microservices architecture",options: {@@ -497,7 +497,7 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)\`\`\`bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run architect "design microservices architecture"+npx claude-flow@alpha sparc run architect "design microservices architecture"# For alpha featuresnpx claude-flow@alpha sparc run architect "design microservices architecture"@@ -505,8 +505,8 @@ npx claude-flow@alpha sparc run architect "design microservices architecture"### Option 3: Local Installation\`\`\`bash-# If claude-flow is installed locally-./claude-flow sparc run architect "design microservices architecture"+# If claude-flow@alpha is installed locally+./claude-flow@alpha sparc run architect "design microservices architecture"\`\`\`## Core Capabilities@@ -541,7 +541,7 @@ Parallel task execution specialist using batch operations.### Option 1: Using MCP Tools (Preferred in Claude Code)\`\`\`javascript-mcp__claude-flow__sparc_mode {+mcp__claude-flow@alpha__sparc_mode {mode: "batch-executor",task_description: "process multiple files",options: {@@ -554,7 +554,7 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)\`\`\`bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run batch-executor "process multiple files"+npx claude-flow@alpha sparc run batch-executor "process multiple files"# For alpha featuresnpx claude-flow@alpha sparc run batch-executor "process multiple files"@@ -562,8 +562,8 @@ npx claude-flow@alpha sparc run batch-executor "process multiple files"### Option 3: Local Installation\`\`\`bash-# If claude-flow is installed locally-./claude-flow sparc run batch-executor "process multiple files"+# If claude-flow@alpha is installed locally+./claude-flow@alpha sparc run batch-executor "process multiple files"\`\`\`## Core Capabilities@@ -599,7 +599,7 @@ Autonomous code generation with batch file operations.### Option 1: Using MCP Tools (Preferred in Claude Code)\`\`\`javascript-mcp__claude-flow__sparc_mode {+mcp__claude-flow@alpha__sparc_mode {mode: "coder",task_description: "implement user authentication",options: {@@ -612,7 +612,7 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)\`\`\`bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run coder "implement user authentication"+npx claude-flow@alpha sparc run coder "implement user authentication"# For alpha featuresnpx claude-flow@alpha sparc run coder "implement user authentication"@@ -620,8 +620,8 @@ npx claude-flow@alpha sparc run coder "implement user authentication"### Option 3: Local Installation\`\`\`bash-# If claude-flow is installed locally-./claude-flow sparc run coder "implement user authentication"+# If claude-flow@alpha is installed locally+./claude-flow@alpha sparc run coder "implement user authentication"\`\`\`## Core Capabilities@@ -657,7 +657,7 @@ Systematic debugging with TodoWrite and Memory integration.### Option 1: Using MCP Tools (Preferred in Claude Code)\`\`\`javascript-mcp__claude-flow__sparc_mode {+mcp__claude-flow@alpha__sparc_mode {mode: "debugger",task_description: "fix authentication issues",options: {@@ -670,7 +670,7 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)\`\`\`bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run debugger "fix authentication issues"+npx claude-flow@alpha sparc run debugger "fix authentication issues"# For alpha featuresnpx claude-flow@alpha sparc run debugger "fix authentication issues"@@ -678,8 +678,8 @@ npx claude-flow@alpha sparc run debugger "fix authentication issues"### Option 3: Local Installation\`\`\`bash-# If claude-flow is installed locally-./claude-flow sparc run debugger "fix authentication issues"+# If claude-flow@alpha is installed locally+./claude-flow@alpha sparc run debugger "fix authentication issues"\`\`\`## Core Capabilities@@ -715,7 +715,7 @@ UI/UX design with Memory coordination for consistent experiences.### Option 1: Using MCP Tools (Preferred in Claude Code)\`\`\`javascript-mcp__claude-flow__sparc_mode {+mcp__claude-flow@alpha__sparc_mode {mode: "designer",task_description: "create dashboard UI",options: {@@ -728,7 +728,7 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)\`\`\`bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run designer "create dashboard UI"+npx claude-flow@alpha sparc run designer "create dashboard UI"# For alpha featuresnpx claude-flow@alpha sparc run designer "create dashboard UI"@@ -736,8 +736,8 @@ npx claude-flow@alpha sparc run designer "create dashboard UI"### Option 3: Local Installation\`\`\`bash-# If claude-flow is installed locally-./claude-flow sparc run designer "create dashboard UI"+# If claude-flow@alpha is installed locally+./claude-flow@alpha sparc run designer "create dashboard UI"\`\`\`## Core Capabilities@@ -772,7 +772,7 @@ Documentation with batch file operations for comprehensive docs.### Option 1: Using MCP Tools (Preferred in Claude Code)\`\`\`javascript-mcp__claude-flow__sparc_mode {+mcp__claude-flow@alpha__sparc_mode {mode: "documenter",task_description: "create API documentation",options: {@@ -785,7 +785,7 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)\`\`\`bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run documenter "create API documentation"+npx claude-flow@alpha sparc run documenter "create API documentation"# For alpha featuresnpx claude-flow@alpha sparc run documenter "create API documentation"@@ -793,8 +793,8 @@ npx claude-flow@alpha sparc run documenter "create API documentation"### Option 3: Local Installation\`\`\`bash-# If claude-flow is installed locally-./claude-flow sparc run documenter "create API documentation"+# If claude-flow@alpha is installed locally+./claude-flow@alpha sparc run documenter "create API documentation"\`\`\`## Core Capabilities@@ -830,7 +830,7 @@ Creative problem solving with WebSearch and Memory integration.### Option 1: Using MCP Tools (Preferred in Claude Code)\`\`\`javascript-mcp__claude-flow__sparc_mode {+mcp__claude-flow@alpha__sparc_mode {mode: "innovator",task_description: "innovative solutions for scaling",options: {@@ -843,7 +843,7 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)\`\`\`bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run innovator "innovative solutions for scaling"+npx claude-flow@alpha sparc run innovator "innovative solutions for scaling"# For alpha featuresnpx claude-flow@alpha sparc run innovator "innovative solutions for scaling"@@ -851,8 +851,8 @@ npx claude-flow@alpha sparc run innovator "innovative solutions for scaling"### Option 3: Local Installation\`\`\`bash-# If claude-flow is installed locally-./claude-flow sparc run innovator "innovative solutions for scaling"+# If claude-flow@alpha is installed locally+./claude-flow@alpha sparc run innovator "innovative solutions for scaling"\`\`\`## Core Capabilities@@ -888,7 +888,7 @@ Knowledge management with Memory tools for persistent insights.### Option 1: Using MCP Tools (Preferred in Claude Code)\`\`\`javascript-mcp__claude-flow__sparc_mode {+mcp__claude-flow@alpha__sparc_mode {mode: "memory-manager",task_description: "organize project knowledge",options: {@@ -901,7 +901,7 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)\`\`\`bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run memory-manager "organize project knowledge"+npx claude-flow@alpha sparc run memory-manager "organize project knowledge"# For alpha featuresnpx claude-flow@alpha sparc run memory-manager "organize project knowledge"@@ -909,8 +909,8 @@ npx claude-flow@alpha sparc run memory-manager "organize project knowledge"### Option 3: Local Installation\`\`\`bash-# If claude-flow is installed locally-./claude-flow sparc run memory-manager "organize project knowledge"+# If claude-flow@alpha is installed locally+./claude-flow@alpha sparc run memory-manager "organize project knowledge"\`\`\`## Core Capabilities@@ -946,7 +946,7 @@ Performance optimization with systematic analysis and improvements.### Option 1: Using MCP Tools (Preferred in Claude Code)\`\`\`javascript-mcp__claude-flow__sparc_mode {+mcp__claude-flow@alpha__sparc_mode {mode: "optimizer",task_description: "optimize application performance",options: {@@ -959,7 +959,7 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)\`\`\`bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run optimizer "optimize application performance"+npx claude-flow@alpha sparc run optimizer "optimize application performance"# For alpha featuresnpx claude-flow@alpha sparc run optimizer "optimize application performance"@@ -967,8 +967,8 @@ npx claude-flow@alpha sparc run optimizer "optimize application performance"### Option 3: Local Installation\`\`\`bash-# If claude-flow is installed locally-./claude-flow sparc run optimizer "optimize application performance"+# If claude-flow@alpha is installed locally+./claude-flow@alpha sparc run optimizer "optimize application performance"\`\`\`## Core Capabilities@@ -1004,7 +1004,7 @@ Multi-agent task orchestration with TodoWrite/TodoRead/Task/Memory.### Option 1: Using MCP Tools (Preferred in Claude Code)\`\`\`javascript-mcp__claude-flow__sparc_mode {+mcp__claude-flow@alpha__sparc_mode {mode: "orchestrator",task_description: "coordinate feature development",options: {@@ -1017,7 +1017,7 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)\`\`\`bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run orchestrator "coordinate feature development"+npx claude-flow@alpha sparc run orchestrator "coordinate feature development"# For alpha featuresnpx claude-flow@alpha sparc run orchestrator "coordinate feature development"@@ -1025,8 +1025,8 @@ npx claude-flow@alpha sparc run orchestrator "coordinate feature development"### Option 3: Local Installation\`\`\`bash-# If claude-flow is installed locally-./claude-flow sparc run orchestrator "coordinate feature development"+# If claude-flow@alpha is installed locally+./claude-flow@alpha sparc run orchestrator "coordinate feature development"\`\`\`## Core Capabilities@@ -1062,7 +1062,7 @@ Deep research with parallel WebSearch/WebFetch and Memory coordination.### Option 1: Using MCP Tools (Preferred in Claude Code)\`\`\`javascript-mcp__claude-flow__sparc_mode {+mcp__claude-flow@alpha__sparc_mode {mode: "researcher",task_description: "research AI trends 2024",options: {@@ -1075,7 +1075,7 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)\`\`\`bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run researcher "research AI trends 2024"+npx claude-flow@alpha sparc run researcher "research AI trends 2024"# For alpha featuresnpx claude-flow@alpha sparc run researcher "research AI trends 2024"@@ -1083,8 +1083,8 @@ npx claude-flow@alpha sparc run researcher "research AI trends 2024"### Option 3: Local Installation\`\`\`bash-# If claude-flow is installed locally-./claude-flow sparc run researcher "research AI trends 2024"+# If claude-flow@alpha is installed locally+./claude-flow@alpha sparc run researcher "research AI trends 2024"\`\`\`## Core Capabilities@@ -1120,7 +1120,7 @@ Code review using batch file analysis for comprehensive reviews.### Option 1: Using MCP Tools (Preferred in Claude Code)\`\`\`javascript-mcp__claude-flow__sparc_mode {+mcp__claude-flow@alpha__sparc_mode {mode: "reviewer",task_description: "review pull request #123",options: {@@ -1133,7 +1133,7 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)\`\`\`bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run reviewer "review pull request #123"+npx claude-flow@alpha sparc run reviewer "review pull request #123"# For alpha featuresnpx claude-flow@alpha sparc run reviewer "review pull request #123"@@ -1141,8 +1141,8 @@ npx claude-flow@alpha sparc run reviewer "review pull request #123"### Option 3: Local Installation\`\`\`bash-# If claude-flow is installed locally-./claude-flow sparc run reviewer "review pull request #123"+# If claude-flow@alpha is installed locally+./claude-flow@alpha sparc run reviewer "review pull request #123"\`\`\`## Core Capabilities@@ -1178,7 +1178,7 @@ Specialized swarm management with batch coordination capabilities.### Option 1: Using MCP Tools (Preferred in Claude Code)\`\`\`javascript-mcp__claude-flow__sparc_mode {+mcp__claude-flow@alpha__sparc_mode {mode: "swarm-coordinator",task_description: "manage development swarm",options: {@@ -1191,7 +1191,7 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)\`\`\`bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run swarm-coordinator "manage development swarm"+npx claude-flow@alpha sparc run swarm-coordinator "manage development swarm"# For alpha featuresnpx claude-flow@alpha sparc run swarm-coordinator "manage development swarm"@@ -1199,8 +1199,8 @@ npx claude-flow@alpha sparc run swarm-coordinator "manage development swarm"### Option 3: Local Installation\`\`\`bash-# If claude-flow is installed locally-./claude-flow sparc run swarm-coordinator "manage development swarm"+# If claude-flow@alpha is installed locally+./claude-flow@alpha sparc run swarm-coordinator "manage development swarm"\`\`\`## Core Capabilities@@ -1236,7 +1236,7 @@ Test-driven development with TodoWrite planning and comprehensive testing.### Option 1: Using MCP Tools (Preferred in Claude Code)\`\`\`javascript-mcp__claude-flow__sparc_mode {+mcp__claude-flow@alpha__sparc_mode {mode: "tdd",task_description: "shopping cart feature",options: {@@ -1249,7 +1249,7 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)\`\`\`bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run tdd "shopping cart feature"+npx claude-flow@alpha sparc run tdd "shopping cart feature"# For alpha featuresnpx claude-flow@alpha sparc run tdd "shopping cart feature"@@ -1257,8 +1257,8 @@ npx claude-flow@alpha sparc run tdd "shopping cart feature"### Option 3: Local Installation\`\`\`bash-# If claude-flow is installed locally-./claude-flow sparc run tdd "shopping cart feature"+# If claude-flow@alpha is installed locally+./claude-flow@alpha sparc run tdd "shopping cart feature"\`\`\`## Core Capabilities@@ -1294,7 +1294,7 @@ Comprehensive testing with parallel execution capabilities.### Option 1: Using MCP Tools (Preferred in Claude Code)\`\`\`javascript-mcp__claude-flow__sparc_mode {+mcp__claude-flow@alpha__sparc_mode {mode: "tester",task_description: "full regression suite",options: {@@ -1307,7 +1307,7 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)\`\`\`bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run tester "full regression suite"+npx claude-flow@alpha sparc run tester "full regression suite"# For alpha featuresnpx claude-flow@alpha sparc run tester "full regression suite"@@ -1315,8 +1315,8 @@ npx claude-flow@alpha sparc run tester "full regression suite"### Option 3: Local Installation\`\`\`bash-# If claude-flow is installed locally-./claude-flow sparc run tester "full regression suite"+# If claude-flow@alpha is installed locally+./claude-flow@alpha sparc run tester "full regression suite"\`\`\`## Core Capabilities@@ -1352,7 +1352,7 @@ Process automation with TodoWrite planning and Task execution.### Option 1: Using MCP Tools (Preferred in Claude Code)\`\`\`javascript-mcp__claude-flow__sparc_mode {+mcp__claude-flow@alpha__sparc_mode {mode: "workflow-manager",task_description: "automate deployment",options: {@@ -1365,7 +1365,7 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)\`\`\`bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run workflow-manager "automate deployment"+npx claude-flow@alpha sparc run workflow-manager "automate deployment"# For alpha featuresnpx claude-flow@alpha sparc run workflow-manager "automate deployment"@@ -1373,8 +1373,8 @@ npx claude-flow@alpha sparc run workflow-manager "automate deployment"### Option 3: Local Installation\`\`\`bash-# If claude-flow is installed locally-./claude-flow sparc run workflow-manager "automate deployment"+# If claude-flow@alpha is installed locally+./claude-flow@alpha sparc run workflow-manager "automate deployment"\`\`\`## Core Capabilitiesdiff --git a/bin/init/templates/verification-claude-md.js b/bin/init/templates/verification-claude-md.jsindex e2f9255f9c..afa1a57bd5 100644--- a/bin/init/templates/verification-claude-md.js+++ b/bin/init/templates/verification-claude-md.js@@ -18,32 +18,32 @@ This project enforces **"truth is enforced, not assumed"** with mandatory verifi### Initialize Verification System\`\`\`bash# Set verification mode (strict/moderate/development)-./claude-flow verify init strict # 95% threshold, auto-rollback-./claude-flow verify init moderate # 85% threshold, no auto-rollback-./claude-flow verify init development # 75% threshold, for prototyping+./claude-flow@alpha verify init strict # 95% threshold, auto-rollback+./claude-flow@alpha verify init moderate # 85% threshold, no auto-rollback+./claude-flow@alpha verify init development # 75% threshold, for prototyping\`\`\`### Run Verification\`\`\`bash# Verify specific tasks-./claude-flow verify verify task-123 --agent coder-./claude-flow verify verify task-456 --agent reviewer --threshold 0.90+./claude-flow@alpha verify verify task-123 --agent coder+./claude-flow@alpha verify verify task-456 --agent reviewer --threshold 0.90# Check truth scores-./claude-flow truth # View current truth scores-./claude-flow truth --report # Generate detailed report-./claude-flow truth --analyze # Analyze failure patterns+./claude-flow@alpha truth # View current truth scores+./claude-flow@alpha truth --report # Generate detailed report+./claude-flow@alpha truth --analyze # Analyze failure patterns\`\`\`### Pair Programming Mode\`\`\`bash# Start pair programming with real-time verification-./claude-flow pair --start # Begin collaborative session-./claude-flow pair --start --mode strict # Production-quality pairing-./claude-flow pair --verify --threshold 0.90 # Custom threshold+./claude-flow@alpha pair --start # Begin collaborative session+./claude-flow@alpha pair --start --mode strict # Production-quality pairing+./claude-flow@alpha pair --verify --threshold 0.90 # Custom threshold# Background monitoring (use run_in_background: true)-./claude-flow pair --start --monitor # Continuous monitoring dashboard+./claude-flow@alpha pair --start --monitor # Continuous monitoring dashboard\`\`\`## π VERIFICATION REQUIREMENTS BY AGENT TYPE@@ -76,7 +76,7 @@ This project enforces **"truth is enforced, not assumed"** with mandatory verifi// Use run_in_background parameter for continuous monitoring{"tool": "Bash",- "command": "./claude-flow pair --start --monitor",+ "command": "./claude-flow@alpha pair --start --monitor","run_in_background": true // Enables background execution}\`\`\`@@ -104,15 +104,15 @@ This project enforces **"truth is enforced, not assumed"** with mandatory verifi\`\`\`javascript[Single Message]:// Initialize verification for multiple tasks- - Bash("./claude-flow verify verify task-1 --agent coder")- - Bash("./claude-flow verify verify task-2 --agent reviewer")- - Bash("./claude-flow verify verify task-3 --agent tester")+ - Bash("./claude-flow@alpha verify verify task-1 --agent coder")+ - Bash("./claude-flow@alpha verify verify task-2 --agent reviewer")+ - Bash("./claude-flow@alpha verify verify task-3 --agent tester")// Check all truth scores- - Bash("./claude-flow truth --json")+ - Bash("./claude-flow@alpha truth --json")// Start monitoring in background- - Bash("./claude-flow pair --start --monitor", run_in_background: true)+ - Bash("./claude-flow@alpha pair --start --monitor", run_in_background: true)\`\`\`### β WRONG - Sequential Verification@@ -143,7 +143,7 @@ Message 3: Check truth score### 1. Start Session\`\`\`bash# Initialize pair programming with verification-./claude-flow pair --start --mode strict+./claude-flow@alpha pair --start --mode strict\`\`\`### 2. Real-time Verification Cycle@@ -167,7 +167,7 @@ Fail (<0.95) β Suggest fixes or rollback### 3. Continuous Monitoring\`\`\`bash# Monitor in background-./claude-flow pair --start --monitor &+./claude-flow@alpha pair --start --monitor &# Check verification output/bashes # Interactive view@@ -192,7 +192,7 @@ Fail (<0.95) β Suggest fixes or rollbackcat .swarm/verification-memory.json | jq .history# Check agent reliability-./claude-flow truth --agent coder --detailed+./claude-flow@alpha truth --agent coder --detailed\`\`\`## π QUICK START VERIFICATION WORKFLOW@@ -203,13 +203,13 @@ cat .swarm/verification-memory.json | jq .historynpx claude-flow@alpha init --verify --pair# Set up strict verification-./claude-flow verify init strict+./claude-flow@alpha verify init strict\`\`\`### Step 2: Start Development with Pair Programming\`\`\`bash# Start pair programming session-./claude-flow pair --start --mode strict --monitor &+./claude-flow@alpha pair --start --mode strict --monitor &# Monitor verification (background task)/bashes # Check bash_1 status@@ -225,10 +225,10 @@ npx claude-flow@alpha init --verify --pair### Step 4: Check Truth Metrics\`\`\`bash# View current truth scores-./claude-flow truth+./claude-flow@alpha truth# Generate detailed report-./claude-flow truth --report --export metrics.json+./claude-flow@alpha truth --report --export metrics.json\`\`\`## π VERIFICATION CHECKLIST@@ -249,10 +249,10 @@ Before ANY operation:- \`npm run typecheck\`: Type check with validation### Verification Commands-- \`./claude-flow verify status\`: Check system status-- \`./claude-flow verify verify <task>\`: Run verification-- \`./claude-flow truth\`: View truth scores-- \`./claude-flow pair --start\`: Begin pair programming+- \`./claude-flow@alpha verify status\`: Check system status+- \`./claude-flow@alpha verify verify <task>\`: Run verification+- \`./claude-flow@alpha truth\`: View truth scores+- \`./claude-flow@alpha pair --start\`: Begin pair programming## πΎ PERSISTENT VERIFICATION MEMORY@@ -303,17 +303,17 @@ Task("Validate", "Final verification", "production-validator")# .github/workflows/verification.yml- name: Run Verificationrun: |- npx claude-flow verify init strict- npx claude-flow verify verify \${{ github.run_id }}- npx claude-flow truth --threshold 0.95+ npx claude-flow@alpha verify init strict+ npx claude-flow@alpha verify verify \${{ github.run_id }}+ npx claude-flow@alpha truth --threshold 0.95\`\`\`### Pre-commit Hooks\`\`\`bash# .git/hooks/pre-commit#!/bin/bash-npx claude-flow verify verify pre-commit --agent coder-SCORE=\$(npx claude-flow truth --json | jq .averageScore)+npx claude-flow@alpha verify verify pre-commit --agent coder+SCORE=\$(npx claude-flow@alpha truth --json | jq .averageScore)if [ "\$SCORE" -lt "0.85" ]; thenecho "β Commit blocked: Truth score \$SCORE below threshold"exit 1@@ -322,10 +322,10 @@ fi## π DOCUMENTATION-- [Truth Verification System](https://github.com/ruvnet/claude-flow/wiki/Truth-Verification-System)-- [Pair Programming Guide](https://github.com/ruvnet/claude-flow/wiki/Pair-Programming-System)-- [Background Commands](https://github.com/ruvnet/claude-flow/wiki/background-commands)-- [Agent Verification](https://github.com/ruvnet/claude-flow/wiki/Agent-Verification)+- [Truth Verification System](https://github.com/ruvnet/claude-flow@alpha/wiki/Truth-Verification-System)+- [Pair Programming Guide](https://github.com/ruvnet/claude-flow@alpha/wiki/Pair-Programming-System)+- [Background Commands](https://github.com/ruvnet/claude-flow@alpha/wiki/background-commands)+- [Agent Verification](https://github.com/ruvnet/claude-flow@alpha/wiki/Agent-Verification)## π¨ IMPORTANT REMINDERS@@ -397,9 +397,9 @@ export function createVerificationSettingsJson() {"autoBackground": {"enabled": true,"patterns": [- "./claude-flow pair --start",- "./claude-flow verify verify",- "./claude-flow truth --monitor",+ "./claude-flow@alpha pair --start",+ "./claude-flow@alpha verify verify",+ "./claude-flow@alpha truth --monitor","*--monitor*","*--watch*"]@@ -417,15 +417,15 @@ export function createVerificationSettingsJson() {"pre-commit": {"enabled": true,"commands": [- "npx claude-flow verify verify pre-commit --agent coder"+ "npx claude-flow@alpha verify verify pre-commit --agent coder"],"threshold": 0.85},"post-task": {"enabled": true,"commands": [- "npx claude-flow truth --json",- "npx claude-flow verify status"+ "npx claude-flow@alpha truth --json",+ "npx claude-flow@alpha verify status"]}}diff --git a/package.json b/package.jsonindex 524964ba18..12533ec966 100644--- a/package.json+++ b/package.json@@ -1,6 +1,6 @@{"name": "claude-flow",- "version": "2.0.0",+ "version": "2.0.0-alpha.118","description": "Enterprise-grade AI agent orchestration with ruv-swarm integration","mcpName": "io.github.ruvnet/claude-flow","main": "cli.mjs",diff --git a/src/cli/help-text.js b/src/cli/help-text.jsindex 627b2db896..6a8b295b15 100644--- a/src/cli/help-text.js+++ b/src/cli/help-text.js@@ -24,9 +24,9 @@ export const MAIN_HELP = `π§ Production-Ready Infrastructure - Enterprise-grade reliability and performanceUSAGE:- npx claude-flow@alpha <command> [options] # Run latest alpha version- npx claude-flow@alpha <command> --help # Get detailed help for any command- npx claude-flow@alpha --help # Show this help+ npx claude-flow <command> [options] # Run latest alpha version+ npx claude-flow <command> --help # Get detailed help for any command+ npx claude-flow --help # Show this help# After local install:claude-flow <command> [options]@@ -34,7 +34,7 @@ USAGE:π QUICK START:# First time setup (creates CLAUDE.md & .claude/commands)- npx claude-flow@alpha init+ npx claude-flow init# π FLOW NEXUS CLOUD (NEW!):mcp__flow-nexus__user_register # Register for cloud features@@ -92,14 +92,14 @@ USAGE:stream-chain <workflow> Stream-JSON chaining for multi-agent pipelines (NEW!)π GET HELP:- npx claude-flow@alpha --help Show this help- npx claude-flow@alpha <command> --help Detailed command help+ npx claude-flow --help Show this help+ npx claude-flow <command> --help Detailed command helpπ― RECOMMENDED FOR NEW USERS:- npx claude-flow@alpha hive-mind wizard # Start here! Interactive guided setup- npx claude-flow@alpha init # Initialize Claude Flow- npx claude-flow@alpha help hive-mind # Learn about Hive Mind features- npx claude-flow@alpha swarm "Build API" --claude # Quick start with Claude Code CLI+ npx claude-flow hive-mind wizard # Start here! Interactive guided setup+ npx claude-flow init # Initialize Claude Flow+ npx claude-flow help hive-mind # Learn about Hive Mind features+ npx claude-flow swarm "Build API" --claude # Quick start with Claude Code CLIπ Documentation: https://github.com/ruvnet/claude-flowπ Hive Mind Guide: https://github.com/ruvnet/claude-flow/tree/main/docs/hive-mind@@ -451,8 +451,8 @@ WHAT claude-flow init CREATES (DEFAULT):β’ Enterprise security featuresEXAMPLES:- npx claude-flow@alpha init # Standard init with local checkpoints- npx claude-flow@alpha github init # GitHub-enhanced init with releases+ npx claude-flow init # Standard init with local checkpoints+ npx claude-flow github init # GitHub-enhanced init with releasesclaude-flow init --force # Overwrite existing configurationclaude-flow github init --force # Force GitHub mode (overwrite)claude-flow init --dry-run # Preview what will be created@@ -1021,7 +1021,7 @@ export function getMainHelp(plain = false) {},],examples: [- 'npx claude-flow@alpha init',+ 'npx claude-flow init','claude-flow hive-mind wizard','claude-flow swarm "Build REST API"','claude-flow agent spawn researcher --name "Research Bot"',diff --git a/src/cli/simple-commands/init/index.js b/src/cli/simple-commands/init/index.jsindex cadab47967..555599eb67 100644--- a/src/cli/simple-commands/init/index.js+++ b/src/cli/simple-commands/init/index.js@@ -101,7 +101,7 @@ async function setupMcpServers(dryRun = false) {const servers = [{- name: 'claude-flow',+ name: 'claude-flow@alpha',command: 'npx claude-flow@alpha mcp start',description: 'Claude Flow MCP server with swarm orchestration (alpha)',},@@ -329,11 +329,11 @@ export async function initCommand(subArgs, flags) {// Memory README files and persistence database are created by template copier- // Create local claude-flow executable wrapper+ // Create local claude-flow@alpha executable wrapperif (!initDryRun) {await createLocalExecutable(workingDir);} else {- console.log(' [DRY RUN] Would create local claude-flow executable wrapper');+ console.log(' [DRY RUN] Would create local claude-flow@alpha executable wrapper');}// SPARC initialization@@ -412,7 +412,7 @@ export async function initCommand(subArgs, flags) {);console.log(' β’ Core files: CLAUDE.md, memory-bank.md, coordination.md');console.log(' β’ Directory structure: memory/, coordination/, .claude/');- console.log(' β’ Local executable: ./claude-flow');+ console.log(' β’ Local executable: ./claude-flow@alpha');if (initSparc) {console.log(` β’ Claude Code slash commands: ${selectedModes ? selectedModes.length : 'All'} SPARC mode commands`,@@ -445,8 +445,8 @@ export async function initCommand(subArgs, flags) {` β coordination.md (${initOptimized ? 'Enhanced with batchtools' : 'Standard coordination'})`,);console.log(' β Directory structure with memory/ and coordination/');- console.log(' β Local executable at ./claude-flow');- console.log(' β Persistence database at memory/claude-flow-data.json');+ console.log(' β Local executable at ./claude-flow@alpha');+ console.log(' β Persistence database at memory/[email protected]');console.log(' β Agent system with 64 specialized agents in .claude/agents/');if (initSparc) {@@ -457,21 +457,21 @@ export async function initCommand(subArgs, flags) {console.log('\nπ Next steps:');console.log('1. Review and customize the generated files for your project');- console.log("2. Run './claude-flow start' to begin the orchestration system");- console.log("3. Use './claude-flow' instead of 'npx claude-flow' for all commands");+ console.log("2. Run './claude-flow@alpha start' to begin the orchestration system");+ console.log("3. Use './claude-flow@alpha' instead of 'npx claude-flow@alpha' for all commands");console.log("4. Use 'claude --dangerously-skip-permissions' for unattended operation");if (initSparc) {console.log('5. Use Claude Code slash commands: /sparc, /sparc-architect, /sparc-tdd, etc.',);- console.log("6. Explore SPARC modes with './claude-flow sparc modes'");- console.log('7. Try TDD workflow with \'./claude-flow sparc tdd "your task"\'');+ console.log("6. Explore SPARC modes with './claude-flow@alpha sparc modes'");+ console.log('7. Try TDD workflow with \'./claude-flow@alpha sparc tdd "your task"\'');if (initOptimized) {console.log('8. Use batchtools commands: /batchtools, /performance for optimization');console.log('9. Enable parallel processing with --parallel flags');- console.log("10. Monitor performance with './claude-flow performance monitor'");+ console.log("10. Monitor performance with './claude-flow@alpha performance monitor'");}}@@ -489,8 +489,8 @@ export async function initCommand(subArgs, flags) {console.log('\nπ‘ Tips:');console.log(" β’ Type '/' in Claude Code to see all available slash commands");- console.log(" β’ Use './claude-flow status' to check system health");- console.log(" β’ Store important context with './claude-flow memory store'");+ console.log(" β’ Use './claude-flow@alpha status' to check system health");+ console.log(" β’ Store important context with './claude-flow@alpha memory store'");if (initOptimized) {console.log(' β’ Use --parallel flags for concurrent operations');@@ -537,7 +537,7 @@ export async function initCommand(subArgs, flags) {console.log('\nβ οΈ Claude Code CLI not detected!');console.log(' π₯ Install with: npm install -g @anthropic-ai/claude-code');console.log(' π Then add MCP servers manually with:');- console.log(' claude mcp add claude-flow claude-flow mcp start');+ console.log(' claude mcp add claude-flow@alpha claude-flow@alpha mcp start');console.log(' claude mcp add ruv-swarm npx ruv-swarm mcp start');console.log(' claude mcp add flow-nexus npx flow-nexus@latest mcp start');}@@ -984,7 +984,7 @@ async function setupMemorySystem(workingDir, dryRun = false) {if (!dryRun) {const initialData = { agents: [], tasks: [], lastUpdated: Date.now() };await fs.writeFile(- `${workingDir}/memory/claude-flow-data.json`, JSON.stringify(initialData, null, 2), 'utf8'+ `${workingDir}/memory/[email protected]`, JSON.stringify(initialData, null, 2), 'utf8');await fs.writeFile(`${workingDir}/memory/agents/README.md`, createAgentsReadme(), 'utf8');@@ -1007,8 +1007,8 @@ async function setupMonitoring(workingDir) {const path = await import('path');try {- // Create .claude-flow directory for tracking data- const trackingDir = path.join(workingDir, '.claude-flow');+ // Create .claude-flow@alpha directory for tracking data+ const trackingDir = path.join(workingDir, '.claude-flow@alpha');await fs.mkdir(trackingDir, { recursive: true });// Create initial token usage file@@ -1063,7 +1063,7 @@ async function setupMonitoring(workingDir) {sessions: true},storage: {- location: '.claude-flow/token-usage.json',+ location: '.claude-flow@alpha/token-usage.json',format: 'json',rotation: 'monthly'}@@ -1089,9 +1089,9 @@ export CLAUDE_CODE_ENABLE_TELEMETRY=1console.log('\n π To enable Claude Code telemetry:');console.log(' 1. Add to your shell profile: export CLAUDE_CODE_ENABLE_TELEMETRY=1');- console.log(' 2. Or run: source .claude-flow/env-setup.sh');- console.log('\n π‘ Token usage will be tracked in .claude-flow/token-usage.json');- console.log(' Run: claude-flow analysis token-usage --breakdown --cost-analysis');+ console.log(' 2. Or run: source .claude-flow@alpha/env-setup.sh');+ console.log('\n π‘ Token usage will be tracked in .claude-flow@alpha/token-usage.json');+ console.log(' Run: claude-flow@alpha analysis token-usage --breakdown --cost-analysis');} catch (err) {printError(` Failed to setup monitoring: ${err.message}`);@@ -1124,7 +1124,7 @@ async function enhancedClaudeFlowInit(flags, subArgs = []) {'CLAUDE.md','.claude/settings.json','.mcp.json',- 'claude-flow.config.json',+ '[email protected]',];for (const file of filesToCheck) {@@ -1169,7 +1169,7 @@ async function enhancedClaudeFlowInit(flags, subArgs = []) {// Create settings.local.json with default MCP permissionsconst settingsLocal = {permissions: {- allow: ['mcp__ruv-swarm', 'mcp__claude-flow', 'mcp__flow-nexus'],+ allow: ['mcp__ruv-swarm', 'mcp__claude-flow@alpha', 'mcp__flow-nexus'],deny: [],},};@@ -1188,7 +1188,7 @@ async function enhancedClaudeFlowInit(flags, subArgs = []) {// Create .mcp.json at project root for MCP server configurationconst mcpConfig = {mcpServers: {- 'claude-flow': {+ 'claude-flow@alpha': {command: 'npx',args: ['claude-flow@alpha', 'mcp', 'start'],type: 'stdio',@@ -1213,7 +1213,7 @@ async function enhancedClaudeFlowInit(flags, subArgs = []) {console.log('[DRY RUN] Would create .mcp.json at project root for MCP server configuration');}- // Create claude-flow.config.json for Claude Flow specific settings+ // Create [email protected] for Claude Flow specific settingsconst claudeFlowConfig = {features: {autoTopologySelection: true,@@ -1237,11 +1237,11 @@ async function enhancedClaudeFlowInit(flags, subArgs = []) {if (!dryRun) {await fs.writeFile(- `${workingDir}/claude-flow.config.json`, JSON.stringify(claudeFlowConfig, null, 2, 'utf8'),+ `${workingDir}/[email protected]`, JSON.stringify(claudeFlowConfig, null, 2, 'utf8'),);- printSuccess('β Created claude-flow.config.json for Claude Flow settings');+ printSuccess('β Created [email protected] for Claude Flow settings');} else {- console.log('[DRY RUN] Would create claude-flow.config.json for Claude Flow settings');+ console.log('[DRY RUN] Would create [email protected] for Claude Flow settings');}// Create command documentation@@ -1280,14 +1280,14 @@ ${commands.map((cmd) => `- [${cmd}](./${cmd}.md)`).join('\n')}if (!dryRun) {// Unix wrapper - now uses universal ES module compatible wrapperconst unixWrapper = createWrapperScript('unix');- await fs.writeFile(`${workingDir}/claude-flow`, unixWrapper, 'utf8');- await fs.chmod(`${workingDir}/claude-flow`, 0o755);+ await fs.writeFile(`${workingDir}/claude-flow@alpha`, unixWrapper, 'utf8');+ await fs.chmod(`${workingDir}/claude-flow@alpha`, 0o755);// Windows wrapper- await fs.writeFile(`${workingDir}/claude-flow.bat`, createWrapperScript('windows', 'utf8'));+ await fs.writeFile(`${workingDir}/[email protected]`, createWrapperScript('windows', 'utf8'));// PowerShell wrapper- await fs.writeFile(`${workingDir}/claude-flow.ps1`, createWrapperScript('powershell', 'utf8'));+ await fs.writeFile(`${workingDir}/[email protected]`, createWrapperScript('powershell', 'utf8'));printSuccess('β Created platform-specific wrapper scripts');} else {@@ -1338,7 +1338,7 @@ ${commands.map((cmd) => `- [${cmd}](./${cmd}.md)`).join('\n')}// Initialize memory systemconst initialData = { agents: [], tasks: [], lastUpdated: Date.now() };await fs.writeFile(- `${workingDir}/memory/claude-flow-data.json`, JSON.stringify(initialData, null, 2, 'utf8'),+ `${workingDir}/memory/[email protected]`, JSON.stringify(initialData, null, 2, 'utf8'),);// Create README files@@ -1451,7 +1451,7 @@ ${commands.map((cmd) => `- [${cmd}](./${cmd}.md)`).join('\n')}} else {console.log(' βΉοΈ Skipping MCP setup (--skip-mcp flag used)');console.log('\n π To add MCP servers manually:');- console.log(' claude mcp add claude-flow npx claude-flow@alpha mcp start');+ console.log(' claude mcp add claude-flow@alpha npx claude-flow@alpha mcp start');console.log(' claude mcp add ruv-swarm npx ruv-swarm@latest mcp start');console.log(' claude mcp add flow-nexus npx flow-nexus@latest mcp start');console.log('\n π‘ MCP servers are defined in .mcp.json (project scope)');@@ -1461,7 +1461,7 @@ ${commands.map((cmd) => `- [${cmd}](./${cmd}.md)`).join('\n')}console.log('\n π₯ To install Claude Code:');console.log(' npm install -g @anthropic-ai/claude-code');console.log('\n π After installing, add MCP servers:');- console.log(' claude mcp add claude-flow npx claude-flow@alpha mcp start');+ console.log(' claude mcp add claude-flow@alpha npx claude-flow@alpha mcp start');console.log(' claude mcp add ruv-swarm npx ruv-swarm@latest mcp start');console.log(' claude mcp add flow-nexus npx flow-nexus@latest mcp start');console.log('\n π‘ MCP servers are defined in .mcp.json (project scope)');