claude-flow 1.0.21 → 1.0.23

package/README.md

@@ -67,8 +67,8 @@ Advanced CRDT-based memory system with SQLite performance and Markdown readabili
 </td>
 <td width="33%" align="center">
 
-### ⚡ **Terminal Virtualization**
-Native VSCode integration with terminal pooling, session recycling, and cross-platform shell support (Bash, Zsh, PowerShell, CMD).
+### ⚡ **Enhanced Claude Integration**
+Spawn Claude instances with comprehensive Claude-Flow guidance, teaching them to use memory, coordination, and system commands effectively.
 
 </td>
 </tr>
@@ -138,6 +138,7 @@ Comprehensive documentation is available to help you get the most out of Claude-
 - **[Terminal Management](./docs/08-terminal-management.md)** - Terminal pooling and sessions
 - **[Troubleshooting](./docs/09-troubleshooting.md)** - Common issues and solutions
 - **[Advanced Usage](./docs/10-advanced-usage.md)** - Power user features
+- **[Claude Spawning](./docs/11-claude-spawning.md)** - Spawning Claude instances
 - **[CLI Reference](./docs/cli-reference.md)** - Complete command documentation
 
 ## 💡 **Quick Start Guide**
@@ -179,16 +180,29 @@ npx claude-flow task list --verbose
 
 ### 5. **Spawn Claude Instances** 🆕
 ```bash
-# Spawn Claude with specific configuration
+# Spawn Claude with enhanced Claude-Flow guidance
 npx claude-flow claude spawn "implement user authentication" --research --parallel
 
-# Run with custom tools
-npx claude-flow claude spawn "fix payment bug" --tools "View,Edit,Bash" --no-permissions
+# Backend-only mode with high coverage
+npx claude-flow claude spawn "create REST API" --mode backend-only --coverage 95
+
+# Frontend development with feature commits
+npx claude-flow claude spawn "build React components" --mode frontend-only --commit feature
+
+# Full stack with all options
+npx claude-flow claude spawn "build complete app" --research --parallel --coverage 90 --verbose
 
 # Execute batch workflow
 npx claude-flow claude batch examples/claude-workflow.json --dry-run
 ```
 
+**Enhanced Claude Instances receive:**
+- Detailed Claude-Flow system guidance
+- Proper `npx claude-flow` command syntax
+- Mode-specific instructions (backend/frontend/api/full)
+- Memory bank operations with examples
+- Configuration-aware development guidance
+
 ### 6. **Monitor System Status**
 ```bash
 # Check system health
@@ -360,15 +374,15 @@ npx claude-flow monitor [options]
   -f, --focus <component>   Focus on specific component
 ```
 
-#### `claude` - Spawn Claude Instances 🆕
+#### `claude` - Spawn Claude Instances with Enhanced Guidance 🆕
 ```bash
 npx claude-flow claude <subcommand>
-  spawn <task>              Spawn Claude with specific configuration
+  spawn <task>              Spawn Claude with enhanced Claude-Flow guidance
     -t, --tools <tools>     Allowed tools (comma-separated)
     --no-permissions        Use --dangerously-skip-permissions flag
     -c, --config <file>     MCP config file path
     -m, --mode <mode>       Development mode (full/backend-only/frontend-only/api-only)
-    --parallel              Enable parallel execution with BatchTool
+    --parallel              Enable parallel execution with multi-agent support
     --research              Enable web research with WebFetchTool
     --coverage <n>          Test coverage target percentage (default: 80)
     --commit <freq>         Commit frequency (phase/feature/manual)
@@ -379,6 +393,14 @@ npx claude-flow claude <subcommand>
     --dry-run               Show what would be executed without running
 ```
 
+**Each spawned Claude instance receives comprehensive guidance including:**
+- Claude-Flow memory operations (`npx claude-flow memory store/query`)
+- System management commands (`npx claude-flow status/monitor`)
+- Agent coordination (when --parallel is used)
+- Mode-specific development focus
+- Coverage and commit strategy awareness
+- Example commands ready to use with the Bash tool
+
 #### `config` - Configuration Management
 ```bash
 npx claude-flow config <subcommand>
@@ -430,6 +452,25 @@ npx claude-flow agent spawn coordinator --name "Tech Lead"
 npx claude-flow workflow development-pipeline.json --watch
 ```
 
+**Enhanced Claude Spawn Examples:**
+```bash
+# Backend API development with high test coverage
+npx claude-flow claude spawn "build REST API with authentication" \
+  --mode backend-only --coverage 95 --commit feature
+
+# Frontend development with research capabilities
+npx claude-flow claude spawn "create responsive dashboard" \
+  --mode frontend-only --research --verbose
+
+# Full-stack development with parallel execution
+npx claude-flow claude spawn "implement user management system" \
+  --parallel --coverage 90 --commit phase
+
+# API design focus with custom tools
+npx claude-flow claude spawn "design GraphQL schema" \
+  --mode api-only --tools "View,Edit,GrepTool,LS"
+```
+
 **Memory Operations:**
 ```bash
 npx claude-flow memory store "project-requirements" "Authentication using JWT" --namespace project
@@ -477,7 +518,7 @@ claude-flow task workflow example-workflow.json
 ## Development
 
 ### Prerequisites
-- Deno 1.38+ or Node.js 16+
+- Deno 1.38+ or Node.js 16+ (Install Deno: https://deno.land/#installation)
 - Git
 
 ### Setup
@@ -539,6 +580,7 @@ Claude-Flow seamlessly integrates with Claude Code through the `CLAUDE.md` file
 - **Automatic Context Loading**: Claude Code reads your project configuration
 - **Build Command Integration**: All build/test commands are available to Claude
 - **Memory Persistence**: Claude remembers context across sessions
+- **Enhanced Guidance**: Spawned Claude instances receive detailed Claude-Flow instructions
 - **SPARC Methodology**: Built-in support for structured AI development
 
 Use with Claude Code:
@@ -546,10 +588,14 @@ Use with Claude Code:
 # Initialize integration
 npx claude-flow init
 
-# Use with Claude Code SDK
-claude --dangerously-skip-permissions
+# Spawn Claude with enhanced Claude-Flow guidance
+npx claude-flow claude spawn "your task here" --research --parallel
 
-# Claude will automatically use the configuration from CLAUDE.md
+# Claude receives:
+# - Instructions on using npx claude-flow commands
+# - Memory operations (store/query)
+# - Agent coordination capabilities
+# - Mode-specific development guidance
 ```
 
 ## 🏢 **Enterprise Features**

package/bin/claude-flow

@@ -37,10 +37,23 @@ if (!denoPath) {
 // Use the simple CLI JavaScript file which doesn't have TypeScript issues
 const cliPath = path.join(__dirname, '..', 'src', 'cli', 'simple-cli.js');
 
+// Check if the CLI file exists
+if (!fs.existsSync(cliPath)) {
+  console.error('Error: CLI file not found at', cliPath);
+  process.exit(1);
+}
+
+// Set up environment with Deno in PATH
+const env = { ...process.env };
+if (!env.PATH.includes('.deno/bin')) {
+  env.PATH = path.join(os.homedir(), '.deno', 'bin') + path.delimiter + env.PATH;
+}
+
 // Run the CLI with Deno
 const deno = spawn(denoPath, ['run', '--allow-all', cliPath, ...process.argv.slice(2)], {
   stdio: 'inherit',
-  cwd: path.join(__dirname, '..')
+  cwd: path.join(__dirname, '..'),
+  env: env
 });
 
 deno.on('error', (err) => {

package/bin/claude-flow-swarm

@@ -0,0 +1,19 @@
+#!/bin/bash
+# Claude-Flow Swarm Mode Wrapper
+# This script wraps the swarm demo to work with the installed Deno
+
+# Find deno in the path
+DENO_PATH=$(which deno 2>/dev/null || echo "/home/codespace/.deno/bin/deno")
+
+if [ ! -x "$DENO_PATH" ]; then
+    echo "Error: Deno is not installed or not in PATH"
+    echo "Please install Deno first: https://deno.land/#installation"
+    exit 1
+fi
+
+# Get the directory of this script
+SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+SWARM_DEMO="$SCRIPT_DIR/../swarm-demo.ts"
+
+# Run the swarm demo with all arguments
+exec "$DENO_PATH" run --allow-all "$SWARM_DEMO" "$@"

package/bin/claude-flow-swarm-monitor

@@ -0,0 +1,18 @@
+#!/bin/bash
+# Claude-Flow Swarm Mode with Monitoring
+
+# Find deno in the path
+DENO_PATH=$(which deno 2>/dev/null || echo "/home/codespace/.deno/bin/deno")
+
+if [ ! -x "$DENO_PATH" ]; then
+    echo "Error: Deno is not installed or not in PATH"
+    echo "Please install Deno first: https://deno.land/#installation"
+    exit 1
+fi
+
+# Get the directory of this script
+SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+SWARM_DEMO="$SCRIPT_DIR/../swarm-demo-enhanced.ts"
+
+# Always add --monitor flag for better visibility
+exec "$DENO_PATH" run --allow-all "$SWARM_DEMO" "$@" --monitor

package/bin/claude-flow-swarm-ui

@@ -0,0 +1,40 @@
+#!/bin/bash
+# Claude-Flow Swarm Mode with UI Wrapper
+# This script wraps the enhanced swarm demo with blessed UI support
+
+# Find deno in the path
+DENO_PATH=$(which deno 2>/dev/null || echo "/home/codespace/.deno/bin/deno")
+
+if [ ! -x "$DENO_PATH" ]; then
+    echo "Error: Deno is not installed or not in PATH"
+    echo "Please install Deno first: https://deno.land/#installation"
+    exit 1
+fi
+
+# Get the directory of this script
+SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+SWARM_DEMO="$SCRIPT_DIR/../swarm-demo-enhanced.ts"
+
+# Check if --ui flag is present, if not add it
+if [[ "$*" != *"--ui"* ]]; then
+    # Add --ui flag after the objective
+    ARGS=()
+    OBJECTIVE_DONE=false
+    
+    for arg in "$@"; do
+        ARGS+=("$arg")
+        if [[ ! "$OBJECTIVE_DONE" = true ]] && [[ ! "$arg" =~ ^- ]]; then
+            OBJECTIVE_DONE=true
+            # Next arg should be a flag, so we can insert --ui
+            if [[ "${@:$((${#ARGS} + 1)):1}" =~ ^- ]] || [ $# -eq ${#ARGS[@]} ]; then
+                ARGS+=("--ui")
+            fi
+        fi
+    done
+    
+    # Run with --ui flag
+    exec "$DENO_PATH" run --allow-all "$SWARM_DEMO" "${ARGS[@]}"
+else
+    # Run as-is
+    exec "$DENO_PATH" run --allow-all "$SWARM_DEMO" "$@"
+fi

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-flow",
-  "version": "1.0.21",
+  "version": "1.0.23",
   "description": "Advanced AI agent orchestration system for Claude Code",
   "main": "src/cli/main.ts",
   "bin": {
@@ -36,10 +36,24 @@
   },
   "files": [
     "bin/claude-flow",
+    "bin/claude-flow-swarm",
+    "bin/claude-flow-swarm-ui",
+    "bin/claude-flow-swarm-monitor",
     "src/",
+    "swarm-demo.ts",
+    "swarm-demo-enhanced.ts",
     "scripts/install.js",
+    "scripts/swarm-blessed-ui.js",
+    "scripts/swarm-simple.js",
+    "scripts/swarm-example.sh",
     "README.md",
     "LICENSE",
-    "deno.json"
-  ]
-}
+    "deno.json",
+    "SWARM_TTY_SOLUTION.md",
+    "SWARM_VISIBILITY.md"
+  ],
+  "dependencies": {
+    "blessed": "^0.1.81",
+    "node-pty": "^1.0.0"
+  }
+}

package/src/cli/cli-core.ts

@@ -8,7 +8,7 @@ import { red, green, yellow, blue, bold, cyan } from "https://deno.land/std@0.22
 import { ensureDir } from "https://deno.land/std@0.224.0/fs/mod.ts";
 import { join } from "https://deno.land/std@0.224.0/path/mod.ts";
 
-export const VERSION = "1.0.3";
+export const VERSION = "1.0.23";
 
 interface CommandContext {
   args: string[];
@@ -86,7 +86,7 @@ class CLI {
       string: this.getStringFlags(),
       alias: this.getAliases(),
       default: this.getDefaults(),
-      stopEarly: true,
+      stopEarly: false,
       unknown: () => true,
     });