ExoMind

AI-powered cognitive architecture combining SPARC methodology, swarm intelligence, and personal knowledge management for enhanced productivity and decision-making.

🚀 Overview

ExoMind is an advanced development environment that integrates:

SPARC Methodology - Systematic Test-Driven Development (Specification, Pseudocode, Architecture, Refinement, Completion)
Claude Flow - Multi-agent swarm orchestration with 54+ specialized agents
Superpowers - Enhanced Claude Code skills and capabilities
Anthropic Skills - Official example and document skills (PDF, DOCX, PPTX, XLSX)
Knowledge Management - Personal OS and productivity tools
Google Workspace Integration - Gmail and Calendar access via MCP

✨ Features

🧠 54+ Specialized AI Agents - From backend development to consensus algorithms
⚡ Parallel Execution - 2.8-4.4x speed improvement with concurrent agent coordination
🎯 84.8% SWE-Bench Solve Rate - Proven effectiveness in software engineering tasks
💾 Cross-Session Memory - Persistent context and learning across sessions
🔗 GitHub Integration - Automated PR management, code review, and release coordination
📊 Performance Analytics - Real-time metrics and bottleneck detection
🌐 Google Workspace - Email and calendar management through Claude Code

📋 Prerequisites

Node.js (v18 or higher)
Claude Desktop or Claude Code CLI
Git (for submodules)

🔧 Installation

1. Clone the Repository with Submodules

# Clone with all submodules in one command
git clone --recurse-submodules https://github.com/natea/ExoMind.git
cd ExoMind

# Or clone first, then initialize submodules
git clone https://github.com/natea/ExoMind.git
cd ExoMind
git submodule update --init --recursive

Included Submodules:

modules/superpowers - Enhanced skills for TDD, brainstorming, debugging
modules/anthropic-claude-skills - Official Anthropic skills (documents, creative, dev)
modules/ar-claude-skills - Professional skills for C-level advisors, marketing, and product teams
modules/claude-code-by-agents - Multi-agent workspace with web UI for coordination
modules/mcp-getgather - Context gathering and web scraping
modules/Skill_Seekers - Auto-generate skills from documentation
modules/life-os - Personal productivity and life management

2. Initialize Claude Flow

Claude Flow provides the core multi-agent orchestration framework:

# Initialize Claude Flow in your project
npx claude-flow@alpha init

# Verify installation
npx claude-flow@alpha --version

3. Configure MCP Servers in Claude Code

MCP (Model Context Protocol) servers extend Claude Code with specialized capabilities.

Core MCP Servers (Required)

# Add Claude Flow MCP server (required for swarm coordination)
claude mcp add claude-flow npx claude-flow@alpha mcp start

# Verify MCP server is running
claude mcp list

Optional MCP Servers

# Enhanced swarm coordination with WASM acceleration
claude mcp add ruv-swarm npx ruv-swarm mcp start

# Cloud-based orchestration with 70+ advanced features
claude mcp add flow-nexus npx flow-nexus@latest mcp start

# Flow-Nexus requires registration:
# npx flow-nexus@latest register
# npx flow-nexus@latest login

4. Add Google Workspace Integration (Gmail & Calendar)

There are two options for Google Workspace integration:

Option A: Composio MCP (Recommended - Easiest Setup)

Composio provides a unified authentication layer for multiple services including Google Workspace:

# Install Composio MCP
npm install -g composio-core

# Add Composio MCP to Claude Code
claude mcp add composio npx composio-core mcp

# Authenticate with Google Workspace
composio add googleworkspace

# This will open a browser for OAuth authentication
# Grant access to Gmail and Google Calendar

Composio Configuration:

Add to your Claude Code MCP settings (~/.config/claude/mcp_settings.json):

{
  "mcpServers": {
    "composio": {
      "command": "npx",
      "args": ["composio-core", "mcp"],
      "env": {
        "COMPOSIO_API_KEY": "your-composio-api-key"
      }
    }
  }
}

Get your Composio API key:

Sign up at Composio Dashboard
Navigate to Settings → API Keys
Copy your API key

Available Composio Actions:

gmail_send_email - Send emails via Gmail
gmail_search - Search email messages
gmail_read_message - Read specific emails
calendar_list_events - List calendar events
calendar_create_event - Create new events
calendar_update_event - Update existing events

Option B: Direct Google Workspace MCP

For more control, use the direct Google Workspace MCP:

# Install the Google Workspace MCP
npm install -g @modelcontextprotocol/server-google-workspace

# Add to Claude Code
claude mcp add google-workspace npx @modelcontextprotocol/server-google-workspace

Google Cloud Setup:

Create a project in Google Cloud Console
Enable Gmail API and Google Calendar API
Create OAuth 2.0 credentials (Desktop application)
Download credentials as credentials.json

Configuration:

Add to your MCP settings:

{
  "mcpServers": {
    "google-workspace": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-google-workspace"],
      "env": {
        "GOOGLE_CREDENTIALS_PATH": "/path/to/credentials.json",
        "GOOGLE_TOKEN_PATH": "/path/to/token.json"
      }
    }
  }
}

First-time Authentication:

# Run authentication flow
npx @modelcontextprotocol/server-google-workspace auth

# This will:
# 1. Open your browser for Google OAuth
# 2. Request permissions for Gmail and Calendar
# 3. Save the token to GOOGLE_TOKEN_PATH

5. Add Superpowers Plugin (Enhanced Skills)

Superpowers provides systematic development workflows, brainstorming, TDD, and debugging skills:

# Add Superpowers from marketplace
/plugin marketplace add obra/superpowers-marketplace

# Install the plugin
/plugin install superpowers@superpowers-marketplace

What You Get:

🧠 Brainstorming - Interactive design refinement using Socratic method
🧪 Test-Driven Development - RED-GREEN-REFACTOR workflows
🐛 Systematic Debugging - Root cause tracing and pattern analysis
✅ Code Review - Verification and validation frameworks
📝 Planning & Execution - Writing and executing implementation plans

Usage in Claude Code:

"Use the brainstorming skill to refine this API design"
"Apply TDD workflow to implement user authentication"
"Use systematic debugging to find the root cause of this error"

6. Add MCP GetGather (Context Gathering)

GetGather enables intelligent web content extraction and research automation:

# Start GetGather MCP server (runs on port 23456)
cd modules/mcp-getgather
python server.py

Configuration:

Add to your MCP settings (~/.config/claude/mcp_settings.json):

{
  "mcpServers": {
    "getgather": {
      "url": "http://127.0.0.1:23456/mcp"
    }
  }
}

What You Get:

🌐 Web Scraping - Extract content from any website
📄 Document Processing - Parse and analyze documents
🔍 Research Automation - Gather information across multiple sources
📊 Context Aggregation - Synthesize information from various sources

Usage in Claude Code:

"Use getgather to extract all API documentation from https://docs.example.com"
"Gather context from these 5 research papers"
"Scrape and summarize the latest release notes"

7. Add Skill Seekers (Auto-Generate Claude Skills)

Skill Seekers automatically converts any documentation website into a Claude Code skill:

Key Capabilities:

🚀 Auto-Generate Skills - Convert any docs site into a Claude skill in minutes
📚 Documentation Learning - Scrape and organize documentation automatically
🧠 AI Enhancement - Use Claude to create comprehensive skill guides
📦 One-Click Packaging - Package skills ready for upload to Claude

Quick Setup:

cd modules/Skill_Seekers

# Install dependencies
pip3 install requests beautifulsoup4

# Generate a skill from any documentation site
python3 cli/doc_scraper.py --config configs/react.json --enhance-local

# Package the skill
python3 cli/package_skill.py output/react/

# Upload to Claude Code (output/react.zip)

Example: Create a React Skill

# Scrape React documentation and create a skill (20-30 minutes)
python3 cli/doc_scraper.py \
  --name react \
  --url https://react.dev/ \
  --description "React framework for building UIs" \
  --enhance-local

# Package the skill
python3 cli/package_skill.py output/react/

# Upload output/react.zip to Claude

Using MCP Server (Easiest):

# One-time setup
cd modules/Skill_Seekers
./setup_mcp.sh

# Then in Claude Code, use natural language:
"Generate a skill from https://tailwindcss.com/docs"
"List all available skill configs"
"Package the React skill"

What Skill Seekers Creates:

✅ SKILL.md - Comprehensive guide with real code examples
✅ References/ - Organized documentation by category
✅ Code Examples - Extracted from actual documentation
✅ Quick Reference - Common patterns and best practices

Pre-built Configs:

react.json - React framework
vue.json - Vue.js
django.json - Django web framework
fastapi.json - FastAPI
godot.json - Godot game engine

For Large Documentation (10K+ pages):

# Estimate page count first
python3 cli/estimate_pages.py configs/godot.json

# Auto-split into focused sub-skills
python3 cli/split_config.py configs/godot.json --strategy router

# Scrape in parallel (much faster!)
for config in configs/godot-*.json; do
  python3 cli/doc_scraper.py --config $config &
done

See modules/Skill_Seekers/README.md for full documentation.

8. Add VoiceMode (Voice Conversations)

VoiceMode enables natural voice conversations with Claude, supporting both local STT/TTS services and OpenAI fallback:

# Install VoiceMode MCP python package and dependencies
curl -LsSf https://astral.sh/uv/install.sh | sh
uvx voice-mode-install

# Optional: Set OpenAI API key (backup if local services unavailable)
export OPENAI_API_KEY=your-openai-key

# Add VoiceMode to Claude
claude mcp add --scope user voicemode -- uvx --refresh voice-mode

# Start a voice conversation
claude converse

What You Get:

🎤 Voice Input - Speak naturally to Claude instead of typing
🔊 Voice Output - Hear Claude's responses in natural speech
🏠 Local Processing - Uses Whisper (STT) and Kokoro (TTS) for privacy
☁️ OpenAI Fallback - Automatic fallback when local services unavailable
🎯 Low Latency - Fast response times with optimized processing

Service Management:

VoiceMode provides a unified service management tool:

# Check service status
uvx voice-mode service whisper status
uvx voice-mode service kokoro status

# Start/stop services
uvx voice-mode service whisper start
uvx voice-mode service kokoro start

# View logs
uvx voice-mode service whisper logs
uvx voice-mode service kokoro logs

# Enable auto-start on boot
uvx voice-mode service whisper enable
uvx voice-mode service kokoro enable

Documentation & Resources:

Website: getvoicemode.com
MCP Resources: Access via voicemode://docs/*
- voicemode://docs/quickstart - Basic usage guide
- voicemode://docs/parameters - Complete parameter reference
- voicemode://docs/languages - Non-English language support
- voicemode://docs/troubleshooting - Audio and connectivity issues

9. Verify Setup

# List all configured MCP servers
claude mcp list

# Test Claude Flow
npx claude-flow@alpha sparc modes

# Test Composio (if installed)
composio apps

# Check Google Workspace connection
# Open Claude Code and try: "Check my Gmail inbox"

# Test GetGather (if running)
# In Claude Code: "Use getgather to fetch https://example.com"

# Check Superpowers
# In Claude Code: "List all available superpowers skills"

# Test VoiceMode (if installed)
uvx voice-mode service whisper status
uvx voice-mode service kokoro status
# Try: claude converse

📚 Included Submodules

ExoMind includes six specialized modules in the modules/ directory:

Superpowers

Enhanced Claude Code skills for systematic development workflows.

Installation: /plugin install superpowers@superpowers-marketplace

Key Features:

Brainstorming and design refinement using Socratic method
Test-driven development with RED-GREEN-REFACTOR cycles
Systematic debugging with root cause tracing
Code review and validation frameworks
Implementation plan writing and execution

Skills Include:

brainstorming - Interactive design refinement
test-driven-development - TDD workflows
systematic-debugging - Debug with structure
requesting-code-review - Request reviews properly
receiving-code-review - Handle feedback effectively
verification-before-completion - Never skip verification

MCP GetGather

MCP server for intelligent context gathering and information synthesis.

Installation: Add to MCP settings with http://127.0.0.1:23456/mcp

Key Features:

Web content extraction from any URL
Document processing and parsing
Context aggregation across sources
Research automation workflows

Use Cases:

Extract API documentation from websites
Gather research from multiple sources
Scrape and summarize release notes
Collect examples and code snippets

Skill Seekers

Automatically convert documentation websites into Claude Code skills.

Key Features:

Universal Documentation Scraper - Works with ANY docs site
AI-Powered Enhancement - Creates comprehensive guides with examples
MCP Server Integration - Use from Claude Code with natural language
Large Documentation Support - Handle 10K-40K+ page sites
Router/Hub Skills - Intelligent routing to specialized sub-skills
8 Pre-built Configs - React, Vue, Django, FastAPI, Godot, and more

Quick Start:

cd modules/Skill_Seekers
python3 cli/doc_scraper.py --config configs/react.json --enhance-local
python3 cli/package_skill.py output/react/
# Upload output/react.zip to Claude

What Gets Created:

Comprehensive SKILL.md with real examples
Categorized reference documentation
Code patterns and best practices
Quick reference guides

Life OS

Personal operating system for productivity and life management with 20+ integrated skills.

Complete Implementation (Weeks 1-11):

✅ 20+ Skills - Full GTD workflow, reviews, goal tracking, integrations
✅ 100+ Source Files - TypeScript codebase with configuration management
✅ 600+ Tests - Comprehensive test coverage
✅ 10K+ Lines of Docs - Complete user guides and API documentation

Core Skills:

conducting-life-assessment - 10 life areas quarterly evaluation
daily-planning - Morning/evening routines with energy management
weekly-review - Complete GTD methodology
monthly-review - Intelligent aggregation and pattern detection
quarterly-review - OKR scoring and 90-day retrospectives
goal-setting - SMART goals + OKR framework
processing-inbox - GTD inbox processing workflow

Integration Skills:

processing-email-inbox - Email-to-task conversion via Google Workspace MCP
analyzing-schedule - Calendar analysis and optimization
scheduling-tasks - Smart time blocking
whatsapp-message-management - Mobile briefings and quick capture
resolving-sync-conflicts - Todoist conflict resolution

Advanced Skills:

detecting-patterns - 6 pattern types across productivity data
smart-recommendations - AI-powered insights
tracking-habits - Streak management and consistency analysis
coordinating-life-os - System orchestration and health checks

Life Management:

meal-planning - Weekly meal planning with dietary preferences
recipe-finding - Recipe search and scaling
grocery-shopping - Automated shopping list generation

Quick Start:

# Install dependencies
npm install

# Test the skills in Claude Code
./scripts/sync-claude-skills.sh

# Run validation
npm run validate:all
npm test

See docs/user/getting-started.md for complete setup guide.

Anthropic Claude Skills

Official example skills from Anthropic demonstrating Claude's skills system capabilities.

Installation: /plugin install example-skills@anthropic-agent-skills or /plugin install document-skills@anthropic-agent-skills

Key Features:

Document Skills - Create and edit DOCX, PDF, PPTX, XLSX files
Creative Skills - Algorithmic art, canvas design, Slack GIF creation
Development Skills - MCP server creation, webapp testing, artifact building
Enterprise Skills - Brand guidelines, internal communications, theme factory
Meta Skills - Skill creator and template for building custom skills

Example Skills Include:

algorithmic-art - Generative art with p5.js
canvas-design - Visual art in PNG/PDF formats
artifacts-builder - Complex HTML artifacts with React/Tailwind
mcp-server - Guide for creating MCP servers
webapp-testing - Test web apps with Playwright
brand-guidelines - Apply consistent branding
skill-creator - Create effective custom skills

Document Skills Include:

docx - Word documents with tracked changes and formatting
pdf - PDF manipulation, extraction, and creation
pptx - PowerPoint presentations with layouts and charts
xlsx - Excel spreadsheets with formulas and visualization

Quick Start:

# Register the marketplace
/plugin marketplace add anthropics/skills

# Install example skills
/plugin install example-skills@anthropic-agent-skills

# Install document skills
/plugin install document-skills@anthropic-agent-skills

# Use a skill
"Use the PDF skill to extract text from document.pdf"
"Create an algorithmic art piece using p5.js"
"Build a React artifact for a task management app"

See modules/anthropic-claude-skills/README.md for full documentation.

AR Claude Skills

Professional skills for C-level leadership, marketing teams, and product development.

Key Features:

C-Level Advisors - Strategic guidance for CEOs and CTOs
Marketing Skills - Content creation, strategy, and demand generation
Product Team - Agile practices, PM frameworks, UX research, design systems
Automated Symlinking - Safe script for integrating skills into Claude Code

10 Professional Skills:

C-Level Leadership:

ceo-advisor - Strategic business leadership and decision-making
cto-advisor - Technical leadership and architecture guidance

Marketing:

content-creator - Content strategy and creation workflows
marketing-strategy-pmm - Product marketing management frameworks
marketing-demand-acquisition - Demand generation and customer acquisition

Product Team:

agile-product-owner - Agile methodologies and PO best practices
product-manager-toolkit - PM frameworks, prioritization, roadmapping
product-strategist - Product strategy and vision development
ux-researcher-designer - UX research methodologies and design
ui-design-system - Design system creation and maintenance

Quick Start:

# Symlink skills into Claude Code
./scripts/symlink-ar-skills.sh --dry-run  # Preview
./scripts/symlink-ar-skills.sh            # Execute

# Verify installation
ls -la .claude/skills/ | grep "ar-claude-skills"

# Use in Claude Code
"Use the ceo-advisor skill to help with strategic planning"
"Apply product-strategist skill to develop product roadmap"

Script Features:

✅ Non-destructive: Never overwrites existing skills
✅ Dry-run mode for safe testing
✅ Relative symlink paths for portability
✅ Color-coded status output

See scripts/README-symlink-ar-skills.md for detailed documentation.

Claude Code by Agents

Multi-agent workspace with Electron desktop app for collaborative development and task coordination.

Key Features:

Electron Desktop App - Native app for Windows, macOS, and Linux
Multi-Agent Orchestration - Coordinate multiple specialized agents
@agent-name Mentions - Direct task routing to specific agents
Local & Remote Agents - Mix local and cloud-based agent instances
No API Keys Required - Uses your Claude CLI authentication
Beautiful Web UI - Agent hub, detail views, and orchestrator chat
Session Continuity - Maintains conversation context per agent
Agent Isolation - Separate working directories and contexts per agent

Architecture:

Agent Hub Page - Grid view of all configured agents with status
Agent Detail View - Individual chat sessions (Current Chat + History tabs)
Orchestrator Chat - Multi-agent planning and coordination
Remote Agent Support - Connect agents running on different machines
File-Based Coordination - Automatic dependency management

Quick Start:

cd modules/claude-code-by-agents

# Option 1: Download pre-built desktop app
# Windows: claude-code-webui-windows-x64.exe
# macOS Intel: claude-code-webui-macos-x64
# macOS ARM: claude-code-webui-macos-arm64
# Linux: claude-code-webui-linux-{x64,arm64}

# Start backend service (required for desktop app)
cd backend && deno task dev  # Runs on localhost:8080

# Option 2: Run from source
npm install
cd backend && deno task dev        # Terminal 1: Backend
cd frontend && npm run dev         # Terminal 2: Frontend

# Option 3: Build desktop app
npm run dist:mac    # macOS DMG
npm run dist:win    # Windows installer
npm run dist:linux  # Linux AppImage

Usage Examples:

# Single agent - direct execution, no orchestration overhead
@api-agent add user authentication

# Multi-agent - orchestrator coordinates automatically
"Create full auth system with frontend and backend"

# Remote agent on different machine
@mac-mini-agent run browser tests on Safari

# Mix local and remote agents
"@backend-agent create API, @frontend-agent build UI, @test-agent verify"

Configure Agents in Web UI:

Click "Add Agent" in Agent Hub
Enter agent details:
- Name: Backend API Agent
- Description: Handles backend API development
- Working Directory: /path/to/backend
- API Endpoint: http://localhost:8081 (local) or http://remote-host:8081
Save and use with @mentions in messages

Authentication & Billing:

Uses Claude CLI authentication (claude auth login)
No API keys needed - OAuth tokens managed securely
All requests billed to your Claude subscription (Pro/Team/Enterprise)
Same billing model as using Claude Code directly

Use Cases:

Full-stack projects: Separate agents for frontend, backend, database
Microservices: One agent per service with isolated working directories
Cross-platform: Mac agent for iOS, Linux agent for Android
Team coordination: Remote agents on team members' machines
Specialized agents: API development, testing, documentation, etc.

Benefits:

Visual workspace for managing multiple agent conversations
Specialized agents with focused expertise and codebases
Mix local development with remote cloud instances
Simple @mention routing instead of complex orchestration
Beautiful UI for tracking progress across agents

See modules/claude-code-by-agents/README.md for full documentation.

🧪 Testing Life OS Skills in Claude Code

ExoMind includes 20+ Life OS skills for personal productivity. To test them in Claude Code:

Option 1: Symlinks (Recommended)

Use symlinks to keep skills synchronized automatically:

# Create symlinks from /skills/ to /.claude/skills/
./scripts/sync-claude-skills.sh

# Verify symlinks were created
ls -la .claude/skills/
# Should show: skill-name -> ../../skills/skill-name

# Test a skill in Claude Code
"Use the daily-planning skill to plan my day"

Benefits:

✅ Single source of truth in skills/
✅ Changes in either location reflect everywhere
✅ No manual syncing needed
✅ Git tracks only the original files

Option 2: Manual Copying (Not Recommended)

Copy files manually (requires re-sync after each change):

# Copy all skills to .claude/skills
cp -r skills/* .claude/skills/

# Remember: Must re-run after ANY skill modification!

⚠️ Warning: Easy to forget, files will diverge, requires manual syncing.

Available Skills

All 20+ Life OS skills are available in .claude/skills/:

Planning: daily-planning, weekly-review, monthly-review, quarterly-review
Goals: conducting-life-assessment, goal-setting
GTD: processing-inbox, processing-email-inbox
Calendar: analyzing-schedule, scheduling-tasks
Advanced: detecting-patterns, smart-recommendations, tracking-habits
Integration: whatsapp-message-management, resolving-sync-conflicts
System: coordinating-life-os, using-life-os
Life: meal-planning, recipe-finding, grocery-shopping

See .claude/skills/README.md for complete documentation.

🎯 Quick Start

Run Your First SPARC Workflow

# List available SPARC modes
npx claude-flow@alpha sparc modes

# Run a complete TDD workflow
npx claude-flow@alpha sparc tdd "Create a REST API endpoint for user authentication"

# Run specific SPARC phases
npx claude-flow@alpha sparc run spec-pseudocode "Design a caching system"
npx claude-flow@alpha sparc run architect "Build microservices architecture"

Initialize a Multi-Agent Swarm

# Initialize swarm with mesh topology (peer-to-peer)
npx claude-flow@alpha swarm init --topology mesh

# Spawn specialized agents
npx claude-flow@alpha swarm spawn --type researcher --name "api-researcher"
npx claude-flow@alpha swarm spawn --type coder --name "backend-dev"
npx claude-flow@alpha swarm spawn --type tester --name "qa-engineer"

# Check swarm status
npx claude-flow@alpha swarm status

Use Google Workspace Features

With Composio or Google Workspace MCP configured, you can use natural language commands in Claude Code:

"Check my Gmail for messages from today"
"Send an email to [email protected] with subject 'Project Update'"
"What's on my calendar for tomorrow?"
"Schedule a meeting for next Monday at 2pm"
"Find all emails about the ExoMind project"
"Create a calendar event: Team standup, daily at 9am"

🏗️ Project Structure

ExoMind/
├── modules/                    # Git submodules
│   ├── superpowers/           # Enhanced Claude Code skills
│   ├── mcp-getgather/         # Context gathering MCP
│   ├── Skill_Seekers/         # Skill management system
│   └── life-os/               # Personal productivity OS
├── .claude/                   # Claude Code configuration
│   ├── agents/                # 54+ specialized agent definitions
│   ├── commands/              # Slash commands and workflows
│   ├── helpers/               # Automation scripts
│   └── settings.json          # Claude Code settings
├── src/                       # Source code (when generated)
├── tests/                     # Test files
├── docs/                      # Documentation
│   └── SUBMODULES.md         # Submodule management guide
├── config/                    # Configuration files
├── scripts/                   # Utility scripts
├── CLAUDE.md                  # Project instructions for Claude
└── README.md                  # This file

🤖 Available Agents

ExoMind provides 54 specialized AI agents across multiple categories:

Core Development

coder - Implementation specialist
reviewer - Code review and quality assurance
tester - Comprehensive testing and QA
planner - Strategic planning and task orchestration
researcher - Deep research and information gathering

SPARC Methodology

specification - Requirements analysis
pseudocode - Algorithm design
architecture - System design
refinement - TDD implementation
sparc-coder - Transform specs into code

Swarm Coordination

hierarchical-coordinator - Tree-based coordination
mesh-coordinator - Peer-to-peer mesh network
adaptive-coordinator - Dynamic topology switching
collective-intelligence-coordinator - Distributed cognition
swarm-memory-manager - Shared memory management

GitHub Integration

pr-manager - Pull request management and automation
code-review-swarm - Multi-agent code review
issue-tracker - Intelligent issue management
release-manager - Automated release coordination
workflow-automation - CI/CD pipeline creation

Specialized Development

backend-dev - REST and GraphQL API development
mobile-dev - React Native cross-platform apps
ml-developer - Machine learning model development
cicd-engineer - CI/CD pipeline specialist
api-docs - OpenAPI/Swagger documentation

Consensus & Distributed Systems

byzantine-coordinator - Byzantine fault tolerance
raft-manager - Raft consensus algorithm
gossip-coordinator - Gossip-based consensus
crdt-synchronizer - Conflict-free replicated data types

Performance & Optimization

perf-analyzer - Performance bottleneck analysis
performance-benchmarker - Comprehensive benchmarking
resource-allocator - Adaptive resource allocation
topology-optimizer - Dynamic topology optimization

View all 54 agents →

📖 Documentation

Core Documentation

Submodule Management - Working with git submodules
Claude Code Configuration - Project instructions and workflows
Agent Directory - All available agent definitions
Command Reference - Slash commands and workflows

External Resources

🔬 Advanced Usage

Parallel Agent Execution

ExoMind is optimized for concurrent operations. Always batch related operations in a single message:

// ✅ CORRECT: Single message with parallel agent execution
Task("Research agent", "Analyze API patterns", "researcher")
Task("Coder agent", "Implement REST endpoints", "coder")
Task("Tester agent", "Create test suite", "tester")
Task("Reviewer agent", "Review code quality", "reviewer")

TodoWrite { todos: [...8-10 todos...] }

Write "src/api/server.js"
Write "tests/api.test.js"
Write "docs/API.md"

Memory Management

Agents can store and retrieve context across sessions:

# Store context in memory
npx claude-flow@alpha hooks post-edit --memory-key "project/context" --value "API design decisions"

# Retrieve context
npx claude-flow@alpha hooks session-restore --session-id "swarm-12345"

GitHub Automation

# Analyze repository
npx claude-flow@alpha github repo-analyze natea/ExoMind

# Automated PR review
npx claude-flow@alpha github pr-review 42

# Release coordination
npx claude-flow@alpha github release-coord --version v1.0.0

Neural Training

Train agents from successful patterns:

# Train from completed tasks
npx claude-flow@alpha neural-train --pattern coordination

# Analyze cognitive patterns
npx claude-flow@alpha neural-patterns --action analyze

🧪 Testing

# Run all tests
npm test

# Run specific test suite
npm test -- --grep "API"

# Run with coverage
npm run test:coverage

# Type checking
npm run typecheck

# Linting
npm run lint

📊 Performance Metrics

ExoMind achieves impressive performance through swarm coordination:

84.8% SWE-Bench solve rate - Outperforms individual agents
32.3% token reduction - Efficient context management
2.8-4.4x speed improvement - Parallel execution
27+ neural models - Specialized learning patterns
54 specialized agents - Comprehensive coverage

🛠️ Troubleshooting

MCP Servers Not Working

# Restart Claude Desktop/Code
# Verify MCP configuration
cat ~/.config/claude/mcp_settings.json

# Check MCP server logs
claude mcp logs claude-flow

# Re-add MCP server
claude mcp remove claude-flow
claude mcp add claude-flow npx claude-flow@alpha mcp start

Google Workspace Authentication Issues

# For Composio:
composio logout
composio add googleworkspace

# For direct Google Workspace MCP:
rm /path/to/token.json
npx @modelcontextprotocol/server-google-workspace auth

Submodule Issues

# Update all submodules
git submodule update --remote --recursive

# Reset submodule to tracked commit
git submodule update --init --recursive

# Clean and reinitialize
git submodule deinit -f modules/superpowers
git submodule update --init modules/superpowers

Claude Flow Not Found

# Reinstall Claude Flow
npm install -g claude-flow@alpha

# Or use npx without installation
npx claude-flow@alpha init

🤝 Contributing

Contributions are welcome! Please follow these guidelines:

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Follow the SPARC methodology for implementation
Write tests for new functionality
Update documentation
Submit a pull request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

Claude Code - AI-powered development environment
Claude Flow - Multi-agent orchestration framework
Composio - Unified API authentication
MCP Protocol - Model Context Protocol specification
All contributors to the included submodules

📞 Support

Issues: GitHub Issues
Discussions: GitHub Discussions
Claude Flow: Claude Flow Issues
Flow-Nexus: Flow-Nexus Platform

🗺️ Roadmap

[ ] Web-based dashboard for swarm monitoring
[ ] VS Code extension for enhanced integration
[ ] Additional MCP servers for popular services (Slack, Notion, etc.)
[ ] Mobile app for on-the-go access
[ ] Advanced neural pattern libraries
[ ] Marketplace for custom agents and workflows
[ ] Enterprise features (SSO, audit logs, compliance)

Built with ❤️ using Claude Code, SPARC methodology, and swarm intelligence.

Remember: Claude Flow coordinates, Claude Code creates!