Skip to content

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.

License

Notifications You must be signed in to change notification settings

ruvnet/claude-code-flow

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

69 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🌊 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

About

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.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •