Claude Multi-Agent Project Manager - Orchestrate Claude with agent delegation and ticket tracking
Project description
Claude MPM - Multi-Agent Project Manager
A powerful orchestration framework for Claude Code (CLI) that enables multi-agent workflows, session management, and real-time monitoring through a streamlined Rich-based interface.
โ ๏ธ Important: Claude MPM requires Claude Code CLI (v2.1.3+), not Claude Desktop (app). All MCP integrations work with Claude Code's CLI interface only.
Don't have Claude Code? Install from: https://docs.anthropic.com/en/docs/claude-code
Quick Start: See Getting Started Guide to get running in 5 minutes!
Who Should Use Claude MPM?
- ๐ฅ Non-Technical Users (Founders/PMs) - Research and understand codebases using Research Mode - no coding experience required
- ๐ป Developers - Multi-agent development workflows with semantic code search and advanced features
- ๐ข Teams - Collaboration patterns, session management, and coordinated workflows
What is Claude MPM?
Claude MPM transforms Claude Code into a multi-agent orchestration platform with:
- 47+ Specialized Agents - From Git repositories (Python, Rust, QA, Security, Ops, etc.)
- Intelligent Task Routing - PM agent delegates work to specialist agents
- Session Management - Resume previous sessions with full context preservation
- Semantic Code Search - AI-powered discovery of existing code and patterns
- Real-Time Monitoring - Live dashboard showing agent activity and performance
- Git Repository Integration - Always up-to-date agents and skills from curated repositories
Quick Installation
Prerequisites
- Python 3.11+ (required - older versions will install outdated claude-mpm)
- Claude Code CLI v2.1.3+ (required!)
โ ๏ธ Python Version Note: Claude MPM requires Python 3.11 or higher. If you have Python 3.9 or 3.10, you'll get an old version (4.x) that lacks current features. Check with
python3 --versionbefore installing.
# Verify Claude Code is installed
claude --version
# If not installed, get it from:
# https://docs.anthropic.com/en/docs/claude-code
Install Claude MPM
Homebrew (macOS):
brew install claude-mpm --with-monitor
pipx/uv (recommended):
# With pipx
pipx install "claude-mpm[monitor]"
# Or with uv
uv tool install "claude-mpm[monitor]"
pip:
pip install "claude-mpm[monitor]"
Verify Installation
# Check versions
claude-mpm --version
claude --version
# Run diagnostics
claude-mpm doctor
# Verify agents deployed
ls ~/.claude/agents/ # Should show 47+ agents
What You Should See:
- โ
47+ agents deployed to
~/.claude/agents/ - โ 17 bundled skills (in Python package)
- โ Agent sources configured
- โ Progress bars showing sync and deployment
๐ก Recommended Partners: Install kuzu-memory (persistent context) and mcp-vector-search (semantic search) for enhanced capabilities.
๐ก Tool Version Management: Use ASDF version manager to avoid Python/uv version conflicts across projects.
Key Features
๐ฏ Multi-Agent Orchestration
- 47+ Specialized Agents from Git repositories covering all development needs
- Smart Task Routing via PM agent intelligently delegating to specialists
- Session Management with
--resumeflag for seamless continuity - Resume Log System with automatic 10k-token summaries at 70%/85%/95% thresholds
โ Learn more: Multi-Agent Development
๐ฆ Git Repository Integration
- Curated Content with 47+ agents automatically deployed from repositories
- Always Up-to-Date with ETag-based caching (95%+ bandwidth reduction)
- Hierarchical BASE-AGENT.md for template inheritance and DRY principles
- Custom Repositories via
claude-mpm agent-source add
๐ฏ Skills System
- 17 Bundled Skills covering Git, TDD, Docker, API docs, testing, and more
- Three-Tier Organization: Bundled/user/project with priority resolution
- Auto-Linking to relevant agents based on roles
- Custom Skills via
.claude/skills/or skill repositories
๐ Semantic Code Search
- AI-Powered Discovery with mcp-vector-search integration
- Find by Intent not just keywords ("authentication logic" finds relevant code)
- Pattern Recognition for discovering similar implementations
- Live Updates tracking code changes automatically
โ Learn more: Developer Use Cases
๐งช MPM Commander (ALPHA)
- Multi-Project Orchestration with autonomous AI coordination across codebases
- Tmux Integration for isolated project environments and session management
- Event-Driven Architecture with inbox system for cross-project communication
- LLM-Powered Decisions via OpenRouter for autonomous work queue processing
- Real-Time Monitoring with state tracking (IDLE, WORKING, BLOCKED, PAUSED, ERROR)
- โ ๏ธ Experimental - API and CLI interface subject to change
๐ Advanced Integration
- MCP Integration with full Model Context Protocol support
- Real-Time Monitoring via
--monitorflag and web dashboard - Multi-Project Support with per-session working directories
- Git Integration with diff viewing and change tracking
โก Performance & Security
- Simplified Architecture with ~3,700 lines removed for better performance
- Enhanced Security with comprehensive input validation
- Intelligent Caching with ~200ms faster startup via hash-based invalidation
- Memory Management with cleanup commands for large conversation histories
Quick Usage
# Start interactive mode
claude-mpm
# Start with monitoring dashboard
claude-mpm run --monitor
# Resume previous session
claude-mpm run --resume
# Semantic code search
claude-mpm search "authentication logic"
# or inside Claude Code:
/mpm-search "authentication logic"
# Health diagnostics
claude-mpm doctor
# Verify MCP services
claude-mpm verify
# Manage memory
claude-mpm cleanup-memory
๐ก Update Checking: Claude MPM automatically checks for updates and verifies Claude Code compatibility on startup. Configure in ~/.claude-mpm/configuration.yaml or see docs/update-checking.md.
โ Complete usage examples: User Guide
What's New in v5.0
Git Repository Integration for Agents & Skills
- ๐ฆ Massive Library: 47+ agents and hundreds of skills deployed automatically
- ๐ข Official Content: Anthropic's official skills repository included by default
- ๐ง Fully Extensible: Add your own repositories with immediate testing
- ๐ณ Smart Organization: Hierarchical BASE-AGENT.md inheritance
- ๐ Clear Visibility: Two-phase progress bars (sync + deployment)
- โ Fail-Fast Testing: Test repositories before they cause startup issues
Quick Start with Custom Repositories:
# Add custom agent repository
claude-mpm agent-source add https://github.com/yourorg/your-agents
# Add custom skill repository
claude-mpm skill-source add https://github.com/yourorg/your-skills
# Test repository without saving
claude-mpm agent-source add https://github.com/yourorg/your-agents --test
Documentation
๐ Complete Documentation Hub - Start here for all documentation!
Quick Links by User Type
๐ฅ For Users
- ๐ 5-Minute Quick Start - Get running immediately
- ๐ฆ Installation Guide - All installation methods
- ๐ User Guide - Complete user documentation
- โ FAQ - Common questions answered
๐ป For Developers
- ๐๏ธ Architecture Overview - Service-oriented system design
- ๐ป Developer Guide - Complete development documentation
- ๐งช Contributing - How to contribute
- ๐ API Reference - Complete API documentation
๐ค For Agent Creators
- ๐ค Agent System - Complete agent development guide
- ๐ Creation Guide - Step-by-step tutorials
- ๐ Schema Reference - Agent format specifications
๐ For Operations
- ๐ Deployment - Release management & versioning
- ๐ Monitoring - Real-time dashboard & metrics
- ๐ Troubleshooting - Enhanced
doctorcommand with auto-fix
Contributing
Contributions are welcome! Please see:
- Contributing Guide - How to contribute
- Code Formatting - Code quality standards
- Project Structure - Codebase organization
Development Workflow:
# Complete development setup
make dev-complete
# Or step by step:
make setup-dev # Install in development mode
make setup-pre-commit # Set up automated code formatting
๐ License
Licensed under the Elastic License 2.0 - free for internal use and commercial products.
Main restriction: Cannot offer as a hosted SaaS service without a commercial license.
๐ Licensing FAQ | ๐ผ Commercial licensing: bob@matsuoka.com
Credits
- Based on claude-multiagent-pm
- Enhanced for Claude Code (CLI) integration
- Built with โค๏ธ by the Claude MPM community
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file claude_mpm-5.6.34.tar.gz.
File metadata
- Download URL: claude_mpm-5.6.34.tar.gz
- Upload date:
- Size: 4.4 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.18 {"installer":{"name":"uv","version":"0.9.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e117360e670a5c3bc32f4b36e15f34f867ebea6f1d7daa17af86a4c23309040f
|
|
| MD5 |
84d6165ffb7b80e9861a81ffc5c16baa
|
|
| BLAKE2b-256 |
f15fb6f91321f307df2809b20b80e2605e359478d032b500ea3a80b715b7210d
|
File details
Details for the file claude_mpm-5.6.34-py3-none-any.whl.
File metadata
- Download URL: claude_mpm-5.6.34-py3-none-any.whl
- Upload date:
- Size: 4.4 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.18 {"installer":{"name":"uv","version":"0.9.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6be56b36520f7dff901af88e9267b2254f0ee2538ac2e02e1eec94c0570cffb5
|
|
| MD5 |
1c5b370a1d96c90abce69c5081d29515
|
|
| BLAKE2b-256 |
d780c91bd0d710f0ff716dcb569d6b793a3814acddc2fcbd97f19b88edfbccc9
|
