Package Exports
- claude-flow
- claude-flow/src/cli/main.ts
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (claude-flow) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
๐ Claude-Flow v1.0.50: Advanced AI Agent Orchestration Platform
๐ฏ Transform Your Development Workflow
Claude-Flow is the ultimate multi-terminal orchestration platform that revolutionizes how you work with Claude Code. Coordinate multiple AI agents simultaneously, each working on different aspects of your project while sharing knowledge through an intelligent memory bank.
๐ฅ One command to rule them all:
npx claude-flow@latest- Deploy a full AI agent coordination system in seconds!
๐ What's New in v1.0.50
๐ฏ BatchTool Parallel Agent System
- โ Hundreds Concurrent Agents: Deploy up to 100+ AI agents simultaneously via BatchTool
- โ TypeScript Infrastructure Improvements: 91% reduction in compilation errors (379โ32)
- โ Enhanced Test Framework: Parallel testing with comprehensive coverage
- โ Improved Build Process: Streamlined Deno compilation with dependency fixes
- โ Advanced Swarm Coordination: Multi-agent task distribution and monitoring
๐ง Core Improvements
- Fixed import path issues and dependency management
- Enhanced error handling and type safety
- Improved test utilities and async operations
- Optimized parallel execution efficiency (71% faster)
- Maintained full backward compatibility
โก Quick Start
๐ Instant Setup
# Install and initialize with SPARC development environment
npx claude-flow@latest init --sparc
# Start the orchestration system
./claude-flow start --ui
# Deploy multiple agents with BatchTool
./claude-flow swarm "Build a REST API" --max-agents 5 --parallel๐๏ธ SPARC Development Modes (17 Specialized Agents)
# List all available SPARC modes
./claude-flow sparc modes
# Run specific development workflows
./claude-flow sparc run architect "design microservice architecture"
./claude-flow sparc run tdd "create comprehensive test suite"
./claude-flow sparc run security-review "audit authentication system"๐๏ธ 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 (Recommended)
# Initialize with full SPARC environment
npx claude-flow@latest init --sparc
# This creates:
# โ CLAUDE.md (SPARC-enhanced configuration)
# โ .roomodes (17 pre-configured SPARC modes)
# โ Local ./claude-flow executable
# โ Memory and coordination directories
# โ Claude Code slash commandsMethod 2: Global Installation
# Install globally
npm install -g claude-flow@latest
# Initialize anywhere
claude-flow init --sparcMethod 3: Deno Direct
# Clone and build from source
git clone https://github.com/ruvnet/claude-code-flow.git
cd claude-code-flow
deno task build๐ฎ Usage Examples
๐ Basic Operations
# Check system status
./claude-flow status
# Start orchestration with UI
./claude-flow start --ui
# Spawn individual agents
./claude-flow agent spawn researcher --name "DataBot"
./claude-flow agent spawn coder --name "DevBot"๐ฅ 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 |
๐๏ธ 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 with parallel agents
deno task test
# Run specific test categories
deno task test:unit # Unit tests
deno task test:integration # Integration tests
deno task test:e2e # End-to-end tests
# Generate coverage reports
deno task test:coverageQuality Metrics (v1.0.50)
- โ TypeScript Errors: Reduced from 379 to 32 (91% improvement)
- โ Build Process: Streamlined and optimized
- โ Test Coverage: Comprehensive with parallel execution
- โ Performance: 71% faster parallel execution vs sequential
- โ Stability: Full backward compatibility maintained
๐ Documentation & Resources
Getting Started
Advanced Topics
- ๐ง BatchTool Integration
- ๐ Monitoring & Analytics
- ๐ MCP Server Setup
- ๐ Security Best Practices
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 and setup
deno cache --reload src/deps.ts
# Run tests
deno task test
# Build the project
deno task buildContributing 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
- Deno Team: For the excellent TypeScript 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 --sparcJoin thousands of developers already using Claude-Flow!
Built with โค๏ธ by rUv | Powered by Claude AI