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!
- ✅ 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
- ✅ 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
- ✅ 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
# 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"
# 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"
- 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
- 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
- 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
# 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
# Install globally
npm install -g claude-flow
# Initialize anywhere
claude-flow init --sparc
# Use directly
claude-flow start --ui
# Add to project
npm install claude-flow --save-dev
# Initialize
npx claude-flow init --sparc
# Use with local wrapper
./claude-flow start --ui
# 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
# 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'"
# 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"
# 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
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 |
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" |
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 |
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 |
┌─────────────────────────────────────────────────────────┐
│ 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 │
└─────────────────────────────────────────────────────────┘
- 🎛️ 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
# 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
- ✅ 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
We welcome contributions! Here's how to get started:
# 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
- 🐛 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
MIT License - see LICENSE for details.
- 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
npx claude-flow@latest init --sparc
Join thousands of developers already using Claude-Flow!
Built with ❤️ by rUv | Powered by Claude AI