🧠 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.py

python launch-dashboard.py

Then 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

1. Click ⚙️ Settings in top navigation
2. Add your Anthropic API Key
3. Configure Orchestrator Settings:
   • Max concurrent agents (1-20)
   • Auto-merge preferences
   • Spawn intervals

1. Project Manager opens as homepage for returning users
2. Click "+ Create Project" or use "Manage Projects" button
3. Configure project details:
   • Name & Description
   • Git Repository Path
   • Agent Limits

1. Navigate to project Settings Tab
2. Add Project Overview and Initial Prompt
3. Click "🚀 AI Task Master" for comprehensive planning
4. Review generated wave-based task breakdown

1. Start Orchestrator in project sidebar
2. Watch real-time task progression:
   • UNCLAIMED → UP_NEXT → IN_PROGRESS → COMPLETED → MERGED
3. 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:

1. ⚠️ Hazardous confirmation dialog
2. Type project name to enable deletion
3. Complete cleanup toggle:
   • Safe: Remove from SplitMind only
   • Complete: Remove tasks, worktrees, branches, sessions, .splitmind directory
4. Real-time validation with visual feedback
5. 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:

1. Check Orchestrator Status (should be green/running)
2. Verify Agent Limits vs currently running agents
3. Review File Conflicts in coordination tab
4. Check Claude CLI configuration

Symptoms: No real-time updates, status indicators red Solutions:

1. Refresh browser - auto-reconnects every 3 seconds
2. Clear browser cache and reload
3. Check backend is running on port 8000
4. Restart dashboard: python launch-dashboard.py

Symptoms: Agents not appearing in coordination tab Solutions:

1. Verify Redis connection (Docker container running)
2. Check MCP server on port 5050
3. Restart A2AMCP: cd A2AMCP && docker-compose restart
4. 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.py

Verbose logging:

python launch-dashboard.py --dev

Enhanced AI Instructions:

1. Click any task card to open details
2. Edit the AI Prompt field with specific requirements
3. Add technical specifications and context
4. Include dependency information and constraints

Real-time Agent Analysis:

1. Navigate to Coordination Tab in any project
2. 🕸️ Live Graph: Interactive agent visualization
3. 📡 Event Stream: Real-time coordination events
4. 🔒 File Locks: Active resource conflicts
5. 📈 Statistics: Performance metrics and health

Enterprise Project Management:

1. Project Manager Homepage: Overview of all projects
2. Quick switching: Select projects from top navigation
3. Bulk operations: Reset or delete multiple projects
4. 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

1. 🔍 Check Issues: Look for existing bugs or feature requests
2. 🌿 Create Branch: git checkout -b feature/amazing-feature
3. ✅ Follow Standards: Use existing code style and patterns
4. 🧪 Test Changes: Verify all functionality works
5. 📝 Update Docs: Add documentation for new features
6. 🔄 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