/claude-code-flow

This mode serves as a code-first swarm orchestration layer, enabling Claude Code to write, edit, test, and optimize code autonomously across recursive agent cycles.

Primary LanguageTypeScriptMIT LicenseMIT

๐ŸŒŠ Claude-Flow v1.0.72: Advanced AI Agent Orchestration Platform

๐ŸŒŸ Star on GitHub ๐Ÿ“ฆ NPX Ready โšก Claude Code ๐Ÿฆ• Multi-Runtime โšก TypeScript ๐Ÿ›ก๏ธ MIT License

๐ŸŽฏ Transform Your Development Workflow

Claude-Flow is the ultimate orchestration platform that revolutionizes how you work with Claude Code. Coordinate multiple AI agents simultaneously, manage complex workflows, and build sophisticated applications with AI-powered development.

๐Ÿ”ฅ One command to rule them all: npx claude-flow@latest init --sparc - Deploy a full AI agent coordination system in seconds!

๐Ÿš€ What's New in v1.0.72

๐ŸŽฏ Claude Code Settings Optimization

  • โœ… Auto-Settings Creation: init command now creates .claude/settings.json with automation-optimized settings
  • โœ… Extended Timeouts: 5-minute default, 10-minute max for Bash commands (300s/600s)
  • โœ… Full Tool Permissions: All tools allowed with wildcards (*) for complete automation
  • โœ… Large Output Support: 500KB character limit for handling extensive outputs
  • โœ… Automation Features: Parallel execution, batch operations, and auto-save to memory enabled

๐Ÿ”ง Enhanced SPARC Integration

  • โœ… Better Prompts: SPARC and swarm prompts now emphasize batch tools and memory usage
  • โœ… Memory First: All modes now save to memory after each step for better coordination
  • โœ… Agent Clarity: Swarm prompts specify exact agent counts and immediate execution
  • โœ… Task Tracking: Added visual progress indicators and task format to all prompts
  • โœ… Action-Oriented: Changed from planning to immediate execution language

๐Ÿš€ Developer Experience

  • โœ… Zero Configuration: Optimal settings applied automatically on init
  • โœ… Long Operations: Support for extended running tasks without timeouts
  • โœ… Better Reliability: Auto-accept for Claude Code warnings in swarm mode
  • โœ… Version Consistency: All components updated to v1.0.72

โšก Quick Start

๐Ÿš€ Instant Setup

# Install and initialize with SPARC development environment
npx claude-flow@latest init --sparc

# Use the local wrapper (created by init)
./claude-flow start --ui --port 3000

# Run SPARC commands
./claude-flow sparc "build a REST API"

๐ŸŽ›๏ธ SPARC Development Modes (17 Specialized Agents)

# List all available SPARC modes
./claude-flow sparc modes

# Run specific development workflows
./claude-flow sparc run coder "implement user authentication"
./claude-flow sparc run architect "design microservice architecture"
./claude-flow sparc tdd "create test suite for API"

๐Ÿ—๏ธ Core Features

๐Ÿค– Multi-Agent Orchestration

  • Parallel Execution: Run up to 10 agents concurrently with BatchTool
  • Smart Coordination: Intelligent task distribution and load balancing
  • Memory Sharing: Persistent knowledge bank across all agents
  • Real-time Monitoring: Live dashboard for agent status and progress

๐Ÿง  SPARC Development Framework

  • 17 Specialized Modes: Architect, Coder, TDD, Security, DevOps, and more
  • Workflow Orchestration: Complete development lifecycle automation
  • Interactive & Non-interactive: Flexible execution modes
  • Boomerang Pattern: Iterative development with continuous refinement

๐Ÿ“Š Advanced Monitoring & Analytics

  • System Health Dashboard: Real-time metrics and performance tracking
  • Task Coordination: Dependency management and conflict resolution
  • Terminal Pool Management: Efficient resource utilization
  • Coverage Reports: Comprehensive test and code coverage analysis

๐Ÿ› ๏ธ Installation & Setup

Method 1: Quick Start with NPX (Recommended)

# Initialize with full SPARC environment
npx claude-flow@latest init --sparc

# This creates:
# โœ“ Local ./claude-flow wrapper script
# โœ“ .claude/ directory with configuration
# โœ“ CLAUDE.md (project instructions for Claude Code)
# โœ“ .roomodes (17 pre-configured SPARC modes)
# โœ“ Swarm command documentation

# Start using immediately
./claude-flow start --ui --port 3000

Method 2: Global Installation

# Install globally
npm install -g claude-flow

# Initialize anywhere
claude-flow init --sparc

# Use directly
claude-flow start --ui

Method 3: Local Project Installation

# Add to project
npm install claude-flow --save-dev

# Initialize
npx claude-flow init --sparc

# Use with local wrapper
./claude-flow start --ui

๐ŸŽฎ Usage Examples

๐Ÿš€ Basic Operations

# Check system status
./claude-flow status

# Start orchestration with Web UI
./claude-flow start --ui --port 3000

# Check MCP server status
./claude-flow mcp status

# Manage agents
./claude-flow agent spawn researcher --name "DataBot"
./claude-flow agent info agent-123
./claude-flow agent terminate agent-123

๐Ÿ”ฅ Advanced Workflows

Multi-Agent Development

# Deploy swarm for full-stack development
./claude-flow swarm "Build e-commerce platform" \
  --strategy development \
  --max-agents 5 \
  --parallel \
  --monitor

# BatchTool parallel development
batchtool run --parallel \
  "./claude-flow sparc run architect 'design user auth'" \
  "./claude-flow sparc run code 'implement login API'" \
  "./claude-flow sparc run tdd 'create auth tests'" \
  "./claude-flow sparc run security-review 'audit auth flow'"

SPARC Development Modes

# Complete development workflow
./claude-flow sparc run ask "research best practices for microservices"
./claude-flow sparc run architect "design scalable architecture"
./claude-flow sparc run code "implement user service"
./claude-flow sparc run tdd "create comprehensive test suite"
./claude-flow sparc run integration "integrate all services"
./claude-flow sparc run devops "setup CI/CD pipeline"

Memory & Coordination

# Store and query project knowledge
./claude-flow memory store requirements "User auth with JWT"
./claude-flow memory store architecture "Microservice design patterns"
./claude-flow memory query auth

# Task coordination
./claude-flow task create research "Market analysis for AI tools"
./claude-flow task workflow examples/development-pipeline.json

๐Ÿ“‹ Available Commands

Core Commands

Command Description Example
init Initialize project with Claude integration ./claude-flow init --sparc
start Start orchestration system ./claude-flow start --ui
status Show system health and metrics ./claude-flow status
agent Manage AI agents and hierarchies ./claude-flow agent spawn researcher
swarm Advanced multi-agent coordination ./claude-flow swarm "Build API" --parallel

SPARC Development Modes

Mode Purpose Example
architect System design and architecture ./claude-flow sparc run architect "design API"
code Code development and implementation ./claude-flow sparc run code "user authentication"
tdd Test-driven development ./claude-flow sparc run tdd "payment system"
security-review Security auditing and analysis ./claude-flow sparc run security-review "auth flow"
integration System integration and testing ./claude-flow sparc run integration "microservices"
devops Deployment and CI/CD ./claude-flow sparc run devops "k8s deployment"

Memory & Coordination

Command Description Example
memory store Store information in knowledge bank ./claude-flow memory store key "value"
memory query Search stored information ./claude-flow memory query "authentication"
task create Create and manage tasks ./claude-flow task create research "AI trends"
monitor Real-time system monitoring ./claude-flow monitor --dashboard

Enterprise Commands

Command Description Example
project Project lifecycle management ./claude-flow project create "API Project" --type web-app
deploy Deployment automation & strategies ./claude-flow deploy create "v1.2.0" --strategy blue-green
cloud Multi-cloud infrastructure management ./claude-flow cloud resources create "web-server" compute
security Security scanning & compliance ./claude-flow security scan "Vulnerability Check" ./src
analytics Performance analytics & insights ./claude-flow analytics insights --timerange 7d
audit Enterprise audit logging ./claude-flow audit report compliance --framework SOC2

๐Ÿ—๏ธ Architecture Overview

Multi-Layer Agent System

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚                 BatchTool Orchestrator                  โ”‚
โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
โ”‚  Agent 1    Agent 2    Agent 3    Agent 4    Agent 5   โ”‚
โ”‚ Architect โ”‚   Coder   โ”‚   TDD    โ”‚ Security โ”‚  DevOps   โ”‚
โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
โ”‚              Shared Memory Bank & Coordination          โ”‚
โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
โ”‚         Terminal Pool & Resource Management             โ”‚
โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
โ”‚              Claude Code Integration Layer              โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

Key Components

  • ๐ŸŽ›๏ธ Orchestrator: Central coordination and task distribution
  • ๐Ÿค– Agent Pool: Specialized AI agents for different domains
  • ๐Ÿง  Memory Bank: Persistent knowledge sharing across agents
  • ๐Ÿ“Š Monitor: Real-time metrics and health monitoring
  • ๐Ÿ”— MCP Server: Model Context Protocol for tool integration

๐Ÿงช Testing & Quality Assurance

Comprehensive Test Coverage

# Run full test suite
npm test

# Run specific test categories
npm run test:unit        # Unit tests
npm run test:integration # Integration tests
npm run test:e2e         # End-to-end tests

# Generate coverage reports
npm run test:coverage

# Lint and typecheck
npm run lint
npm run typecheck

Quality Metrics (v1.0.72)

  • โœ… Project-Focused: CLAUDE.md explicitly guides building user applications
  • โœ… Clear Instructions: No confusion about modifying claude-flow itself
  • โœ… Real Examples: All documentation shows building actual applications
  • โœ… NPM Publishing: Fully compatible with npx and global installation
  • โœ… Cross-Platform: Windows, Mac, and Linux support

๐Ÿ“š Documentation & Resources

Getting Started

Advanced Topics

API Reference


๐Ÿค Contributing

We welcome contributions! Here's how to get started:

Development Setup

# Clone the repository
git clone https://github.com/ruvnet/claude-code-flow.git
cd claude-code-flow

# Install dependencies
npm install

# Build the project
npm run build

# Run tests
npm test

# Link for local development
npm link

Contributing Guidelines

  • ๐Ÿ› Bug Reports: Use GitHub issues with detailed reproduction steps
  • ๐Ÿ’ก Feature Requests: Propose new features with use cases
  • ๐Ÿ”ง Pull Requests: Follow our coding standards and include tests
  • ๐Ÿ“š Documentation: Help improve docs and examples

๐Ÿ“„ License

MIT License - see LICENSE for details.


๐ŸŽ‰ Acknowledgments

  • Anthropic: For the amazing Claude AI that powers this platform
  • Node.js Team: For the excellent JavaScript runtime
  • Open Source Community: For contributions and feedback
  • SPARC Methodology: For the structured development approach

๐Ÿš€ Ready to transform your development workflow?

npx claude-flow@latest init --sparc

Join thousands of developers already using Claude-Flow!

GitHub NPM Discord


Built with โค๏ธ by rUv | Powered by Claude AI