Skip to content

armgit / ruflo

Public Imported from GitHub
0

🌊 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

chore: revert to alpha.118 release with sublinear removal

rUv54081fe4e3ea
diff --git a/.claude-flow/metrics/performance.json b/.claude-flow/metrics/performance.json
index 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.json
index 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 file
diff --git a/.claude-flow/metrics/task-metrics.json b/.claude-flow/metrics/task-metrics.json
index 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 file
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 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 initialization
diff --git a/CLAUDE.md b/CLAUDE.md
index 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 start
claude mcp add ruv-swarm npx ruv-swarm mcp start # Optional: Enhanced coordination
claude 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_init
Message 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-flow
index 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 invoked
if [ -L "$0" ]; then
diff --git a/bin/init/claude-commands/sparc-commands.js b/bin/init/claude-commands/sparc-commands.js
index 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 features
npx 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 features
npx 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" --namespace
For 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 Mode
For 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.js
index 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.js
index 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 wrapper
if (!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=1
console.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',
];
for (const file of filesToCheck) {
@@ -1197,7 +1197,7 @@ async function enhancedClaudeFlowInit(flags, subArgs = []) {
// Create settings.local.json with default MCP permissions
const 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 configuration
const 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 settings
const 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 wrapper
const 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 system
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'),
);
// 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.md
index 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 instructions
5. **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 parallel
Task("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_init
Message 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 message
2. **EXECUTE TASKS IN PARALLEL** - Never wait for one task before starting another
3. **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-decide
strategy: "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_usage
action: "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_usage
action: "retrieve"
key: "swarm-{id}/agent-{name}/{step}"
// To check all swarm progress
-mcp__claude-flow__memory_usage
+mcp__claude-flow@alpha__memory_usage
action: "list"
pattern: "swarm-{id}/*"
```
@@ -1093,7 +1093,7 @@ mcp__claude-flow__memory_usage
1. **Batch Everything**: Never operate on single files when multiple are needed
2. **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 tracking
5. **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.js
index 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 Info
This 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 Commands
1. 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 start
claude mcp add ruv-swarm npx ruv-swarm mcp start # Optional: Enhanced coordination
claude 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_init
Message 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 templates
diff --git a/bin/init/templates/enhanced-templates.js b/bin/init/templates/enhanced-templates.js
index 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 modules
if (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.
### Hierarchical
Queen-led with worker specialization
\`\`\`bash
-npx claude-flow swarm init --topology hierarchical
+npx claude-flow@alpha swarm init --topology hierarchical
\`\`\`
### Mesh
Peer-to-peer collaboration
\`\`\`bash
-npx claude-flow swarm init --topology mesh
+npx claude-flow@alpha swarm init --topology mesh
\`\`\`
### Adaptive
Dynamic 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 server
echo "πŸ“¦ 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 start
echo "βœ… 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 @@ fi
echo ""
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@alpha
const strategies = [
// 1. Local node_modules
async () => {
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.js
index 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 features
npx 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 features
npx 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 features
npx 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 features
npx 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 features
npx 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 features
npx 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 features
npx 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 features
npx 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 features
npx 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 features
npx 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 features
npx 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 features
npx 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 features
npx 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 features
npx 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 features
npx 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 features
npx 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 features
npx 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 features
npx 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 features
npx 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 features
npx 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 features
npx 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 features
npx 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 features
npx 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 Capabilities
diff --git a/bin/init/templates/verification-claude-md.js b/bin/init/templates/verification-claude-md.js
index 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 rollback
cat .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 .history
npx 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 Verification
run: |
- 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" ]; then
echo "❌ 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.json
index 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.js
index 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 performance
USAGE:
- 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 features
EXAMPLES:
- 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 releases
claude-flow init --force # Overwrite existing configuration
claude-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.js
index 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 wrapper
if (!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=1
console.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',
];
for (const file of filesToCheck) {
@@ -1169,7 +1169,7 @@ async function enhancedClaudeFlowInit(flags, subArgs = []) {
// Create settings.local.json with default MCP permissions
const 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 configuration
const 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 settings
const 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 wrapper
const 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 system
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'),
);
// 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)');