Claude MPM - Multi-Agent Project Manager

A powerful orchestration framework for Claude Code that enables multi-agent workflows, session management, and real-time monitoring through an intuitive interface.

Quick Start: See QUICKSTART.md to get running in 5 minutes!

Features

• 🤖 Multi-Agent System: 15 specialized agents for comprehensive project management
• 🧠 Agent Memory System: Persistent learning with project-specific knowledge retention
• 🔄 Session Management: Resume previous sessions with --resume
• 📊 Real-Time Monitoring: Live dashboard with --monitor flag
• 🔌 MCP Gateway: Model Context Protocol integration for extensible tool capabilities
• 📁 Multi-Project Support: Per-session working directories
• 🔍 Git Integration: View diffs and track changes across projects
• 🎯 Smart Task Orchestration: PM agent intelligently routes work to specialists
• ⚡ 50-80% Performance Improvement: Through intelligent caching and lazy loading
• 🔒 Enhanced Security: Comprehensive input validation and sanitization framework

Quick Installation

pip install claude-mpm

That's it! See QUICKSTART.md for immediate usage or docs/user/installation.md for advanced options.

Quick Usage

# Start interactive mode (recommended)
claude-mpm

# Start with monitoring dashboard
claude-mpm run --monitor

# Use MCP Gateway for external tool integration
claude-mpm mcp

# Manage memory for large conversation histories
claude-mpm cleanup-memory

See QUICKSTART.md for complete usage examples.

Architecture (v3.8.2+)

Following the TSK-0053 refactoring, Claude MPM features:

• Service-Oriented Architecture: Five specialized service domains
• Interface-Based Contracts: All services implement explicit interfaces
• Dependency Injection: Service container with automatic resolution
• 50-80% Performance Improvement: Through lazy loading and intelligent caching
• Enhanced Security: Comprehensive input validation and sanitization framework

See docs/ARCHITECTURE.md for detailed architecture information.

Key Capabilities

Multi-Agent Orchestration

Claude MPM includes 15 specialized agents:

Core Development

• Engineer - Software development and implementation
• Research - Code analysis and research
• Documentation - Documentation creation and maintenance
• QA - Testing and quality assurance
• Security - Security analysis and implementation

Operations & Infrastructure

• Ops - Operations and deployment
• Version Control - Git and version management
• Data Engineer - Data pipeline and ETL development

Web Development

• Web UI - Frontend and UI development
• Web QA - Web testing and E2E validation

Project Management

• Ticketing - Issue tracking and management
• Project Organizer - File organization and structure
• Memory Manager - Project memory and context management

Code Quality

• Refactoring Engineer - Code refactoring and optimization
• Code Analyzer - Static code analysis with AST and tree-sitter

Agent Memory System

Agents learn project-specific patterns and remember insights across sessions. Initialize with claude-mpm memory init.

MCP Gateway (Model Context Protocol)

Claude MPM includes a powerful MCP Gateway that enables:

• Integration with external tools and services
• Custom tool development
• Protocol-based communication
• Extensible architecture

See MCP Gateway Documentation for details.

Memory Management

Large conversation histories can consume 2GB+ of memory. Use the cleanup-memory command to manage Claude conversation history:

# Clean up old conversation history
claude-mpm cleanup-memory

# Keep only recent conversations
claude-mpm cleanup-memory --days 7

Real-Time Monitoring

The --monitor flag opens a web dashboard showing live agent activity, file operations, and session management.

See docs/MEMORY.md and docs/developer/11-dashboard/README.md for details.

Documentation

User Documentation

• Quick Start Guide - Get running in 5 minutes
• Installation Guide - Complete installation options
• User Guide - Detailed usage documentation
• Memory System - Agent memory documentation
• Troubleshooting - Common issues and solutions

Developer Documentation

• Architecture Overview - Service-oriented architecture and design
• API Reference - Complete API documentation with Sphinx
• Service Layer Guide - Service interfaces and implementations
• MCP Gateway Guide - Model Context Protocol integration
• Performance Guide - Optimization and caching strategies
• Security Guide - Security framework and best practices
• Testing Guide - Testing patterns and strategies
• Migration Guide - Upgrading from previous versions
• Developer Guide - Comprehensive development documentation

API Documentation

Comprehensive API documentation is available at docs/api/ - build with make html in that directory.

Recent Updates (v3.8.2)

Major Architecture Refactoring (TSK-0053): Complete service-oriented redesign with 50-80% performance improvements, enhanced security, and interface-based design.

Process Management Improvements: Enhanced hook system reliability with automatic process cleanup, timeout protection, and orphan process monitoring to prevent resource leaks.

See CHANGELOG.md for full history and docs/MIGRATION.md for upgrade instructions.

Development

Quick Development Setup

# Complete development setup with code formatting and quality tools
make dev-complete

# Or step by step:
make setup-dev          # Install in development mode
make setup-pre-commit    # Set up automated code formatting

Code Quality & Formatting

The project uses automated code formatting and quality checks:

• Black for code formatting
• isort for import sorting
• flake8 for linting
• mypy for type checking
• Pre-commit hooks for automatic enforcement

See docs/developer/CODE_FORMATTING.md for details.

Contributing

Contributions are welcome! Please see our project structure guide and follow the established patterns.

Development Workflow:

1. Run make dev-complete to set up your environment
2. Code formatting happens automatically on commit
3. All code must pass quality checks before merging

Project Structure

See docs/STRUCTURE.md for codebase organization.

License

MIT License - see LICENSE file.

Credits

• Based on claude-multiagent-pm
• Enhanced for Claude Code integration
• Built with ❤️ by the Claude MPM community