🧠 Enterprise-Grade Multi-Agent AI Development Platform
- 🎛️ Professional Web Dashboard - Modern React/TypeScript interface
- 🛡️ Enterprise Security - Safe project management with confirmation workflows
- ⚡ Real-time Everything - Live WebSocket updates across all features
- 🗂️ Project Manager - Complete project lifecycle management
- ⚙️ Global Settings - Centralized configuration and API management
- 🔗 Multi-Agent Protocol - Agents coordinate through Redis backend
- 📊 Live Coordination Dashboard - Real-time agent monitoring with interactive graphs
- 🔒 File Locking System - Prevents conflicts during parallel development
- 💬 Agent Communication - Direct agent-to-agent messaging and interface sharing
- 📈 Comprehensive Analytics - Todo tracking, heartbeat monitoring, completion metrics
- 📋 Project Manager Homepage - Default landing page for power users
- 🗑️ Safe Deletion - Type project name to confirm with complete cleanup options
- 🔄 Project Reset - Clean slate functionality for testing and iteration
- 📊 Project Statistics - Real-time insights and health monitoring
- 🚀 One-Click Launch - Simplified project creation and setup
git clone https://github.com/webdevtodayjason/splitmind.git
cd splitmind
python setup.pypython launch-dashboard.pyThen open: http://localhost:8000
- 📊 Real-time Project Overview with live statistics
- 🤖 Agent Status Monitoring with start times and duration tracking
- 📈 Task Flow Visualization with drag-and-drop kanban boards
- ⚙️ Orchestrator Control with configurable agent limits and auto-merge
- 🔗 WebSocket Live Updates for instant status synchronization
- 🌊 Wave-Based Task Generation - Intelligent dependency management
- 🎯 Custom AI Prompts - Tailored instructions for each task
- 📋 Structured Task Breakdown - Professional development workflows
- 🔄 Adaptive Planning - Dynamic task adjustment based on progress
- 📝 Plan Editing - Manual refinement of AI-generated strategies
- 🤝 A2AMCP Protocol - Advanced agent-to-agent communication
- 📡 Real-time Coordination - Live monitoring of agent interactions
- 🔒 Conflict Prevention - File locking and resource management
- 💬 Agent Messaging - Direct communication between AI agents
- 🧩 Interface Sharing - Type definitions and shared components
- 🔐 Safe Project Deletion - Type confirmation with cleanup options
- 🔄 Project Reset - Complete environment cleanup
- ⚙️ Global Configuration - Centralized API key and settings management
- 📊 Audit Trails - Complete activity logging and monitoring
- 🚨 Error Recovery - Graceful handling of failures and conflicts
# Quick installation
python setup.py
# Launch dashboard
python launch-dashboard.py- Click ⚙️ Settings in top navigation
- Add your Anthropic API Key
- Configure Orchestrator Settings:
- Max concurrent agents (1-20)
- Auto-merge preferences
- Spawn intervals
- Project Manager opens as homepage for returning users
- Click "+ Create Project" or use "Manage Projects" button
- Configure project details:
- Name & Description
- Git Repository Path
- Agent Limits
- Navigate to project Settings Tab
- Add Project Overview and Initial Prompt
- Click "🚀 AI Task Master" for comprehensive planning
- Review generated wave-based task breakdown
- Start Orchestrator in project sidebar
- Watch real-time task progression:
UNCLAIMED→UP_NEXT→IN_PROGRESS→COMPLETED→MERGED
- Monitor agents in Coordination Dashboard:
- Live agent visualization
- File lock monitoring
- Communication tracking
- 📊 Task Board: Drag-and-drop task management
- 🤖 Agent Monitor: Live status and performance metrics
- 🔗 Coordination Tab: Real-time multi-agent coordination
- 📡 Event Stream: Live coordination events and communications
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ React/TS │ │ FastAPI │ │ Redis │
│ Frontend │◄──►│ Backend │◄──►│ Coordination │
│ │ │ │ │ Store │
└─────────────────┘ └─────────────────┘ └─────────────────┘
│ │ │
│ ┌─────────────────┐ │
│ │ WebSocket │ │
└──────────────┤ Real-time ├──────────────┘
│ Updates │
└─────────────────┘
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Agent 1 │ │ Coordination │ │ Agent 2 │
│ (Claude CLI) │◄──►│ Monitor │◄──►│ (Claude CLI) │
│ │ │ (Redis) │ │ │
└─────────────────┘ └─────────────────┘ └─────────────────┘
│ │ │
│ ┌─────────────────┐ │
│ │ File Locks │ │
└──────────────┤ & Messages ├──────────────┘
│ & Interfaces │
└─────────────────┘
Project Creation → AI Planning → Task Generation → Agent Spawning
│ │ │ │
▼ ▼ ▼ ▼
┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ Settings │ │ AI Task │ │ Wave │ │ Parallel │
│ & Overview │ │ Master │ │ Based │ │ Execution │
└─────────────┘ └─────────────┘ │ Tasks │ └─────────────┘
└─────────────┘ │
│ ▼
▼ ┌─────────────┐
┌─────────────┐ │ Real-time │
│Coordination │ │ Monitoring │
│ & Merge │ │ & Control │
└─────────────┘ └─────────────┘
Access via Settings icon in top navigation:
- API Key: Secure storage with validation
- Model Selection: Claude 3 Opus, Sonnet, Haiku, 3.5 Sonnet
- Direct link to Anthropic Console
- Enable/Disable: Master orchestrator switch
- Max Agents: 1-20 concurrent agents
- Auto-merge: Automatic vs manual review
- Spawn Interval: 10-600 second intervals
- Merge Strategy: merge, rebase, squash
Individual project configuration:
- Project Overview: Detailed context for AI agents
- Initial Prompt: Development objectives
- Max Agents: Project-specific limits
- Git Integration: Branch management and worktree handling
Location: Project → Coordination Tab
- Pulsing nodes represent active agents
- Color coding: 🟢 Active, 🟡 Working, 🔴 Offline
- Progress bars show todo completion
- File lock indicators prevent conflicts
- Communication lines show agent interactions
Real-time feed of:
- Agent registrations and heartbeats
- Todo creation and completion
- File locking and unlocking
- Inter-agent communications
- Task completion notifications
- Active vs Total Agents
- Todo Completion Rates
- File Lock Counts
- Communication Graph Analysis
Location: Project → Agents Tab
- Individual agent cards with health status
- Start times and duration tracking
- Live session monitoring
- iTerm integration for direct agent access
- Session management and cleanup tools
Default page for returning users - accessible via "Manage Projects"
- Visual project cards with status indicators
- Creation dates and Git repository status
- Quick access buttons: Edit, Reset, Delete
- Project statistics and health monitoring
- ✏️ Edit: Update name, description, settings
- 🔄 Reset: Clean tasks, sessions, branches
- 🗑️ Delete: Safe deletion with confirmation
Enterprise-grade protection:
⚠️ Hazardous confirmation dialog- Type project name to enable deletion
- Complete cleanup toggle:
- Safe: Remove from SplitMind only
- Complete: Remove tasks, worktrees, branches, sessions, .splitmind directory
- Real-time validation with visual feedback
- Disabled delete button until confirmed
splitmind/ # Main installation
├── 📄 README.md # This documentation
├── 🚀 launch-dashboard.py # One-click launcher
├── ⚙️ setup.py # Installation script
├── 📊 dashboard/ # Web interface
│ ├── 🔧 backend/ # FastAPI server
│ │ ├── api.py # REST endpoints
│ │ ├── orchestrator.py # Agent management
│ │ ├── coordination_monitor.py # A2AMCP monitoring
│ │ ├── models.py # Data structures
│ │ └── websocket_manager.py # Real-time updates
│ └── 🎨 frontend/ # React dashboard
│ ├── components/ # UI components
│ ├── services/ # API clients
│ └── hooks/ # Custom React hooks
├── 🤖 A2AMCP/ # Agent coordination
│ ├── mcp-server-redis.py # Coordination server
│ └── sdk/ # Python SDK
└── 📊 projects/ # User projects
└── your-project/ # Individual project
├── .splitmind/ # Project metadata
├── worktrees/ # Git worktrees
└── .git/ # Git repository
🗂️ Projects: /api/projects/*
📋 Tasks: /api/projects/{id}/tasks/*
🤖 Agents: /api/projects/{id}/agents/*
⚙️ Orchestrator: /api/orchestrator/*
🧠 Plan Gen: /api/projects/{id}/generate-*
🔗 Coordination: /api/projects/{id}/coordination/*
📊 Real-time Updates: /ws/updates
🔗 Coordination Stream: /api/projects/{id}/coordination/live
Redis Store:
├── 🤖 splitmind:{project}:agents # Agent registry
├── 💓 splitmind:{project}:heartbeat # Agent health
├── 📝 splitmind:{project}:todos # Task tracking
├── 🔒 splitmind:{project}:file_locks # Resource locks
├── 🧩 splitmind:{project}:interfaces # Shared types
└── 💬 splitmind:{project}:messages # Communications
Symptom: Delete button stays disabled Solution: Type the exact project name in confirmation field
Symptoms: Tasks not being picked up by agents Solutions:
- Check Orchestrator Status (should be green/running)
- Verify Agent Limits vs currently running agents
- Review File Conflicts in coordination tab
- Check Claude CLI configuration
Symptoms: No real-time updates, status indicators red Solutions:
- Refresh browser - auto-reconnects every 3 seconds
- Clear browser cache and reload
- Check backend is running on port 8000
- Restart dashboard:
python launch-dashboard.py
Symptoms: Agents not appearing in coordination tab Solutions:
- Verify Redis connection (Docker container running)
- Check MCP server on port 5050
- Restart A2AMCP:
cd A2AMCP && docker-compose restart - Check agent logs for MCP registration errors
Complete system reset:
# 1. Stop all processes
tmux kill-server
docker-compose -f A2AMCP/docker-compose.yml down
# 2. Clear configuration
rm -f config.json projects.json
# 3. Reset Redis data
docker-compose -f A2AMCP/docker-compose.yml down -v
# 4. Rebuild frontend
cd dashboard/frontend
rm -rf node_modules dist
npm install
npm run build
cd ../..
# 5. Restart everything
docker-compose -f A2AMCP/docker-compose.yml up -d
python launch-dashboard.pyVerbose logging:
python launch-dashboard.py --devEnhanced AI Instructions:
- Click any task card to open details
- Edit the AI Prompt field with specific requirements
- Add technical specifications and context
- Include dependency information and constraints
Real-time Agent Analysis:
- Navigate to Coordination Tab in any project
- 🕸️ Live Graph: Interactive agent visualization
- 📡 Event Stream: Real-time coordination events
- 🔒 File Locks: Active resource conflicts
- 📈 Statistics: Performance metrics and health
Enterprise Project Management:
- Project Manager Homepage: Overview of all projects
- Quick switching: Select projects from top navigation
- Bulk operations: Reset or delete multiple projects
- Resource monitoring: Cross-project agent usage
Performance Tuning:
- Agent Limits: Balance speed vs system resources
- Spawn Intervals: Adjust based on task complexity
- Auto-merge Settings: Enable for faster iteration
- File Lock Monitoring: Prevent coordination conflicts
- 🔗 GitHub Integration: Direct PR management
- 📊 Analytics Dashboard: Performance insights and metrics
- 🤖 Agent Templates: Pre-configured agent behaviors
- 🔄 Workflow Automation: Custom development pipelines
- ☁️ Cloud Deployment: One-click cloud hosting
- 👥 Team Collaboration: Multi-user project management
- 🔌 Plugin System: Custom integrations and extensions
- 📱 Mobile Interface: Project monitoring on mobile
- 🧠 Multi-LLM Support: OpenAI, Gemini, local models
- 🔄 Advanced Coordination: Complex multi-agent workflows
- 📊 Enterprise Features: SSO, audit logs, compliance
- 🌐 Distributed Agents: Cross-platform and remote execution
# 1. Fork and clone
git clone https://github.com/yourusername/splitmind.git
cd splitmind
# 2. Install dependencies
python setup.py
# 3. Start development server
python launch-dashboard.py --dev
# 4. Frontend development
cd dashboard/frontend
npm run dev # Hot reload development- 🔍 Check Issues: Look for existing bugs or feature requests
- 🌿 Create Branch:
git checkout -b feature/amazing-feature - ✅ Follow Standards: Use existing code style and patterns
- 🧪 Test Changes: Verify all functionality works
- 📝 Update Docs: Add documentation for new features
- 🔄 Submit PR: Detailed description of changes
- 🎨 Frontend: React/TypeScript components in
/dashboard/frontend - 🔧 Backend: FastAPI endpoints in
/dashboard/backend - 🤖 Coordination: A2AMCP protocol in
/A2AMCP - 📊 Monitoring: Real-time features and WebSocket handling
MIT License - see LICENSE file for details.
SplitMind is open source software built for the developer community.
- Anthropic Claude - Powering intelligent agent coordination
- Claude Code - Development acceleration platform
- React + TypeScript - Modern frontend development
- FastAPI + Python - High-performance backend
- Redis - Real-time coordination store
- WebSockets - Live dashboard updates
- Docker - Containerized coordination services
- Early Adopters - Feedback and testing
- Contributors - Code, documentation, and ideas
- Developer Community - Inspiration and innovation
- 📧 Email: [email protected]
- 🐛 Issues: GitHub Issues
- 📖 Documentation: Full Docs
- 🐙 GitHub: @webdevtodayjason
- 🐦 Twitter: @webdevtodayjason
- 💼 LinkedIn: Jason Brashear
- 🌐 Website: WebDevToday.com
For enterprise licensing, custom integrations, or professional support:
- 📧 Enterprise: [email protected]
- 📞 Consulting: Available for custom implementations
🧠 SplitMind v2.0 - Where AI Agents Collaborate
Built with ❤️ by Jason Brashear
ai-development multi-agent claude-ai task-orchestration real-time-coordination web-dashboard enterprise-tools parallel-development agent-coordination a2amcp redis websockets react typescript fastapi python