ruflo/docs/api/api-reference.md

# 📖 Claude Flow v2.0.0 API Reference

## 🚨 Current Implementation Status

**📈 NPX Version**: ✅ **FULLY OPERATIONAL** (Recommended for immediate use)
**🔧 Local Build**: ⚠️ **BUILD ISSUES** (269+ TypeScript errors)
**🐳 Docker**: ✅ **WORKING** with warnings

> **RECOMMENDED**: Use `npx claude-flow@2.0.0` for all operations until local build issues are resolved.

## 📋 Table of Contents
1. [Quick Start (NPX)](#quick-start-npx)
2. [Core Commands](#core-commands)
3. [Agent Management](#agent-management)
4. [Swarm Operations](#swarm-operations)
5. [SPARC Development](#sparc-development)
6. [Memory Operations](#memory-operations)
7. [Task Management](#task-management)
8. [MCP Integration](#mcp-integration)
9. [GitHub Integration](#github-integration)
10. [Enterprise Features](#enterprise-features)
11. [Monitoring & Analytics](#monitoring--analytics)
12. [Known Issues & Troubleshooting](#known-issues--troubleshooting)

## 🚀 Quick Start (NPX)

### Immediate Usage (Production Ready)
```bash
# ✅ These commands work immediately:
npx claude-flow@2.0.0 --help
npx claude-flow@2.0.0 status
npx claude-flow@2.0.0 swarm "your objective" --max-agents 3
npx claude-flow@2.0.0 sparc "research modern frameworks"

# Initialize project (creates .claude directory structure)
npx claude-flow@2.0.0 init --sparc

# Enterprise swarm coordination
npx claude-flow@2.0.0 swarm "build REST API" --strategy development --parallel
```

### Performance Benchmarks (NPX)
- **Swarm Init**: 5.2ms average ✅
- **Agent Spawn**: 3.4ms average ✅  
- **Task Orchestration**: 6ms ✅
- **Memory Usage**: 8.2MB/11.6MB ✅
- **Neural Processing**: 20.2ms average, 50 ops/sec ✅

## 🎯 Core Commands

### `init`
Initialize Claude Flow in your project.

```bash
claude-flow init [options]
```

**Options:**
- `--sparc` - Initialize with SPARC methodology and ruv-swarm integration (recommended)
- `--minimal` - Minimal setup without extra features
- `--docker` - Include Docker configuration
- `--github` - Enable GitHub integration
- `--migrate` - Migrate from Deno version
- `--ci` - CI/CD friendly initialization (no prompts)

**Examples:**
```bash
# Full enterprise setup
./claude-flow init --sparc

# Minimal setup
./claude-flow init --minimal

# CI/CD setup
./claude-flow init --ci --sparc
```

### `start`
Start the Claude Flow orchestration system.

```bash
claude-flow start [options]
```

**Options:**
- `--ui` - Enable web UI (default: true)
- `--port <number>` - UI port (default: 3000)
- `--mcp` - Enable MCP server (default: true)
- `--mcp-port <number>` - MCP port (default: 3001)
- `--swarm` - Auto-start swarm coordination
- `--monitor` - Enable real-time monitoring
- `--detached` - Run in background

**Examples:**
```bash
# Start with UI
./claude-flow start --ui

# Custom ports
./claude-flow start --port 8080 --mcp-port 8081

# Background mode
./claude-flow start --detached
```

### `status`
Show system status and health metrics.

```bash
claude-flow status [options]
```

**Options:**
- `--json` - Output in JSON format
- `--detailed` - Show detailed metrics
- `--watch` - Continuous monitoring

**Output:**
```
🌊 Claude Flow Status
├── Version: 2.0.0
├── Uptime: 2h 15m
├── Components:
│   ├── ✅ Orchestrator: Running
│   ├── ✅ MCP Server: Connected
│   ├── ✅ Memory Bank: Active (1.2GB)
│   └── ✅ Swarm: 3 agents active
└── Health: Excellent
```

### `stop`
Stop the Claude Flow system.

```bash
claude-flow stop [options]
```

**Options:**
- `--force` - Force stop all processes
- `--cleanup` - Clean up temporary files
- `--save-state` - Save current state before stopping

## 🤖 Agent Management

### `agent spawn`
Create and spawn new agents.

```bash
claude-flow agent spawn <type> [name] [options]
```

**Agent Types:**
- `researcher` - Research and information gathering
- `coder` - Code development and implementation  
- `analyst` - Analysis and optimization
- `architect` - System design and architecture
- `tester` - Testing and quality assurance
- `coordinator` - Multi-agent coordination
- `reviewer` - Code review and validation

**Options:**
- `--capabilities <list>` - Specific capabilities (comma-separated)
- `--max-tasks <number>` - Maximum concurrent tasks
- `--priority <level>` - Agent priority (low, medium, high)

**Examples:**
```bash
# Spawn a researcher agent
npx claude-flow@2.0.0 agent spawn researcher "Lead Researcher"

# Spawn coder with specific capabilities
npx claude-flow@2.0.0 agent spawn coder "API Developer" --capabilities "rest-api,database,testing"
```

### `agent list`
List all active agents.

```bash
claude-flow agent list [options]
```

**Options:**
- `--type <type>` - Filter by agent type
- `--status <status>` - Filter by status (active, idle, busy)
- `--json` - Output in JSON format

## 🐝 Swarm Operations

### `swarm`
Deploy multi-agent swarms for complex objectives.

```bash
claude-flow swarm "<objective>" [options]
```

**Options:**
- `--strategy <type>` - Execution strategy:
  - `research` - Research and analysis focus
  - `development` - Code development focus
  - `analysis` - Analysis and optimization focus
  - `testing` - Testing and QA focus
  - `maintenance` - Maintenance and updates focus
  - `auto` - Automatic strategy selection (default)
- `--mode <type>` - Coordination mode:
  - `centralized` - Single coordinator (default)
  - `distributed` - Distributed coordination
  - `hierarchical` - Tree-like structure
  - `mesh` - Full mesh communication
  - `hybrid` - Adaptive coordination
- `--max-agents <number>` - Maximum agents (default: 5)
- `--parallel` - Enable parallel execution (2.8-4.4x speedup)
- `--monitor` - Real-time monitoring
- `--ui` - Interactive user interface
- `--background` - Run in background

**Examples:**
```bash
# Basic swarm deployment
npx claude-flow@2.0.0 swarm "Build a REST API with authentication"

# Research-focused swarm
npx claude-flow@2.0.0 swarm "Research cloud architecture patterns" --strategy research --mode hierarchical

# Development swarm with monitoring
npx claude-flow@2.0.0 swarm "Implement user management system" --strategy development --parallel --monitor

# Large-scale enterprise swarm
npx claude-flow@2.0.0 swarm "Optimize database performance" --max-agents 8 --mode mesh --ui
```

**Performance Metrics (NPX):**
- Initialization: ~5.2ms
- Agent Spawning: ~3.4ms per agent
- Task Assignment: ~6ms
- Memory Operations: ~2ms
- Neural Processing: ~20ms

## 🚀 SPARC Development

### `sparc`
SPARC (Specification, Pseudocode, Architecture, Refinement, Completion) development methodology.

```bash
claude-flow sparc [mode] [objective]
```

**Available Modes (17 total):**
- `architect` - System architecture and design
- `code` - Code generation and implementation
- `tdd` - Test-driven development workflow
- `debug` - Debugging and troubleshooting
- `security` - Security analysis and fixes
- `refactor` - Code refactoring and optimization
- `docs` - Documentation generation
- `review` - Code review and quality checks
- `data` - Data modeling and analysis
- `api` - API design and implementation
- `ui` - UI/UX development
- `ops` - DevOps and infrastructure
- `ml` - Machine learning workflows
- `blockchain` - Blockchain development
- `mobile` - Mobile app development
- `game` - Game development
- `iot` - IoT system development

**Actions:**
- `modes` - List all available modes
- `info <mode>` - Show detailed mode information
- `run <mode>` - Execute specific mode

**Examples:**
```bash
# Auto-mode selection
npx claude-flow@2.0.0 sparc "design authentication system"

# Specific mode usage
npx claude-flow@2.0.0 sparc architect "design microservices architecture"
npx claude-flow@2.0.0 sparc tdd "user registration feature"
npx claude-flow@2.0.0 sparc security "audit API endpoints"

# List all modes
npx claude-flow@2.0.0 sparc modes

# Get mode details
npx claude-flow@2.0.0 sparc info security
```

## 💾 Memory Operations

### `memory store`
Store data in the shared memory system.

```bash
claude-flow memory store <key> <value> [options]
```

**Options:**
- `--partition <name>` - Memory partition (default: 'default')
- `--ttl <seconds>` - Time to live
- `--metadata <json>` - Additional metadata

### `memory get`
Retrieve data from shared memory.

```bash
claude-flow memory get <key> [options]
```

**Options:**
- `--partition <name>` - Memory partition
- `--json` - Output in JSON format

### `memory search`
Search memory entries.

```bash
claude-flow memory search <query> [options]
```

**Options:**
- `--partition <name>` - Search specific partition
- `--limit <number>` - Maximum results
- `--type <type>` - Filter by data type

## 📋 Task Management

### `task create`
Create new tasks.

```bash
claude-flow task create "<description>" [options]
```

**Options:**
- `--priority <level>` - Task priority (low, medium, high, critical)
- `--assign <agent>` - Assign to specific agent
- `--dependencies <list>` - Task dependencies
- `--deadline <date>` - Task deadline

### `task list`
List all tasks.

```bash
claude-flow task list [options]
```

**Options:**
- `--status <status>` - Filter by status (pending, in_progress, completed, failed)
- `--agent <agent>` - Filter by assigned agent
- `--priority <level>` - Filter by priority

## 🔌 MCP Integration

### `mcp start`
Start MCP (Model Context Protocol) server.

```bash
claude-flow mcp start [options]
```

**Options:**
- `--port <number>` - MCP server port (default: 3001)
- `--tools <list>` - Enable specific tools
- `--auth` - Enable authentication

### `mcp tools`
List available MCP tools.

```bash
claude-flow mcp tools [options]
```

**Available Tools (27 total):**
- `swarm_init` - Initialize swarm coordination
- `agent_spawn` - Spawn specialized agents
- `task_orchestrate` - Task orchestration
- `memory_usage` - Memory operations
- `neural_status` - Neural network status
- And 22 more specialized tools...

## 🐙 GitHub Integration

### `github`
GitHub workflow automation.

```bash
claude-flow github <mode> [options]
```

**Available Modes (6 total):**
- `pr-manager` - Pull request management
- `issue-tracker` - Issue tracking and management
- `release-manager` - Release coordination
- `workflow-automation` - GitHub Actions automation
- `repo-architect` - Repository structure management
- `sync-coordinator` - Cross-repository synchronization

**Examples:**
```bash
# PR management with multi-reviewer coordination
npx claude-flow@2.0.0 github pr-manager "coordinate feature review"

# Automated issue tracking
npx claude-flow@2.0.0 github issue-tracker "track bug resolution"

# Release coordination
npx claude-flow@2.0.0 github release-manager "prepare v2.1.0 release"
```

## 📊 Monitoring & Analytics

### `monitor`
Real-time system monitoring.

```bash
claude-flow monitor [options]
```

**Options:**
- `--realtime` - Live updates
- `--metrics` - Show performance metrics
- `--agents` - Monitor agent activity
- `--tasks` - Monitor task progress

### `status`
System status overview.

```bash
claude-flow status [options]
```

**Status Components:**
- ✅ **Orchestrator**: Main coordination system
- ✅ **MCP Server**: Model Context Protocol server
- ✅ **Memory Bank**: Shared memory system
- ✅ **Swarm Intelligence**: Multi-agent coordination
- ✅ **Neural Networks**: Pattern recognition and learning

## ⚠️ Known Issues & Troubleshooting

### 🔧 Local Build Issues

**Problem**: TypeScript compilation errors (269+ errors)
```bash
npm run build
# Error: Cannot find module '../utils/error-handler.js'
```

**Root Cause**: Import/export resolution issues in hybrid Deno/Node.js codebase

**Workaround**: Use NPX version for all operations
```bash
# Instead of local build, use:
npx claude-flow@2.0.0 <command>
```

### 🧪 Test Suite Issues

**Problem**: Jest module resolution failures
```bash
npm test
# Error: Could not locate module ../utils/error-handler.js
```

**Status**: Known issue being addressed in development

**Workaround**: Use NPX version which has been thoroughly tested

### 🐝 Swarm LoadBalancer Error

**Problem**: LoadBalancer not defined error in some swarm operations
```bash
npx claude-flow swarm "test" --max-agents 2
# Error: LoadBalancer is not defined
```

**Status**: Fixed in recent updates to swarm-new.js

**Solution**: Use latest NPX version:
```bash
npx claude-flow@2.0.0 swarm "your objective"
```

### 🔍 Debug Commands

```bash
# Check system health
npx claude-flow@2.0.0 status

# Validate installation
npx claude-flow@2.0.0 --version

# Test basic functionality
npx claude-flow@2.0.0 --help

# Initialize clean environment
npx claude-flow@2.0.0 init --sparc
```

### 📞 Support Resources

- **GitHub Issues**: https://github.com/ruvnet/claude-code-flow/issues
- **Documentation**: https://github.com/ruvnet/claude-code-flow#readme
- **ruv-swarm Integration**: https://github.com/ruvnet/ruv-FANN/tree/main/ruv-swarm

### 🔄 Update Recommendations

**For Immediate Use**:
- ✅ Use `npx claude-flow@2.0.0` for all operations
- ✅ All swarm intelligence features fully functional
- ✅ Neural networks and memory persistence working
- ✅ GitHub integration operational

**For Development**:
- ⚠️ Local build issues being resolved
- ⚠️ Test suite improvements in progress
- ⚠️ TypeScript errors being addressed

---

*Last Updated: 2025-01-05*  
*Version: 2.0.0*  
*Status: NPX Production Ready | Local Build In Progress*
claude-flow stop [options]
```

**Options:**
- `--force` - Force stop without cleanup
- `--timeout <seconds>` - Shutdown timeout

### `config`
Manage configuration settings.

```bash
claude-flow config <action> [key] [value]
```

**Actions:**
- `get <key>` - Get configuration value
- `set <key> <value>` - Set configuration value
- `list` - List all settings
- `reset` - Reset to defaults
- `migrate` - Migrate old configuration

**Examples:**
```bash
# Set UI port
./claude-flow config set ui.port 8080

# Get swarm settings
./claude-flow config get swarm

# List all settings
./claude-flow config list
```

## 🤖 Agent Management

### `agent spawn`
Create a new AI agent.

```bash
claude-flow agent spawn <type> [options]
```

**Agent Types:**
- `researcher` - Information gathering and analysis
- `coder` - Code generation and implementation
- `analyst` - Data analysis and insights
- `tester` - Testing and quality assurance
- `coordinator` - Task coordination
- `architect` - System design
- `reviewer` - Code review
- `documenter` - Documentation

**Options:**
- `--name <string>` - Agent name
- `--model <string>` - AI model to use
- `--temperature <number>` - Creativity level (0-1)
- `--max-tokens <number>` - Response limit
- `--tools <list>` - Available tools
- `--memory` - Enable memory access
- `--parent <id>` - Parent agent for hierarchy

**Examples:**
```bash
# Spawn researcher
./claude-flow agent spawn researcher --name "DataBot"

# Spawn with configuration
./claude-flow agent spawn coder \
  --name "APIBuilder" \
  --temperature 0.7 \
  --tools "file-system,web-search"

# Create hierarchy
./claude-flow agent spawn coordinator --name "Lead"
./claude-flow agent spawn coder --parent lead-123
```

### `agent list`
List all active agents.

```bash
claude-flow agent list [options]
```

**Options:**
- `--format <table|json|tree>` - Output format
- `--filter <string>` - Filter by type or status
- `--sort <field>` - Sort by field

**Output:**
```
🤖 Active Agents (5)
├── coordinator-a1b2 [Coordinator] - Idle
├── researcher-c3d4 [Researcher] - Working: "API analysis"
├── coder-e5f6 [Coder] - Working: "implement auth"
├── tester-g7h8 [Tester] - Idle
└── analyst-i9j0 [Analyst] - Working: "performance metrics"
```

### `agent info`
Get detailed agent information.

```bash
claude-flow agent info <agent-id>
```

### `agent terminate`
Terminate an agent.

```bash
claude-flow agent terminate <agent-id> [options]
```

**Options:**
- `--force` - Force termination
- `--cascade` - Terminate child agents

### `agent assign`
Assign task to agent.

```bash
claude-flow agent assign <agent-id> <task> [options]
```

**Options:**
- `--priority <high|medium|low>` - Task priority
- `--deadline <time>` - Task deadline
- `--dependencies <ids>` - Task dependencies

## 🐝 Swarm Operations

### `swarm init`
Initialize a swarm with topology.

```bash
claude-flow swarm init [options]
```

**Options:**
- `--topology <type>` - Swarm topology
  - `hierarchical` - Tree structure (default)
  - `mesh` - Fully connected
  - `ring` - Circular coordination
  - `star` - Central coordinator
- `--max-agents <number>` - Maximum agents (default: 8)
- `--strategy <type>` - Coordination strategy
  - `balanced` - Even distribution
  - `specialized` - Task-specific
  - `adaptive` - Dynamic adjustment

**Examples:**
```bash
# Hierarchical swarm
./claude-flow swarm init --topology hierarchical --max-agents 10

# Mesh network
./claude-flow swarm init --topology mesh --strategy adaptive
```

### `swarm`
Execute task with swarm coordination.

```bash
claude-flow swarm <task> [options]
```

**Options:**
- `--strategy <type>` - Execution strategy
  - `development` - Full development cycle
  - `analysis` - Deep analysis
  - `testing` - Comprehensive testing
  - `research` - Research and exploration
  - `optimization` - Performance optimization
- `--max-agents <number>` - Agent limit
- `--parallel` - Enable parallel execution
- `--monitor` - Real-time monitoring
- `--timeout <minutes>` - Task timeout

**Examples:**
```bash
# Development task
./claude-flow swarm "Build REST API with authentication" \
  --strategy development \
  --parallel \
  --monitor

# Research task
./claude-flow swarm "Research best practices for microservices" \
  --strategy research \
  --max-agents 5
```

### `swarm status`
Get swarm status and metrics.

```bash
claude-flow swarm status [options]
```

**Options:**
- `--detailed` - Show agent details
- `--metrics` - Include performance metrics

### `swarm monitor`
Real-time swarm monitoring.

```bash
claude-flow swarm monitor [options]
```

**Options:**
- `--dashboard` - Web dashboard
- `--metrics <list>` - Specific metrics to track

## 🎯 SPARC Development

### `sparc run`
Execute SPARC development mode.

```bash
claude-flow sparc run <mode> <prompt> [options]
```

**Modes:**
- `spec` - Specification writing
- `pseudocode` - Pseudocode design
- `architect` - System architecture
- `code` - Code implementation
- `test` - Test creation
- `review` - Code review
- `refactor` - Code refactoring
- `debug` - Debugging
- `document` - Documentation
- `ask` - General questions
- `tdd` - Test-driven development
- `bdd` - Behavior-driven development
- `ddd` - Domain-driven design
- `security-review` - Security analysis
- `performance-review` - Performance analysis
- `api-design` - API design
- `ui-design` - UI/UX design
- `data-modeling` - Database design
- `integration` - System integration
- `deployment` - Deployment planning
- `devops` - DevOps automation

**Options:**
- `--context <file>` - Context file
- `--output <file>` - Output file
- `--chain <modes>` - Chain multiple modes
- `--interactive` - Interactive mode

**Examples:**
```bash
# Architecture design
./claude-flow sparc run architect "design microservices for e-commerce"

# TDD workflow
./claude-flow sparc run tdd "user authentication system"

# Chained execution
./claude-flow sparc run --chain spec,architect,code "payment processing"
```

### `sparc template`
Manage SPARC templates.

```bash
claude-flow sparc template <action> [name]
```

**Actions:**
- `list` - List available templates
- `create` - Create new template
- `edit` - Edit template
- `delete` - Delete template
- `apply` - Apply template

## 🧠 Memory Operations

### `memory store`
Store information in memory bank.

```bash
claude-flow memory store <key> <value> [options]
```

**Options:**
- `--type <type>` - Data type (text, json, file)
- `--tags <list>` - Tags for categorization
- `--ttl <seconds>` - Time to live
- `--compress` - Compress data
- `--encrypt` - Encrypt sensitive data

**Examples:**
```bash
# Store text
./claude-flow memory store api-design "RESTful endpoints for user management"

# Store JSON
./claude-flow memory store config '{"api": {"version": "2.0"}}' --type json

# Store with tags
./claude-flow memory store requirements "User auth with JWT" \
  --tags "auth,security,backend"
```

### `memory query`
Search memory bank.

```bash
claude-flow memory query <pattern> [options]
```

**Options:**
- `--type <type>` - Filter by type
- `--tags <list>` - Filter by tags
- `--limit <number>` - Result limit
- `--format <format>` - Output format

**Examples:**
```bash
# Query by pattern
./claude-flow memory query "auth"

# Query with filters
./claude-flow memory query "*" --tags "security" --limit 10
```

### `memory delete`
Delete memory entries.

```bash
claude-flow memory delete <key> [options]
```

**Options:**
- `--pattern` - Delete by pattern
- `--confirm` - Skip confirmation

### `memory export`
Export memory bank.

```bash
claude-flow memory export <file> [options]
```

**Options:**
- `--format <json|csv|sql>` - Export format
- `--filter <pattern>` - Filter entries

### `memory import`
Import memory data.

```bash
claude-flow memory import <file> [options]
```

**Options:**
- `--merge` - Merge with existing
- `--overwrite` - Overwrite existing

## 📋 Task Management

### `task create`
Create a new task.

```bash
claude-flow task create <type> <description> [options]
```

**Task Types:**
- `development` - Development task
- `research` - Research task
- `analysis` - Analysis task
- `testing` - Testing task
- `documentation` - Documentation task
- `deployment` - Deployment task

**Options:**
- `--priority <level>` - Priority level
- `--assign <agent>` - Assign to agent
- `--dependencies <ids>` - Task dependencies
- `--deadline <date>` - Task deadline
- `--tags <list>` - Task tags

**Examples:**
```bash
# Create development task
./claude-flow task create development "Implement user authentication" \
  --priority high \
  --assign coder-123

# Create with dependencies
./claude-flow task create testing "Integration tests" \
  --dependencies task-001,task-002
```

### `task list`
List tasks.

```bash
claude-flow task list [options]
```

**Options:**
- `--status <status>` - Filter by status
- `--assigned <agent>` - Filter by assignment
- `--sort <field>` - Sort order

### `task update`
Update task status.

```bash
claude-flow task update <task-id> [options]
```

**Options:**
- `--status <status>` - New status
- `--progress <percent>` - Progress update
- `--notes <text>` - Add notes

### `task workflow`
Execute task workflow.

```bash
claude-flow task workflow <workflow-file> [options]
```

**Options:**
- `--parallel` - Parallel execution
- `--dry-run` - Simulation mode

## 🔌 MCP Integration

### `mcp status`
Check MCP server status.

```bash
claude-flow mcp status [options]
```

**Options:**
- `--detailed` - Detailed information
- `--tools` - List available tools

### `mcp tools`
List available MCP tools.

```bash
claude-flow mcp tools [options]
```

**Options:**
- `--category <cat>` - Filter by category
- `--search <term>` - Search tools

**Output:**
```
🔧 Available MCP Tools (27)
├── Swarm Coordination (8)
│   ├── swarm_init - Initialize swarm
│   ├── agent_spawn - Create agents
│   └── task_orchestrate - Coordinate tasks
├── Memory Management (6)
│   ├── memory_usage - Store/retrieve
│   └── memory_search - Search memory
├── Neural Processing (5)
│   ├── neural_train - Train patterns
│   └── neural_predict - Make predictions
└── System Tools (8)
    ├── benchmark_run - Performance tests
    └── monitor_metrics - System metrics
```

### `mcp call`
Call MCP tool directly.

```bash
claude-flow mcp call <tool> [params] [options]
```

**Examples:**
```bash
# Initialize swarm
./claude-flow mcp call swarm_init \
  --params '{"topology": "mesh", "maxAgents": 5}'

# Store memory
./claude-flow mcp call memory_usage \
  --params '{"action": "store", "key": "test", "value": "data"}'
```

## 🐙 GitHub Integration

### `github pr-manager`
Manage pull requests with swarm intelligence.

```bash
claude-flow github pr-manager <description> [options]
```

**Options:**
- `--branch <name>` - Target branch
- `--reviewers <list>` - Assign reviewers
- `--labels <list>` - PR labels
- `--analyze-impact` - Impact analysis
- `--suggest-tests` - Test suggestions
- `--update-docs` - Update documentation

### `github issue-solver`
Analyze and solve GitHub issues.

```bash
claude-flow github issue-solver <issue> [options]
```

**Options:**
- `--deep-analysis` - Root cause analysis
- `--auto-fix` - Generate fix
- `--create-pr` - Create fix PR

### `github release-coordinator`
Coordinate releases.

```bash
claude-flow github release-coordinator <version> [options]
```

**Options:**
- `--generate-changelog` - Auto changelog
- `--run-tests` - Run test suite
- `--publish-npm` - Publish to NPM
- `--create-docker` - Build Docker image

### `github sync-packages`
Synchronize packages across repositories.

```bash
claude-flow github sync-packages [options]
```

**Options:**
- `--repos <list>` - Target repositories
- `--package <spec>` - Package specification
- `--config <file>` - Sync configuration

### `github repo-architect`
Optimize repository structure.

```bash
claude-flow github repo-architect [action] [options]
```

**Options:**
- `--template <type>` - Apply template
- `--analyze` - Analyze structure
- `--apply-standards` - Apply best practices

## 🏢 Enterprise Features

### `project`
Project lifecycle management.

```bash
claude-flow project <action> [name] [options]
```

**Actions:**
- `create` - Create new project
- `list` - List projects
- `info` - Project information
- `archive` - Archive project
- `template` - Manage templates

**Options:**
- `--type <type>` - Project type
- `--template <name>` - Use template
- `--team <members>` - Assign team

### `deploy`
Deployment automation.

```bash
claude-flow deploy <action> [target] [options]
```

**Actions:**
- `create` - Create deployment
- `rollback` - Rollback deployment
- `status` - Deployment status
- `history` - Deployment history

**Options:**
- `--strategy <type>` - Deployment strategy
  - `blue-green` - Blue-green deployment
  - `canary` - Canary release
  - `rolling` - Rolling update
- `--environment <env>` - Target environment

### `cloud`
Multi-cloud resource management.

```bash
claude-flow cloud <action> [resource] [options]
```

**Actions:**
- `resources` - Manage resources
- `costs` - Cost analysis
- `optimize` - Optimization suggestions
- `migrate` - Cloud migration

**Options:**
- `--provider <name>` - Cloud provider
- `--region <region>` - Target region

### `security`
Security management.

```bash
claude-flow security <action> [target] [options]
```

**Actions:**
- `scan` - Security scanning
- `audit` - Security audit
- `report` - Generate reports
- `fix` - Auto-fix issues

**Options:**
- `--type <type>` - Scan type
- `--severity <level>` - Severity filter

### `analytics`
Performance analytics.

```bash
claude-flow analytics <action> [options]
```

**Actions:**
- `insights` - Generate insights
- `report` - Create reports
- `export` - Export data
- `dashboard` - View dashboard

**Options:**
- `--timerange <range>` - Time range
- `--metrics <list>` - Specific metrics

## 📊 Monitoring & Analytics

### `monitor`
Real-time system monitoring.

```bash
claude-flow monitor [options]
```

**Options:**
- `--dashboard` - Web dashboard
- `--metrics <list>` - Metrics to track
- `--alerts` - Enable alerting
- `--export` - Export metrics

### `logs`
View system logs.

```bash
claude-flow logs [component] [options]
```

**Options:**
- `--follow` - Follow log output
- `--since <time>` - Time filter
- `--level <level>` - Log level filter
- `--grep <pattern>` - Search pattern

### `benchmark`
Run performance benchmarks.

```bash
claude-flow benchmark [test] [options]
```

**Options:**
- `--iterations <n>` - Test iterations
- `--compare <baseline>` - Compare results
- `--export` - Export results

### `diagnose`
System diagnostics.

```bash
claude-flow diagnose [options]
```

**Options:**
- `--full` - Full diagnostic
- `--component <name>` - Specific component
- `--report` - Generate report

## 🎨 Output Formats

Most commands support multiple output formats:

- `--format table` - Table format (default)
- `--format json` - JSON format
- `--format yaml` - YAML format
- `--format csv` - CSV format
- `--format markdown` - Markdown format

## 🔧 Global Options

Available for all commands:

- `--help` - Show help
- `--version` - Show version
- `--verbose` - Verbose output
- `--quiet` - Suppress output
- `--no-color` - Disable colors
- `--config <file>` - Custom config file
- `--profile <name>` - Use profile

## 📚 Examples

### Complete Development Workflow
```bash
# 1. Initialize project
./claude-flow init --sparc

# 2. Start system
./claude-flow start --ui --monitor

# 3. Create swarm for development
./claude-flow swarm init --topology hierarchical --max-agents 8

# 4. Execute development task
./claude-flow swarm "Build complete REST API with authentication" \
  --strategy development \
  --parallel \
  --monitor

# 5. Monitor progress
./claude-flow monitor --dashboard

# 6. Create PR when ready
./claude-flow github pr-manager "Feature: Complete REST API implementation"

# 7. Deploy
./claude-flow deploy create v1.0.0 --strategy blue-green
```

---

**📖 For more examples and detailed guides, visit our [documentation](https://github.com/ruvnet/claude-code-flow/docs).**