@claude-flow/cli 3.0.2 → 3.1.0-alpha.2

package/.claude/commands/agents/logs.md

@@ -0,0 +1,130 @@
+---
+name: logs
+description: Show agent activity logs
+type: command
+---
+
+# Agent Logs Command
+
+View activity logs and history for agents.
+
+## Usage
+
+```bash
+npx claude-flow agent logs <agent-id> [options]
+```
+
+## Options
+
+| Option | Short | Description | Default |
+|--------|-------|-------------|---------|
+| `--lines` | `-n` | Number of lines to show | 50 |
+| `--follow` | `-f` | Follow log output | false |
+| `--level` | `-l` | Log level filter (debug, info, warn, error) | info |
+| `--since` | | Show logs since timestamp/duration | - |
+| `--format` | | Output format (text, json) | text |
+
+## Examples
+
+```bash
+# View last 50 lines
+npx claude-flow agent logs coder-lx7m9k2
+
+# View last 100 lines
+npx claude-flow agent logs coder-lx7m9k2 -n 100
+
+# Follow logs (live)
+npx claude-flow agent logs coder-lx7m9k2 --follow
+
+# Filter by level
+npx claude-flow agent logs coder-lx7m9k2 -l error
+
+# Logs since time
+npx claude-flow agent logs coder-lx7m9k2 --since "1h"
+npx claude-flow agent logs coder-lx7m9k2 --since "2026-01-08T10:00:00"
+
+# JSON output
+npx claude-flow agent logs coder-lx7m9k2 --format json
+```
+
+## Output
+
+```
+Logs for coder-lx7m9k2
+
+2026-01-08 10:30:15 [INFO]  Agent spawned: type=coder, name=coder-lx7m9k2
+2026-01-08 10:30:16 [INFO]  Connected to swarm: topology=hierarchical
+2026-01-08 10:30:17 [INFO]  Task received: implement-auth-feature
+2026-01-08 10:30:18 [DEBUG] Loading context from memory
+2026-01-08 10:32:45 [INFO]  Task completed: implement-auth-feature (success)
+2026-01-08 10:32:46 [INFO]  Metrics updated: tasks=1, success_rate=100%
+2026-01-08 10:33:00 [INFO]  Task received: write-auth-tests
+2026-01-08 10:35:23 [INFO]  Task completed: write-auth-tests (success)
+2026-01-08 10:35:24 [WARN]  Memory usage approaching threshold: 85MB/100MB
+```
+
+## Log Levels
+
+| Level | Description |
+|-------|-------------|
+| `debug` | Detailed debugging information |
+| `info` | General operational messages |
+| `warn` | Warning conditions |
+| `error` | Error conditions |
+
+## Follow Mode
+
+Real-time log streaming:
+
+```bash
+npx claude-flow agent logs coder-lx7m9k2 --follow
+
+# New logs appear as they occur:
+# 2026-01-08 10:40:15 [INFO]  Task received: refactor-auth
+# 2026-01-08 10:42:30 [INFO]  Code changes: 3 files modified
+# ...
+```
+
+Press `Ctrl+C` to stop following.
+
+## Time Filters
+
+```bash
+# Last hour
+npx claude-flow agent logs coder-lx7m9k2 --since "1h"
+
+# Last 30 minutes
+npx claude-flow agent logs coder-lx7m9k2 --since "30m"
+
+# Specific timestamp
+npx claude-flow agent logs coder-lx7m9k2 --since "2026-01-08T09:00:00"
+
+# Today's logs
+npx claude-flow agent logs coder-lx7m9k2 --since "today"
+```
+
+## JSON Output
+
+```json
+{
+  "agentId": "coder-lx7m9k2",
+  "logs": [
+    {
+      "timestamp": "2026-01-08T10:30:15.000Z",
+      "level": "info",
+      "message": "Agent spawned",
+      "metadata": {
+        "type": "coder",
+        "name": "coder-lx7m9k2"
+      }
+    }
+  ],
+  "total": 50
+}
+```
+
+## Related Commands
+
+- `npx claude-flow agent status` - Current agent status
+- `npx claude-flow agent health` - Health monitoring
+- `npx claude-flow agent metrics` - Performance metrics

package/.claude/commands/agents/metrics.md

@@ -0,0 +1,122 @@
+---
+name: metrics
+description: Show agent performance metrics
+type: command
+---
+
+# Agent Metrics Command
+
+Display comprehensive performance metrics for agents including V3 performance gains.
+
+## Usage
+
+```bash
+npx claude-flow agent metrics [agent-id] [options]
+```
+
+## Options
+
+| Option | Short | Description | Default |
+|--------|-------|-------------|---------|
+| `--period` | `-p` | Time period (1h, 24h, 7d, 30d) | 24h |
+| `--format` | | Output format (table, json) | table |
+
+## Examples
+
+```bash
+# Overall metrics for last 24 hours
+npx claude-flow agent metrics
+
+# Metrics for specific agent
+npx claude-flow agent metrics coder-lx7m9k2
+
+# Last hour
+npx claude-flow agent metrics -p 1h
+
+# Last 7 days
+npx claude-flow agent metrics --period 7d
+
+# JSON output
+npx claude-flow agent metrics --format json
+```
+
+## Output
+
+```
+Agent Metrics (24h)
+
++--------------------+----------+
+| Metric             |    Value |
++--------------------+----------+
+| Total Agents       |        4 |
+| Active Agents      |        3 |
+| Tasks Completed    |      127 |
+| Success Rate       |    96.2% |
+| Total Tokens       | 1,234,567|
+| Avg Response Time  |    1.45s |
++--------------------+----------+
+
+By Agent Type
++------------+-------+-------+---------+
+| Type       | Count | Tasks | Success |
++------------+-------+-------+---------+
+| coder      |     2 |    45 |     97% |
+| researcher |     1 |    32 |     95% |
+| tester     |     1 |    50 |     98% |
++------------+-------+-------+---------+
+
+V3 Performance Gains
+  - Flash Attention: 2.8x speedup
+  - Memory Reduction: 52%
+  - Search: 150x faster
+```
+
+## Metrics Explained
+
+### Summary Metrics
+| Metric | Description |
+|--------|-------------|
+| Total Agents | All agents spawned in period |
+| Active Agents | Currently running agents |
+| Tasks Completed | Successfully completed tasks |
+| Success Rate | Percentage of successful tasks |
+| Total Tokens | Token usage across all agents |
+| Avg Response Time | Mean task completion time |
+
+### V3 Performance Gains
+| Metric | Target | Description |
+|--------|--------|-------------|
+| Flash Attention | 2.49x-7.47x | Neural attention speedup |
+| Memory Reduction | 50-75% | Quantization savings |
+| HNSW Search | 150x-12,500x | Vector search improvement |
+| SONA Adaptation | <0.05ms | Real-time learning |
+
+## JSON Output
+
+```json
+{
+  "period": "24h",
+  "summary": {
+    "totalAgents": 4,
+    "activeAgents": 3,
+    "tasksCompleted": 127,
+    "avgSuccessRate": "96.2%",
+    "totalTokens": 1234567,
+    "avgResponseTime": "1.45s"
+  },
+  "byType": [
+    { "type": "coder", "count": 2, "tasks": 45, "successRate": "97%" }
+  ],
+  "performance": {
+    "flashAttention": "2.8x speedup",
+    "memoryReduction": "52%",
+    "searchImprovement": "150x faster"
+  }
+}
+```
+
+## Related Commands
+
+- `npx claude-flow agent status` - Individual agent metrics
+- `npx claude-flow performance benchmark` - Full performance suite
+- `npx claude-flow status` - System-wide status

package/.claude/commands/agents/pool.md

@@ -0,0 +1,127 @@
+---
+name: pool
+description: Manage agent pool for scaling
+type: command
+---
+
+# Agent Pool Command
+
+Manage the agent pool for automatic scaling and resource optimization.
+
+## Usage
+
+```bash
+npx claude-flow agent pool [options]
+```
+
+## Options
+
+| Option | Short | Description | Default |
+|--------|-------|-------------|---------|
+| `--size` | `-s` | Set pool size | Current |
+| `--min` | | Minimum pool size | 1 |
+| `--max` | | Maximum pool size | 10 |
+| `--auto-scale` | | Enable auto-scaling | true |
+| `--warmup` | | Pre-warm agents | false |
+
+## Examples
+
+```bash
+# View current pool status
+npx claude-flow agent pool
+
+# Set pool size
+npx claude-flow agent pool --size 5
+
+# Configure auto-scaling
+npx claude-flow agent pool --min 2 --max 15 --auto-scale
+
+# Pre-warm agents for fast response
+npx claude-flow agent pool --warmup
+
+# Disable auto-scaling
+npx claude-flow agent pool --auto-scale false
+```
+
+## Output
+
+```
+Agent Pool Configuration
+
++----------------+----------+
+| Setting        | Value    |
++----------------+----------+
+| Current Size   | 3        |
+| Min Size       | 1        |
+| Max Size       | 10       |
+| Auto-Scale     | enabled  |
+| Warmup         | disabled |
++----------------+----------+
+
+Pool Status
++------------+--------+------+-------+
+| Type       | Active | Idle | Total |
++------------+--------+------+-------+
+| coder      | 1      | 1    | 2     |
+| researcher | 1      | 0    | 1     |
++------------+--------+------+-------+
+
+Auto-Scale Rules
+  - Scale up when: Queue > 5 tasks
+  - Scale down when: Idle > 5 minutes
+  - Cooldown: 60 seconds
+```
+
+## Auto-Scaling Behavior
+
+### Scale Up Triggers
+- Task queue exceeds threshold
+- Response time increases
+- Error rate increases
+
+### Scale Down Triggers
+- Agents idle for extended period
+- Task queue empty
+- Resource pressure
+
+## Pre-Warming
+
+Pre-warm agents to reduce cold-start latency:
+
+```bash
+npx claude-flow agent pool --warmup
+
+# Pre-warms default agent types:
+# - coder (2 instances)
+# - researcher (1 instance)
+# - tester (1 instance)
+```
+
+## Pool Configuration File
+
+Configure in `.claude-flow/config.yaml`:
+
+```yaml
+agent:
+  pool:
+    minSize: 2
+    maxSize: 15
+    autoScale: true
+    warmup:
+      enabled: true
+      types:
+        - type: coder
+          count: 2
+        - type: researcher
+          count: 1
+    scaleRules:
+      scaleUpThreshold: 5
+      scaleDownIdleTime: 300
+      cooldownPeriod: 60
+```
+
+## Related Commands
+
+- `npx claude-flow agent spawn` - Manual agent spawning
+- `npx claude-flow agent list` - View active agents
+- `npx claude-flow swarm scale` - Swarm-level scaling

package/.claude/commands/agents/spawn.md

@@ -0,0 +1,140 @@
+---
+name: spawn
+description: Spawn a new agent with V3 capabilities
+type: command
+---
+
+# Agent Spawn Command
+
+Spawn a new agent with full V3 capabilities including neural patterns, memory integration, and swarm coordination.
+
+## Usage
+
+```bash
+npx claude-flow agent spawn [options]
+```
+
+## Options
+
+| Option | Short | Description | Default |
+|--------|-------|-------------|---------|
+| `--type` | `-t` | Agent type to spawn | Required |
+| `--name` | `-n` | Agent name/identifier | Auto-generated |
+| `--provider` | `-p` | AI provider (anthropic, openrouter, ollama) | anthropic |
+| `--model` | `-m` | Model to use | Provider default |
+| `--task` | | Initial task for the agent | None |
+| `--timeout` | | Agent timeout in seconds | 300 |
+| `--auto-tools` | | Enable automatic tool usage | true |
+
+## Agent Types (87 Available)
+
+### Core Development
+```bash
+npx claude-flow agent spawn -t coder      # Code implementation
+npx claude-flow agent spawn -t reviewer   # Code review
+npx claude-flow agent spawn -t tester     # Testing
+npx claude-flow agent spawn -t planner    # Planning
+npx claude-flow agent spawn -t researcher # Research
+```
+
+### V3 Specialized
+```bash
+npx claude-flow agent spawn -t security-architect     # Security design
+npx claude-flow agent spawn -t security-auditor       # CVE remediation
+npx claude-flow agent spawn -t memory-specialist      # AgentDB (150x-12,500x faster)
+npx claude-flow agent spawn -t performance-engineer   # 2.49x-7.47x optimization
+npx claude-flow agent spawn -t core-architect         # DDD design
+```
+
+### Swarm Coordination
+```bash
+npx claude-flow agent spawn -t hierarchical-coordinator  # Queen-led
+npx claude-flow agent spawn -t mesh-coordinator          # P2P network
+npx claude-flow agent spawn -t adaptive-coordinator      # Dynamic topology
+npx claude-flow agent spawn -t collective-intelligence-coordinator
+```
+
+### Consensus Agents
+```bash
+npx claude-flow agent spawn -t byzantine-coordinator  # BFT consensus
+npx claude-flow agent spawn -t raft-manager          # Leader-based
+npx claude-flow agent spawn -t gossip-coordinator    # Eventual consistency
+npx claude-flow agent spawn -t crdt-synchronizer     # CRDT replication
+npx claude-flow agent spawn -t quorum-manager        # Quorum-based
+```
+
+### GitHub Integration
+```bash
+npx claude-flow agent spawn -t pr-manager           # PR lifecycle
+npx claude-flow agent spawn -t code-review-swarm    # Multi-agent review
+npx claude-flow agent spawn -t issue-tracker        # Issue management
+npx claude-flow agent spawn -t release-manager      # Release coordination
+npx claude-flow agent spawn -t workflow-automation  # CI/CD automation
+```
+
+### SPARC Methodology
+```bash
+npx claude-flow agent spawn -t sparc-coordinator    # SPARC orchestration
+npx claude-flow agent spawn -t specification        # Requirements
+npx claude-flow agent spawn -t pseudocode          # Algorithm design
+npx claude-flow agent spawn -t architecture        # System design
+npx claude-flow agent spawn -t refinement          # Iterative improvement
+```
+
+## Examples
+
+```bash
+# Spawn with custom name
+npx claude-flow agent spawn -t coder --name feature-bot
+
+# Spawn with initial task
+npx claude-flow agent spawn -t researcher --task "Research React 19 features"
+
+# Spawn with specific model
+npx claude-flow agent spawn -t architect -m claude-3-opus-20240229
+
+# Spawn with custom timeout
+npx claude-flow agent spawn -t tester --timeout 600
+
+# Spawn using OpenRouter
+npx claude-flow agent spawn -t coder -p openrouter -m anthropic/claude-3.5-sonnet
+```
+
+## Using Claude Code's Task Tool
+
+For actual execution, always use Claude Code's Task tool:
+
+```javascript
+// Spawn ALL agents in ONE message for parallel execution
+Task("Coder", "Implement authentication feature", "coder")
+Task("Tester", "Write unit tests for auth", "tester")
+Task("Reviewer", "Review auth implementation", "reviewer")
+```
+
+## MCP Coordination (Optional)
+
+Use MCP tools only for swarm coordination setup:
+
+```javascript
+mcp__claude-flow__swarm_init({ topology: "hierarchical", maxAgents: 15 })
+mcp__claude-flow__agent_spawn({ type: "coordinator", name: "queen" })
+```
+
+## Output
+
+```
+Spawning coder agent: feature-bot
+
++-----------+----------------------------------+
+| Property  | Value                            |
++-----------+----------------------------------+
+| ID        | coder-lx7m9k2                    |
+| Type      | coder                            |
+| Name      | feature-bot                      |
+| Status    | active                           |
+| Created   | 2026-01-08T03:30:00.000Z         |
+| Capabilities | code, debug, refactor, test   |
++-----------+----------------------------------+
+
+Agent feature-bot spawned successfully
+```

package/.claude/commands/agents/status.md

@@ -0,0 +1,115 @@
+---
+name: status
+description: Show detailed status of an agent
+type: command
+---
+
+# Agent Status Command
+
+Display comprehensive status information for a specific agent including metrics, configuration, and activity.
+
+## Usage
+
+```bash
+npx claude-flow agent status <agent-id>
+npx claude-flow agent status --id <agent-id>
+```
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--id` | Agent ID (alternative to positional arg) | Required |
+| `--format` | Output format (table, json) | table |
+
+## Examples
+
+```bash
+# Get status by ID
+npx claude-flow agent status coder-lx7m9k2
+
+# Using --id flag
+npx claude-flow agent status --id researcher-abc123
+
+# JSON output
+npx claude-flow agent status coder-lx7m9k2 --format json
+```
+
+## Output
+
+```
++--------------------------------------------------+
+|              Agent: coder-lx7m9k2                |
++--------------------------------------------------+
+| Type: coder                                      |
+| Status: active                                   |
+| Created: 1/8/2026, 10:30:15 AM                   |
+| Last Activity: 1/8/2026, 10:45:23 AM             |
++--------------------------------------------------+
+
+Metrics
++-------------------------+----------+
+| Metric                  |    Value |
++-------------------------+----------+
+| Tasks Completed         |       12 |
+| Tasks In Progress       |        1 |
+| Tasks Failed            |        0 |
+| Avg Execution Time      |  245.5ms |
+| Uptime                  |   15.3m  |
++-------------------------+----------+
+```
+
+## Detailed Information
+
+The status command provides:
+
+### Basic Info
+- Agent ID and type
+- Current status (active/idle/terminated)
+- Creation timestamp
+- Last activity timestamp
+
+### Performance Metrics
+- Tasks completed successfully
+- Tasks currently in progress
+- Failed task count
+- Average execution time
+- Total uptime
+
+### Configuration (when applicable)
+- Provider and model
+- Timeout settings
+- Auto-tools enabled
+- Custom capabilities
+
+## JSON Output
+
+```json
+{
+  "id": "coder-lx7m9k2",
+  "agentType": "coder",
+  "status": "active",
+  "createdAt": "2026-01-08T10:30:15.000Z",
+  "lastActivityAt": "2026-01-08T10:45:23.000Z",
+  "config": {
+    "provider": "anthropic",
+    "model": "claude-3-5-sonnet-20241022",
+    "timeout": 300,
+    "autoTools": true
+  },
+  "metrics": {
+    "tasksCompleted": 12,
+    "tasksInProgress": 1,
+    "tasksFailed": 0,
+    "averageExecutionTime": 245.5,
+    "uptime": 918000
+  }
+}
+```
+
+## Related Commands
+
+- `npx claude-flow agent list` - Find agent IDs
+- `npx claude-flow agent metrics` - Aggregate metrics
+- `npx claude-flow agent health` - Health check
+- `npx claude-flow agent logs <id>` - Activity logs