ExoMind
Highly skilled voice-based assistant with intimate knowledge of your preferences, interests, worldview who can synthesize random thoughts from curated info sources, and act on your behalf.
Ask AI about ExoMind
Powered by Claude Β· Grounded in docs
I know everything about ExoMind. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
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, debuggingmodules/anthropic-claude-skills- Official Anthropic skills (documents, creative, dev)modules/ar-claude-skills- Professional skills for C-level advisors, marketing, and product teamsmodules/claude-code-by-agents- Multi-agent workspace with web UI for coordinationmodules/mcp-getgather- Context gathering and web scrapingmodules/Skill_Seekers- Auto-generate skills from documentationmodules/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 Gmailgmail_search- Search email messagesgmail_read_message- Read specific emailscalendar_list_events- List calendar eventscalendar_create_event- Create new eventscalendar_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 frameworkvue.json- Vue.jsdjango.json- Django web frameworkfastapi.json- FastAPIgodot.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 guidevoicemode://docs/parameters- Complete parameter referencevoicemode://docs/languages- Non-English language supportvoicemode://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 refinementtest-driven-development- TDD workflowssystematic-debugging- Debug with structurerequesting-code-review- Request reviews properlyreceiving-code-review- Handle feedback effectivelyverification-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 evaluationdaily-planning- Morning/evening routines with energy managementweekly-review- Complete GTD methodologymonthly-review- Intelligent aggregation and pattern detectionquarterly-review- OKR scoring and 90-day retrospectivesgoal-setting- SMART goals + OKR frameworkprocessing-inbox- GTD inbox processing workflow
Integration Skills:
processing-email-inbox- Email-to-task conversion via Google Workspace MCPanalyzing-schedule- Calendar analysis and optimizationscheduling-tasks- Smart time blockingwhatsapp-message-management- Mobile briefings and quick captureresolving-sync-conflicts- Todoist conflict resolution
Advanced Skills:
detecting-patterns- 6 pattern types across productivity datasmart-recommendations- AI-powered insightstracking-habits- Streak management and consistency analysiscoordinating-life-os- System orchestration and health checks
Life Management:
meal-planning- Weekly meal planning with dietary preferencesrecipe-finding- Recipe search and scalinggrocery-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.jscanvas-design- Visual art in PNG/PDF formatsartifacts-builder- Complex HTML artifacts with React/Tailwindmcp-server- Guide for creating MCP serverswebapp-testing- Test web apps with Playwrightbrand-guidelines- Apply consistent brandingskill-creator- Create effective custom skills
Document Skills Include:
docx- Word documents with tracked changes and formattingpdf- PDF manipulation, extraction, and creationpptx- PowerPoint presentations with layouts and chartsxlsx- 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-makingcto-advisor- Technical leadership and architecture guidance
Marketing:
content-creator- Content strategy and creation workflowsmarketing-strategy-pmm- Product marketing management frameworksmarketing-demand-acquisition- Demand generation and customer acquisition
Product Team:
agile-product-owner- Agile methodologies and PO best practicesproduct-manager-toolkit- PM frameworks, prioritization, roadmappingproduct-strategist- Product strategy and vision developmentux-researcher-designer- UX research methodologies and designui-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) orhttp://remote-host:8081
- Name:
- 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 team@example.com 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 specialistreviewer- Code review and quality assurancetester- Comprehensive testing and QAplanner- Strategic planning and task orchestrationresearcher- Deep research and information gathering
SPARC Methodology
specification- Requirements analysispseudocode- Algorithm designarchitecture- System designrefinement- TDD implementationsparc-coder- Transform specs into code
Swarm Coordination
hierarchical-coordinator- Tree-based coordinationmesh-coordinator- Peer-to-peer mesh networkadaptive-coordinator- Dynamic topology switchingcollective-intelligence-coordinator- Distributed cognitionswarm-memory-manager- Shared memory management
GitHub Integration
pr-manager- Pull request management and automationcode-review-swarm- Multi-agent code reviewissue-tracker- Intelligent issue managementrelease-manager- Automated release coordinationworkflow-automation- CI/CD pipeline creation
Specialized Development
backend-dev- REST and GraphQL API developmentmobile-dev- React Native cross-platform appsml-developer- Machine learning model developmentcicd-engineer- CI/CD pipeline specialistapi-docs- OpenAPI/Swagger documentation
Consensus & Distributed Systems
byzantine-coordinator- Byzantine fault toleranceraft-manager- Raft consensus algorithmgossip-coordinator- Gossip-based consensuscrdt-synchronizer- Conflict-free replicated data types
Performance & Optimization
perf-analyzer- Performance bottleneck analysisperformance-benchmarker- Comprehensive benchmarkingresource-allocator- Adaptive resource allocationtopology-optimizer- Dynamic topology optimization
π 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!
