claude-mpm 4.14.2 → 5.4.31
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +94 -21
- package/README.md +669 -52
- package/npm-bin/claude-mpm.js +7 -7
- package/package.json +3 -1
package/LICENSE
CHANGED
|
@@ -1,21 +1,94 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
Copyright (c) 2025
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
The
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
1
|
+
Elastic License 2.0
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2024-2025 Bob Matsuoka
|
|
4
|
+
Contact: bob@matsuoka.com
|
|
5
|
+
|
|
6
|
+
## Acceptance
|
|
7
|
+
|
|
8
|
+
By using the software, you agree to all of the terms and conditions below.
|
|
9
|
+
|
|
10
|
+
## Copyright License
|
|
11
|
+
|
|
12
|
+
The licensor grants you a non-exclusive, royalty-free, worldwide,
|
|
13
|
+
non-sublicensable, non-transferable license to use, copy, distribute, make
|
|
14
|
+
available, and prepare derivative works of the software, in each case subject to
|
|
15
|
+
the limitations and conditions below.
|
|
16
|
+
|
|
17
|
+
## Limitations
|
|
18
|
+
|
|
19
|
+
You may not provide the software to third parties as a hosted or managed
|
|
20
|
+
service, where the service provides users with access to any substantial set of
|
|
21
|
+
the features or functionality of the software.
|
|
22
|
+
|
|
23
|
+
You may not move, change, disable, or circumvent the license key functionality
|
|
24
|
+
in the software, and you may not remove or obscure any functionality in the
|
|
25
|
+
software that is protected by the license key.
|
|
26
|
+
|
|
27
|
+
You may not alter, remove, or obscure any licensing, copyright, or other notices
|
|
28
|
+
of the licensor in the software. Any use of the licensor's trademarks is subject
|
|
29
|
+
to applicable law.
|
|
30
|
+
|
|
31
|
+
## Patents
|
|
32
|
+
|
|
33
|
+
The licensor grants you a license, under any patent claims the licensor can
|
|
34
|
+
license, or becomes able to license, to make, have made, use, sell, offer for
|
|
35
|
+
sale, import and have imported the software, in each case subject to the
|
|
36
|
+
limitations and conditions in this license. This license does not cover any
|
|
37
|
+
patent claims that you cause to be infringed by modifications or additions to
|
|
38
|
+
the software. If you or your company make any written claim that the software
|
|
39
|
+
infringes or contributes to infringement of any patent, your patent license for
|
|
40
|
+
the software granted under these terms ends immediately. If your company makes
|
|
41
|
+
such a claim, your patent license ends immediately for work on behalf of your
|
|
42
|
+
company.
|
|
43
|
+
|
|
44
|
+
## Notices
|
|
45
|
+
|
|
46
|
+
You must ensure that anyone who gets a copy of any part of the software from you
|
|
47
|
+
also gets a copy of these terms.
|
|
48
|
+
|
|
49
|
+
If you modify the software, you must include in any modified copies of the
|
|
50
|
+
software prominent notices stating that you have modified the software.
|
|
51
|
+
|
|
52
|
+
## No Other Rights
|
|
53
|
+
|
|
54
|
+
These terms do not imply any licenses other than those expressly granted in
|
|
55
|
+
these terms.
|
|
56
|
+
|
|
57
|
+
## Termination
|
|
58
|
+
|
|
59
|
+
If you use the software in violation of these terms, such use is not licensed,
|
|
60
|
+
and your licenses will automatically terminate. If the licensor provides you
|
|
61
|
+
with a notice of your violation, and you cease all violation of this license no
|
|
62
|
+
later than 30 days after you receive that notice, your licenses will be
|
|
63
|
+
reinstated retroactively. However, if you violate these terms after such
|
|
64
|
+
reinstatement, any additional violation of these terms will cause your licenses
|
|
65
|
+
to terminate automatically and permanently.
|
|
66
|
+
|
|
67
|
+
## No Liability
|
|
68
|
+
|
|
69
|
+
*As far as the law allows, the software comes as is, without any warranty or
|
|
70
|
+
condition, and the licensor will not be liable to you for any damages arising
|
|
71
|
+
out of these terms or the use or nature of the software, under any kind of legal
|
|
72
|
+
claim.*
|
|
73
|
+
|
|
74
|
+
## Definitions
|
|
75
|
+
|
|
76
|
+
The **licensor** is the entity offering these terms, and the **software** is the
|
|
77
|
+
software the licensor makes available under these terms, including any portion
|
|
78
|
+
of it.
|
|
79
|
+
|
|
80
|
+
**you** refers to the individual or entity agreeing to these terms.
|
|
81
|
+
|
|
82
|
+
**your company** is any legal entity, sole proprietorship, or other kind of
|
|
83
|
+
organization that you work for, plus all organizations that have control over,
|
|
84
|
+
are under the control of, or are under common control with that
|
|
85
|
+
organization. **control** means ownership of substantially all the assets of an
|
|
86
|
+
entity, or the power to direct its management and policies by vote, contract, or
|
|
87
|
+
otherwise. Control can be direct or indirect.
|
|
88
|
+
|
|
89
|
+
**your licenses** are all the licenses granted to you for the software under
|
|
90
|
+
these terms.
|
|
91
|
+
|
|
92
|
+
**use** means anything you do with the software requiring one of your licenses.
|
|
93
|
+
|
|
94
|
+
**trademark** means trademarks, service marks, and similar rights.
|
package/README.md
CHANGED
|
@@ -2,64 +2,344 @@
|
|
|
2
2
|
|
|
3
3
|
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.
|
|
4
4
|
|
|
5
|
-
> **⚠️ Important**: Claude MPM
|
|
5
|
+
> **⚠️ Important**: Claude MPM **requires Claude Code CLI** (v1.0.92+), not Claude Desktop (app). All MCP integrations work with Claude Code's CLI interface only.
|
|
6
|
+
>
|
|
7
|
+
> **Don't have Claude Code?** Install from: https://docs.anthropic.com/en/docs/claude-code
|
|
8
|
+
>
|
|
9
|
+
> **Version Requirements:**
|
|
10
|
+
> - Minimum: v1.0.92 (hooks support)
|
|
11
|
+
> - Recommended: v2.0.30+ (latest features)
|
|
6
12
|
|
|
7
|
-
> **Quick Start**: See [
|
|
13
|
+
> **Quick Start**: See [docs/user/getting-started.md](docs/user/getting-started.md) to get running in 5 minutes!
|
|
14
|
+
|
|
15
|
+
## 🚀 What's New in v5.0
|
|
16
|
+
|
|
17
|
+
### Git Repository Integration for Agents & Skills
|
|
18
|
+
|
|
19
|
+
Claude MPM now supports **Git repositories** for distributing and managing agents and skills - the most requested feature from our community!
|
|
20
|
+
|
|
21
|
+
**🎯 Key Highlights:**
|
|
22
|
+
- **📦 Massive Library**: 47+ agents and hundreds of skills deployed automatically from curated repositories
|
|
23
|
+
- **🏢 Official Content**: Anthropic's official skills repository included by default
|
|
24
|
+
- **🔧 Fully Extensible**: Add your own agent/skill repositories with immediate testing
|
|
25
|
+
- **🌳 Smart Organization**: Hierarchical BASE-AGENT.md inheritance for shared templates
|
|
26
|
+
- **📊 Clear Visibility**: Two-phase progress bars show sync and deployment status
|
|
27
|
+
- **✅ Fail-Fast Testing**: Test repositories before they cause startup issues
|
|
28
|
+
|
|
29
|
+
#### Quick Start: Add Your Own Repository
|
|
30
|
+
|
|
31
|
+
```bash
|
|
32
|
+
# Add custom agent repository (with immediate testing)
|
|
33
|
+
claude-mpm agent-source add https://github.com/yourorg/your-agents
|
|
34
|
+
|
|
35
|
+
# Add custom skill repository
|
|
36
|
+
claude-mpm skill-source add https://github.com/yourorg/your-skills
|
|
37
|
+
|
|
38
|
+
# Test repository without saving
|
|
39
|
+
claude-mpm agent-source add https://github.com/yourorg/your-agents --test
|
|
40
|
+
|
|
41
|
+
# List all configured sources
|
|
42
|
+
claude-mpm agent-source list
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
#### Default Repositories
|
|
46
|
+
|
|
47
|
+
**Agents** (47+ agents):
|
|
48
|
+
- 🏢 System: `bobmatnyc/claude-mpm-agents` - Core agent templates
|
|
49
|
+
|
|
50
|
+
**Skills** (hundreds of skills):
|
|
51
|
+
- 🏢 System: `bobmatnyc/claude-mpm-skills` - Community skills
|
|
52
|
+
- 🎯 Official: `anthropics/skills` - Anthropic's official skills (14+ skills)
|
|
53
|
+
|
|
54
|
+
**What This Means:**
|
|
55
|
+
- ✅ **Automatic Setup**: Everything deploys on first run
|
|
56
|
+
- ✅ **Always Updated**: Git repositories sync on startup
|
|
57
|
+
- ✅ **Nested Support**: Repositories with subdirectories are automatically flattened
|
|
58
|
+
- ✅ **Template Inheritance**: BASE-AGENT.md files cascade from parent directories
|
|
59
|
+
- ✅ **Priority System**: Control which sources win when multiple repos provide the same agent/skill
|
|
60
|
+
|
|
61
|
+
#### Hierarchical Organization Example
|
|
62
|
+
|
|
63
|
+
Support for BASE-AGENT.md enables powerful template inheritance:
|
|
64
|
+
|
|
65
|
+
```
|
|
66
|
+
your-agents/
|
|
67
|
+
BASE-AGENT.md # Root shared content (all agents inherit)
|
|
68
|
+
engineering/
|
|
69
|
+
BASE-AGENT.md # Engineering-specific (engineering/* agents inherit)
|
|
70
|
+
python/
|
|
71
|
+
fastapi-engineer.md # Inherits both BASE files
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
See [docs/features/hierarchical-base-agents.md](docs/features/hierarchical-base-agents.md) for complete guide.
|
|
8
75
|
|
|
9
76
|
## Features
|
|
10
77
|
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
-
|
|
14
|
-
-
|
|
15
|
-
-
|
|
16
|
-
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
-
|
|
21
|
-
-
|
|
78
|
+
### 🎯 Multi-Agent Orchestration
|
|
79
|
+
|
|
80
|
+
- **47+ Specialized Agents**: Comprehensive coverage from Git repositories (Python, Rust, QA, Security, Ops, etc.)
|
|
81
|
+
- **Smart Task Routing**: PM agent intelligently delegates work to specialist agents
|
|
82
|
+
- **Session Management**: Resume previous sessions with `--resume`
|
|
83
|
+
- **Resume Log System**: Proactive context management with automatic 10k-token session logs at 70%/85%/95% thresholds
|
|
84
|
+
|
|
85
|
+
### 📦 Git Repository Integration (NEW in v5.0)
|
|
86
|
+
|
|
87
|
+
- **🏢 Curated Content**: Default repositories with 47+ agents and hundreds of skills
|
|
88
|
+
- **🎯 Official Skills**: Anthropic's official skills included by default
|
|
89
|
+
- **🔧 Custom Repositories**: Add your own via CLI or configuration
|
|
90
|
+
- **🌳 Nested Support**: Automatic flattening of nested directory structures
|
|
91
|
+
- **📝 Template Inheritance**: BASE-AGENT.md for hierarchical organization
|
|
92
|
+
- **✅ Immediate Testing**: Fail-fast validation when adding repositories
|
|
93
|
+
- **📊 Progress Visibility**: Two-phase progress bars (sync + deployment)
|
|
94
|
+
- **⚡ Smart Caching**: ETag-based caching reduces bandwidth by 95%+
|
|
95
|
+
|
|
96
|
+
### 🎯 Skills System
|
|
97
|
+
|
|
98
|
+
- **Hundreds of Skills**: Comprehensive skill library from curated repositories
|
|
99
|
+
- **Official Skills**: 14+ skills from Anthropic's official repository
|
|
100
|
+
- **Three-Tier Organization**: Bundled/user/project skills with priority resolution
|
|
101
|
+
- **Auto-Linking**: Skills automatically linked to relevant agents
|
|
102
|
+
- **Interactive Configuration**: Skills wizard via `claude-mpm configure`
|
|
103
|
+
- **Version Tracking**: Semantic versioning for all skills
|
|
104
|
+
|
|
105
|
+
### 🔌 Advanced Integration
|
|
106
|
+
|
|
107
|
+
- **MCP Integration**: Full support for Model Context Protocol services
|
|
108
|
+
- **Real-Time Monitoring**: Live dashboard with `--monitor` flag
|
|
109
|
+
- **Multi-Project Support**: Per-session working directories
|
|
110
|
+
- **Git Integration**: View diffs and track changes across projects
|
|
111
|
+
|
|
112
|
+
### ⚡ Performance & Security
|
|
113
|
+
|
|
114
|
+
- **Simplified Architecture**: ~3,700 lines removed for better performance
|
|
115
|
+
- **Enhanced Security**: Comprehensive input validation and sanitization
|
|
116
|
+
- **Intelligent Caching**: File-based instruction caching for optimal performance
|
|
117
|
+
- ✅ Eliminates ARG_MAX limits on Linux (exceeds by 19.1%) and Windows (exceeds by 476%)
|
|
118
|
+
- ✅ ~200ms faster agent startup with hash-based cache invalidation
|
|
119
|
+
- ✅ Automatic and transparent (no configuration required)
|
|
22
120
|
|
|
23
121
|
## Quick Installation
|
|
24
122
|
|
|
123
|
+
### Prerequisites
|
|
124
|
+
|
|
125
|
+
**Before installing Claude MPM**, ensure you have:
|
|
126
|
+
|
|
127
|
+
1. **Python 3.11+** (required for kuzu-memory dependency)
|
|
128
|
+
2. **Claude Code CLI v1.0.92+** (required!)
|
|
129
|
+
|
|
130
|
+
```bash
|
|
131
|
+
# Verify Claude Code is installed
|
|
132
|
+
claude --version
|
|
133
|
+
|
|
134
|
+
# If not installed, get it from:
|
|
135
|
+
# https://docs.anthropic.com/en/docs/claude-code
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
### Install Claude MPM
|
|
139
|
+
|
|
25
140
|
```bash
|
|
26
141
|
# Basic installation
|
|
27
142
|
pip install claude-mpm
|
|
28
143
|
|
|
29
|
-
#
|
|
30
|
-
|
|
144
|
+
# Or with uv (faster)
|
|
145
|
+
uv tool install claude-mpm
|
|
146
|
+
|
|
147
|
+
# Install with monitoring dashboard (recommended)
|
|
148
|
+
pip install "claude-mpm[monitor]"
|
|
149
|
+
uv tool install "claude-mpm[monitor]"
|
|
31
150
|
```
|
|
32
151
|
|
|
33
|
-
Or with pipx (recommended for isolated installation):
|
|
152
|
+
Or with pipx/uvx (recommended for isolated installation):
|
|
34
153
|
```bash
|
|
35
154
|
# Basic installation
|
|
36
155
|
pipx install claude-mpm
|
|
37
156
|
|
|
38
|
-
#
|
|
39
|
-
|
|
157
|
+
# Or with uv tool (permanent installation)
|
|
158
|
+
uv tool install claude-mpm
|
|
40
159
|
|
|
41
|
-
#
|
|
42
|
-
|
|
160
|
+
# Or with uvx (one-off execution)
|
|
161
|
+
uvx claude-mpm
|
|
43
162
|
|
|
44
|
-
#
|
|
45
|
-
claude-mpm
|
|
163
|
+
# Install with monitoring dashboard (recommended)
|
|
164
|
+
pipx install "claude-mpm[monitor]"
|
|
165
|
+
uv tool install "claude-mpm[monitor]"
|
|
46
166
|
```
|
|
47
167
|
|
|
168
|
+
### Verify Installation
|
|
169
|
+
|
|
170
|
+
```bash
|
|
171
|
+
# Check versions
|
|
172
|
+
claude-mpm --version
|
|
173
|
+
claude --version
|
|
174
|
+
|
|
175
|
+
# Run diagnostics (checks Claude Code compatibility)
|
|
176
|
+
claude-mpm doctor
|
|
177
|
+
|
|
178
|
+
# Verify Git repositories are synced
|
|
179
|
+
ls ~/.claude/agents/ # Should show 47+ agents
|
|
180
|
+
ls ~/.claude/skills/ # Should show hundreds of skills
|
|
181
|
+
|
|
182
|
+
# Check agent sources
|
|
183
|
+
claude-mpm agent-source list
|
|
184
|
+
|
|
185
|
+
# Check skill sources
|
|
186
|
+
claude-mpm skill-source list
|
|
187
|
+
```
|
|
188
|
+
|
|
189
|
+
**What You Should See:**
|
|
190
|
+
- ✅ 47+ agents deployed to `~/.claude/agents/`
|
|
191
|
+
- ✅ Hundreds of skills deployed to `~/.claude/skills/`
|
|
192
|
+
- ✅ Two agent sources configured (system + official)
|
|
193
|
+
- ✅ Two skill sources configured (system + official)
|
|
194
|
+
- ✅ Progress bars showing sync and deployment phases
|
|
195
|
+
|
|
48
196
|
**💡 Optional Dependencies**:
|
|
49
|
-
- `[mcp]` - Include MCP services (mcp-vector-search, mcp-browser, mcp-ticketer)
|
|
50
197
|
- `[monitor]` - Full monitoring dashboard with Socket.IO and async web server components
|
|
51
|
-
-
|
|
52
|
-
- **Note**: kuzu-memory is now a required dependency, always included with Claude MPM
|
|
53
|
-
- **Auto-Install**: mcp-vector-search offers interactive installation on first use (pip/pipx choice)
|
|
54
|
-
- Without pre-installed MCP dependencies, services install on-demand with user confirmation
|
|
198
|
+
- `[mcp]` - Additional MCP services (mcp-browser, mcp-ticketer) - most users won't need this
|
|
55
199
|
|
|
56
200
|
**🎉 Pipx Support Now Fully Functional!** Recent improvements ensure complete compatibility:
|
|
57
201
|
- ✅ Socket.IO daemon script path resolution (fixed)
|
|
58
|
-
- ✅ Commands directory access (fixed)
|
|
202
|
+
- ✅ Commands directory access (fixed)
|
|
59
203
|
- ✅ Resource files properly packaged for pipx environments
|
|
60
204
|
- ✅ Python 3.13+ fully supported
|
|
61
205
|
|
|
62
|
-
|
|
206
|
+
## 🤝 Recommended Partner Products
|
|
207
|
+
|
|
208
|
+
Claude MPM works excellently with these complementary MCP tools. While optional, we **strongly recommend** installing them for enhanced capabilities:
|
|
209
|
+
|
|
210
|
+
### kuzu-memory - Advanced Memory Management
|
|
211
|
+
|
|
212
|
+
**What it does**: Provides persistent, project-specific knowledge graphs that enable agents to learn and retain context across sessions. Your agents will remember project patterns, architectural decisions, and important context automatically.
|
|
213
|
+
|
|
214
|
+
**Installation:**
|
|
215
|
+
```bash
|
|
216
|
+
pipx install kuzu-memory
|
|
217
|
+
# Or with uv
|
|
218
|
+
uv tool install kuzu-memory
|
|
219
|
+
```
|
|
220
|
+
|
|
221
|
+
**Benefits with Claude MPM:**
|
|
222
|
+
- 🧠 **Persistent Context**: Agents remember project-specific patterns and decisions across sessions
|
|
223
|
+
- 🎯 **Intelligent Prompts**: Automatically enriches agent prompts with relevant historical context
|
|
224
|
+
- 📊 **Knowledge Graphs**: Structured storage of project knowledge, not just flat memory
|
|
225
|
+
- 🔄 **Seamless Integration**: Works transparently in the background with zero configuration
|
|
226
|
+
- 💡 **Smart Learning**: Agents improve over time as they learn your project's patterns
|
|
227
|
+
|
|
228
|
+
**Perfect for**: Long-running projects, teams needing consistent context, complex codebases with deep architectural patterns.
|
|
229
|
+
|
|
230
|
+
**Learn more**: [kuzu-memory on PyPI](https://pypi.org/project/kuzu-memory/) | [GitHub Repository](https://github.com/bobmatnyc/kuzu-memory)
|
|
231
|
+
|
|
232
|
+
---
|
|
233
|
+
|
|
234
|
+
### mcp-vector-search - Semantic Code Search
|
|
235
|
+
|
|
236
|
+
**What it does**: Enables semantic code search across your entire codebase using AI embeddings. Find code by what it *does*, not just what it's *named*. Search for "authentication logic" and find relevant functions even if they're named differently.
|
|
237
|
+
|
|
238
|
+
**Installation:**
|
|
239
|
+
```bash
|
|
240
|
+
pipx install mcp-vector-search
|
|
241
|
+
# Or with uv
|
|
242
|
+
uv tool install mcp-vector-search
|
|
243
|
+
```
|
|
244
|
+
|
|
245
|
+
**Benefits with Claude MPM:**
|
|
246
|
+
- 🔍 **Semantic Discovery**: Find code by intent and functionality, not just keywords
|
|
247
|
+
- 🎯 **Context-Aware**: Understand code relationships and similarities automatically
|
|
248
|
+
- ⚡ **Fast Indexing**: Efficient vector embeddings for large codebases
|
|
249
|
+
- 🔄 **Live Updates**: Automatically tracks code changes and updates index
|
|
250
|
+
- 📊 **Pattern Recognition**: Discover similar code patterns and potential refactoring opportunities
|
|
251
|
+
|
|
252
|
+
**Use with**: `/mpm-search "authentication logic"` command in Claude Code sessions or `claude-mpm search` CLI command.
|
|
253
|
+
|
|
254
|
+
**Perfect for**: Large codebases, discovering existing functionality, finding similar implementations, architectural exploration.
|
|
255
|
+
|
|
256
|
+
**Learn more**: [mcp-vector-search on PyPI](https://pypi.org/project/mcp-vector-search/) | [GitHub Repository](https://github.com/bobmatnyc/mcp-vector-search)
|
|
257
|
+
|
|
258
|
+
---
|
|
259
|
+
|
|
260
|
+
### Quick Setup - Both Tools
|
|
261
|
+
|
|
262
|
+
Install both recommended tools in one go:
|
|
263
|
+
|
|
264
|
+
```bash
|
|
265
|
+
pipx install kuzu-memory
|
|
266
|
+
pipx install mcp-vector-search
|
|
267
|
+
|
|
268
|
+
# Or with uv
|
|
269
|
+
uv tool install kuzu-memory
|
|
270
|
+
uv tool install mcp-vector-search
|
|
271
|
+
```
|
|
272
|
+
|
|
273
|
+
Then verify they're working:
|
|
274
|
+
|
|
275
|
+
```bash
|
|
276
|
+
claude-mpm verify
|
|
277
|
+
```
|
|
278
|
+
|
|
279
|
+
**That's it!** These tools integrate automatically with Claude MPM once installed. No additional configuration needed.
|
|
280
|
+
|
|
281
|
+
**That's it!** See [docs/user/getting-started.md](docs/user/getting-started.md) for immediate usage.
|
|
282
|
+
|
|
283
|
+
## Cache Management
|
|
284
|
+
|
|
285
|
+
Claude MPM maintains a local cache of agent templates at `~/.claude-mpm/cache/agents/`.
|
|
286
|
+
|
|
287
|
+
### Cache Structure
|
|
288
|
+
|
|
289
|
+
```
|
|
290
|
+
~/.claude-mpm/cache/agents/
|
|
291
|
+
└── bobmatnyc/
|
|
292
|
+
└── claude-mpm-agents/
|
|
293
|
+
├── .git/ # Git repository
|
|
294
|
+
├── agents/ # 45+ agent templates
|
|
295
|
+
└── docs/
|
|
296
|
+
```
|
|
297
|
+
|
|
298
|
+
> **Note**: Prior to v5.4.23, agents were cached to `~/.claude-mpm/cache/remote-agents/`. This has been standardized to `~/.claude-mpm/cache/agents/`. Existing caches are automatically migrated.
|
|
299
|
+
|
|
300
|
+
### Git Workflow (Optional)
|
|
301
|
+
|
|
302
|
+
If your cache is a git repository, you can manage agents with git operations:
|
|
303
|
+
|
|
304
|
+
```bash
|
|
305
|
+
# Check cache status
|
|
306
|
+
claude-mpm agents cache-status
|
|
307
|
+
|
|
308
|
+
# Pull latest agents
|
|
309
|
+
claude-mpm agents cache-pull
|
|
310
|
+
|
|
311
|
+
# Commit local changes
|
|
312
|
+
claude-mpm agents cache-commit --message "feat: update agents"
|
|
313
|
+
|
|
314
|
+
# Push changes
|
|
315
|
+
claude-mpm agents cache-push
|
|
316
|
+
|
|
317
|
+
# Full sync workflow
|
|
318
|
+
claude-mpm agents cache-sync
|
|
319
|
+
```
|
|
320
|
+
|
|
321
|
+
**Or use Makefile targets:**
|
|
322
|
+
|
|
323
|
+
```bash
|
|
324
|
+
make agents-cache-status # Show git status
|
|
325
|
+
make agents-cache-pull # Pull latest
|
|
326
|
+
make agents-cache-sync # Full sync (pull + commit + push)
|
|
327
|
+
make deploy-agents # Deploy with auto-pull
|
|
328
|
+
```
|
|
329
|
+
|
|
330
|
+
### HTTP Sync Fallback
|
|
331
|
+
|
|
332
|
+
If cache is not a git repository, Claude MPM automatically falls back to HTTP sync with GitHub API.
|
|
333
|
+
|
|
334
|
+
### Migration from Legacy Cache
|
|
335
|
+
|
|
336
|
+
If you have an old `cache/agents/` directory, run the migration script:
|
|
337
|
+
|
|
338
|
+
```bash
|
|
339
|
+
python scripts/migrate_cache_to_remote_agents.py
|
|
340
|
+
```
|
|
341
|
+
|
|
342
|
+
**See also:** [docs/CACHE_MANAGEMENT.md](docs/CACHE_MANAGEMENT.md) for comprehensive cache management guide.
|
|
63
343
|
|
|
64
344
|
## Quick Usage
|
|
65
345
|
|
|
@@ -104,18 +384,200 @@ claude-mpm verify --json
|
|
|
104
384
|
|
|
105
385
|
# Manage memory for large conversation histories
|
|
106
386
|
claude-mpm cleanup-memory
|
|
387
|
+
|
|
388
|
+
# Check for updates (including Claude Code compatibility)
|
|
389
|
+
claude-mpm doctor --checks updates
|
|
390
|
+
```
|
|
391
|
+
|
|
392
|
+
**💡 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](docs/update-checking.md).
|
|
393
|
+
|
|
394
|
+
See [docs/user/getting-started.md](docs/user/getting-started.md) for complete usage examples.
|
|
395
|
+
|
|
396
|
+
## Managing Agent & Skill Repositories
|
|
397
|
+
|
|
398
|
+
Claude MPM uses **Git repositories** to distribute and manage agents and skills. This provides automatic updates, version control, and easy sharing of agent/skill libraries.
|
|
399
|
+
|
|
400
|
+
### Quick Start
|
|
401
|
+
|
|
402
|
+
```bash
|
|
403
|
+
# Add custom agent repository
|
|
404
|
+
claude-mpm agent-source add https://github.com/yourorg/your-agents
|
|
405
|
+
|
|
406
|
+
# Add custom skill repository
|
|
407
|
+
claude-mpm skill-source add https://github.com/yourorg/your-skills
|
|
408
|
+
|
|
409
|
+
# Test repository without saving (fail-fast validation)
|
|
410
|
+
claude-mpm agent-source add https://github.com/yourorg/your-agents --test
|
|
411
|
+
|
|
412
|
+
# List configured sources
|
|
413
|
+
claude-mpm agent-source list
|
|
414
|
+
claude-mpm skill-source list
|
|
415
|
+
|
|
416
|
+
# Update from all sources
|
|
417
|
+
claude-mpm agent-source update
|
|
418
|
+
claude-mpm skill-source update
|
|
419
|
+
```
|
|
420
|
+
|
|
421
|
+
### Priority System
|
|
422
|
+
|
|
423
|
+
When multiple sources provide the same agent/skill, priority controls which one wins:
|
|
424
|
+
|
|
425
|
+
- **Lower number = Higher precedence** (priority 10 beats priority 100)
|
|
426
|
+
- **Local agents/skills** (`.claude-mpm/agents/`, `.claude-mpm/skills/`) always override
|
|
427
|
+
- **System defaults** provide fallback
|
|
428
|
+
|
|
429
|
+
**Example Configuration:**
|
|
430
|
+
|
|
431
|
+
```yaml
|
|
432
|
+
# ~/.claude-mpm/config/agent_sources.yaml
|
|
433
|
+
repositories:
|
|
434
|
+
- url: https://github.com/myteam/agents
|
|
435
|
+
priority: 10 # Highest precedence (custom agents)
|
|
436
|
+
|
|
437
|
+
- url: https://github.com/bobmatnyc/claude-mpm-agents
|
|
438
|
+
priority: 100 # System default (official agents)
|
|
439
|
+
```
|
|
440
|
+
|
|
441
|
+
### Hierarchical Organization with BASE-AGENT.md
|
|
442
|
+
|
|
443
|
+
Support for BASE-AGENT.md enables powerful template inheritance:
|
|
444
|
+
|
|
445
|
+
```
|
|
446
|
+
your-agents/
|
|
447
|
+
BASE-AGENT.md # Root shared content (all agents inherit)
|
|
448
|
+
engineering/
|
|
449
|
+
BASE-AGENT.md # Engineering-specific (engineering/* inherit)
|
|
450
|
+
python/
|
|
451
|
+
fastapi-engineer.md # Inherits both BASE files
|
|
452
|
+
django-engineer.md # Inherits both BASE files
|
|
453
|
+
rust/
|
|
454
|
+
systems-engineer.md # Inherits both BASE files
|
|
455
|
+
```
|
|
456
|
+
|
|
457
|
+
**How It Works:**
|
|
458
|
+
1. **Cascading Inheritance**: Each agent inherits from all BASE-AGENT.md files in parent directories
|
|
459
|
+
2. **Automatic Flattening**: Nested repositories are automatically flattened during deployment
|
|
460
|
+
3. **DRY Templates**: Share common instructions across related agents
|
|
461
|
+
4. **Maintainability**: Update shared content in one place
|
|
462
|
+
|
|
463
|
+
See [docs/features/hierarchical-base-agents.md](docs/features/hierarchical-base-agents.md) for complete guide.
|
|
464
|
+
|
|
465
|
+
### Configuration via YAML
|
|
466
|
+
|
|
467
|
+
Edit configuration files directly:
|
|
468
|
+
- **Agents**: `~/.claude-mpm/config/agent_sources.yaml`
|
|
469
|
+
- **Skills**: `~/.claude-mpm/config/skill_sources.yaml`
|
|
470
|
+
|
|
471
|
+
**Example agent_sources.yaml:**
|
|
472
|
+
|
|
473
|
+
```yaml
|
|
474
|
+
repositories:
|
|
475
|
+
- url: https://github.com/bobmatnyc/claude-mpm-agents
|
|
476
|
+
priority: 100
|
|
477
|
+
enabled: true
|
|
478
|
+
|
|
479
|
+
- url: https://github.com/yourorg/custom-agents
|
|
480
|
+
priority: 10
|
|
481
|
+
enabled: true
|
|
482
|
+
```
|
|
483
|
+
|
|
484
|
+
### Benefits
|
|
485
|
+
|
|
486
|
+
✅ **Always Up-to-Date**: Repositories sync automatically on startup
|
|
487
|
+
✅ **Bandwidth Efficient**: ETag-based caching reduces network usage by 95%+
|
|
488
|
+
✅ **Version Control**: Track changes through Git history
|
|
489
|
+
✅ **Immediate Testing**: Fail-fast validation prevents startup issues
|
|
490
|
+
✅ **Nested Support**: Automatic flattening of directory structures
|
|
491
|
+
✅ **Template Inheritance**: BASE-AGENT.md for DRY principles
|
|
492
|
+
✅ **Progress Visibility**: Two-phase progress bars (sync + deployment)
|
|
493
|
+
✅ **Community Access**: Latest improvements available immediately
|
|
494
|
+
✅ **Organization Libraries**: Share team-specific content across projects
|
|
495
|
+
|
|
496
|
+
### Documentation
|
|
497
|
+
|
|
498
|
+
- **[Agent Sources User Guide](docs/user/agent-sources.md)** - Complete guide with examples
|
|
499
|
+
- **[CLI Reference](docs/reference/cli-agent-source.md)** - All `agent-source` commands
|
|
500
|
+
- **[Hierarchical BASE-AGENT.md](docs/features/hierarchical-base-agents.md)** - Template inheritance guide
|
|
501
|
+
- **[Migration Guide](docs/migration/agent-sources-git-default-v4.5.0.md)** - Upgrading from v4.4.x
|
|
502
|
+
- **[Troubleshooting](docs/user/troubleshooting.md#agent-source-issues)** - Common issues and solutions
|
|
503
|
+
|
|
504
|
+
## Skills Deployment
|
|
505
|
+
|
|
506
|
+
Skills are automatically deployed from Git repositories, just like agents. Claude MPM includes **hundreds of skills** from curated repositories:
|
|
507
|
+
|
|
508
|
+
- **System Skills**: Community skills from `bobmatnyc/claude-mpm-skills`
|
|
509
|
+
- **Official Skills**: Anthropic's official skills from `anthropics/skills`
|
|
510
|
+
- **Custom Skills**: Add your own skill repositories
|
|
511
|
+
|
|
512
|
+
### Quick Usage
|
|
513
|
+
|
|
514
|
+
```bash
|
|
515
|
+
# Skills are automatically deployed on first run
|
|
516
|
+
# No manual deployment needed!
|
|
517
|
+
|
|
518
|
+
# Add custom skill repository
|
|
519
|
+
claude-mpm skill-source add https://github.com/yourorg/custom-skills
|
|
520
|
+
|
|
521
|
+
# List configured skill sources
|
|
522
|
+
claude-mpm skill-source list
|
|
523
|
+
|
|
524
|
+
# Update skills from all sources
|
|
525
|
+
claude-mpm skill-source update
|
|
526
|
+
```
|
|
527
|
+
|
|
528
|
+
### How Skills Work
|
|
529
|
+
|
|
530
|
+
1. **Automatic Deployment**: All skills from configured repositories deploy on startup
|
|
531
|
+
2. **Three-Tier Organization**:
|
|
532
|
+
- **Bundled**: System and official skills (hundreds)
|
|
533
|
+
- **User**: Custom skills in `~/.config/claude-mpm/skills/`
|
|
534
|
+
- **Project**: Project-specific skills in `.claude-mpm/skills/`
|
|
535
|
+
3. **Priority Resolution**: Project → User → Bundled (local always wins)
|
|
536
|
+
4. **Auto-Linking**: Skills automatically linked to relevant agents
|
|
537
|
+
5. **Version Tracking**: All skills support semantic versioning
|
|
538
|
+
|
|
539
|
+
### Technology → Skills Mapping
|
|
540
|
+
|
|
541
|
+
The Research agent automatically analyzes your project and recommends relevant skills:
|
|
542
|
+
|
|
543
|
+
| Your Technology | Auto-Recommended Skills |
|
|
544
|
+
|-----------------|-------------------------|
|
|
545
|
+
| Python + pytest | test-driven-development, python-style |
|
|
546
|
+
| FastAPI/Flask | backend-engineer |
|
|
547
|
+
| React/Next.js | frontend-development, web-frameworks |
|
|
548
|
+
| Docker | docker-workflow |
|
|
549
|
+
| GitHub Actions | ci-cd-pipeline-builder |
|
|
550
|
+
| Playwright | webapp-testing |
|
|
551
|
+
|
|
552
|
+
### Interactive Management
|
|
553
|
+
|
|
554
|
+
```bash
|
|
555
|
+
# Interactive skills wizard
|
|
556
|
+
claude-mpm configure
|
|
557
|
+
# Choose option 2: Skills Management
|
|
558
|
+
|
|
559
|
+
# Features:
|
|
560
|
+
# - View all deployed skills
|
|
561
|
+
# - Configure skill assignments to agents
|
|
562
|
+
# - Auto-link skills based on agent roles
|
|
563
|
+
# - Manage custom skill repositories
|
|
107
564
|
```
|
|
108
565
|
|
|
109
|
-
|
|
566
|
+
### Important Notes
|
|
110
567
|
|
|
568
|
+
- ⚠️ Skills load at **Claude Code startup only** - restart required after adding repositories
|
|
569
|
+
- ✅ Batch add related skill repositories to minimize restarts
|
|
570
|
+
- ✅ Research agent automatically recommends missing skills during project analysis
|
|
571
|
+
- See [Skills Deployment Guide](docs/guides/skills-deployment-guide.md) for comprehensive details
|
|
572
|
+
- See [Skills Quick Reference](docs/reference/skills-quick-reference.md) for command reference
|
|
111
573
|
|
|
112
|
-
## Architecture (v4.4.1)
|
|
113
574
|
|
|
114
|
-
|
|
575
|
+
## Architecture
|
|
576
|
+
|
|
577
|
+
Claude MPM features a clean, service-oriented architecture:
|
|
115
578
|
|
|
116
579
|
- **Streamlined Rich Interface**: Removed complex TUI system (~2,500 lines) for cleaner user experience
|
|
117
|
-
- **
|
|
118
|
-
- **Persistent Knowledge System**: Project-specific kuzu-memory databases with intelligent prompt enrichment
|
|
580
|
+
- **MCP Integration**: Full support for Model Context Protocol services with automatic detection
|
|
119
581
|
- **Service-Oriented Architecture**: Simplified five specialized service domains
|
|
120
582
|
- **Interface-Based Contracts**: All services implement explicit interfaces
|
|
121
583
|
- **Enhanced Performance**: ~3,700 lines removed for better startup time and maintainability
|
|
@@ -131,11 +593,26 @@ Claude MPM includes 15 specialized agents:
|
|
|
131
593
|
|
|
132
594
|
#### Core Development
|
|
133
595
|
- **Engineer** - Software development and implementation
|
|
134
|
-
- **Research** - Code analysis and research
|
|
596
|
+
- **Research** - Code analysis and research
|
|
135
597
|
- **Documentation** - Documentation creation and maintenance
|
|
136
598
|
- **QA** - Testing and quality assurance
|
|
137
599
|
- **Security** - Security analysis and implementation
|
|
138
600
|
|
|
601
|
+
#### Language-Specific Engineers
|
|
602
|
+
- **Python Engineer (v2.3.0)** - Type-safe, async-first Python with SOA patterns for non-trivial applications
|
|
603
|
+
- Service-oriented architecture with ABC interfaces for applications
|
|
604
|
+
- Lightweight script patterns for automation and one-off tasks
|
|
605
|
+
- Clear decision criteria for when to use DI/SOA vs simple functions
|
|
606
|
+
- Dependency injection containers with auto-resolution
|
|
607
|
+
- Use for: Web applications, microservices, data pipelines (DI/SOA) or scripts, CLI tools, notebooks (simple functions)
|
|
608
|
+
|
|
609
|
+
- **Rust Engineer (v1.1.0)** - Memory-safe, high-performance systems with trait-based service architecture
|
|
610
|
+
- Dependency injection with traits (constructor injection, trait objects)
|
|
611
|
+
- Service-oriented architecture patterns (repository, builder)
|
|
612
|
+
- Decision criteria for when to use DI/SOA vs simple code
|
|
613
|
+
- Async programming with tokio and zero-cost abstractions
|
|
614
|
+
- Use for: Web services, microservices (DI/SOA) or CLI tools, scripts (simple code)
|
|
615
|
+
|
|
139
616
|
#### Operations & Infrastructure
|
|
140
617
|
- **Ops** - Operations and deployment with advanced git commit authority and security verification (v2.2.2+)
|
|
141
618
|
- **Version Control** - Git and version management
|
|
@@ -155,7 +632,54 @@ Claude MPM includes 15 specialized agents:
|
|
|
155
632
|
- **Code Analyzer** - Static code analysis with AST and tree-sitter
|
|
156
633
|
|
|
157
634
|
### Agent Memory System
|
|
158
|
-
|
|
635
|
+
|
|
636
|
+
**NEW in v5.4.13**: Runtime memory loading for instant updates and better efficiency.
|
|
637
|
+
|
|
638
|
+
**How It Works:**
|
|
639
|
+
- **Memory Files**: Store agent memories in `.claude-mpm/memories/{agent_id}.md` (e.g., `engineer.md`, `qa.md`)
|
|
640
|
+
- **Runtime Loading**: Memories loaded dynamically when agents are delegated to (no restart required)
|
|
641
|
+
- **Instant Updates**: Memory changes take effect immediately
|
|
642
|
+
- **Event Observability**: Memory loading tracked via EventBus (`agent.memory.loaded` events)
|
|
643
|
+
|
|
644
|
+
**Memory Format:**
|
|
645
|
+
Agents learn project-specific patterns using a simple markdown list format and can update memories via JSON response fields (`remember` for incremental updates, `MEMORIES` for complete replacement).
|
|
646
|
+
|
|
647
|
+
**See:** [Memory Flow Architecture](docs/architecture/memory-flow.md) for complete technical details.
|
|
648
|
+
|
|
649
|
+
### Skills System
|
|
650
|
+
|
|
651
|
+
Claude MPM includes a powerful skills system that eliminates redundant agent guidance through reusable skill modules:
|
|
652
|
+
|
|
653
|
+
**20 Bundled Skills** covering essential development workflows (all versioned starting at 0.1.0):
|
|
654
|
+
- Git workflow, TDD, code review, systematic debugging
|
|
655
|
+
- API documentation, refactoring patterns, performance profiling
|
|
656
|
+
- Docker containerization, database migrations, security scanning
|
|
657
|
+
- JSON/PDF/XLSX handling, async testing, ImageMagick operations
|
|
658
|
+
- Local development servers: Next.js, FastAPI, Vite, Express
|
|
659
|
+
- Web performance: Lighthouse metrics, Core Web Vitals optimization
|
|
660
|
+
|
|
661
|
+
**Three-Tier Organization:**
|
|
662
|
+
- **Bundled**: Core skills included with Claude MPM (~15,000 lines of reusable guidance)
|
|
663
|
+
- **User**: Custom skills in `~/.config/claude-mpm/skills/`
|
|
664
|
+
- **Project**: Project-specific skills in `.claude-mpm/skills/`
|
|
665
|
+
|
|
666
|
+
**Version Tracking:**
|
|
667
|
+
- All skills support semantic versioning (MAJOR.MINOR.PATCH)
|
|
668
|
+
- Check versions with `/mpm-version` command in Claude Code
|
|
669
|
+
- See [Skills Versioning Guide](docs/user/skills-versioning.md) for details
|
|
670
|
+
|
|
671
|
+
**Quick Access:**
|
|
672
|
+
```bash
|
|
673
|
+
# Interactive skills management
|
|
674
|
+
claude-mpm configure
|
|
675
|
+
# Choose option 2: Skills Management
|
|
676
|
+
|
|
677
|
+
# Auto-link skills to agents based on their roles
|
|
678
|
+
# Configure custom skill assignments
|
|
679
|
+
# View current skill mappings
|
|
680
|
+
```
|
|
681
|
+
|
|
682
|
+
Skills are automatically injected into agent prompts, reducing template size by 85% while maintaining full capability coverage.
|
|
159
683
|
|
|
160
684
|
### MCP Gateway (Model Context Protocol)
|
|
161
685
|
|
|
@@ -179,10 +703,76 @@ claude-mpm cleanup-memory
|
|
|
179
703
|
claude-mpm cleanup-memory --days 7
|
|
180
704
|
```
|
|
181
705
|
|
|
706
|
+
### Resume Log System
|
|
707
|
+
|
|
708
|
+
**NEW in v4.17.2** - Proactive context management for seamless session continuity.
|
|
709
|
+
|
|
710
|
+
The Resume Log System automatically generates structured 10k-token logs when approaching Claude's context window limits, enabling you to resume work without losing important context.
|
|
711
|
+
|
|
712
|
+
**Key Features**:
|
|
713
|
+
- 🎯 **Graduated Thresholds**: Warnings at 70% (60k buffer), 85% (30k buffer), and 95% (10k buffer)
|
|
714
|
+
- 📋 **Structured Logs**: 10k-token budget intelligently distributed across 7 key sections
|
|
715
|
+
- 🔄 **Seamless Resumption**: Automatically loads previous session context on startup
|
|
716
|
+
- 📁 **Human-Readable**: Markdown format for both Claude and human review
|
|
717
|
+
- ⚙️ **Zero-Configuration**: Works automatically with sensible defaults
|
|
718
|
+
|
|
719
|
+
**How It Works**:
|
|
720
|
+
1. Monitor token usage continuously throughout session
|
|
721
|
+
2. Display proactive warnings at 70%, 85%, and 95% thresholds
|
|
722
|
+
3. Automatically generate resume log when approaching limits
|
|
723
|
+
4. Load previous resume log when starting new session
|
|
724
|
+
5. Continue work seamlessly with full context preservation
|
|
725
|
+
|
|
726
|
+
**Example Resume Log Structure**:
|
|
727
|
+
```markdown
|
|
728
|
+
# Session Resume Log: 20251101_115000
|
|
729
|
+
|
|
730
|
+
## Context Metrics (500 tokens)
|
|
731
|
+
- Token usage and percentage
|
|
732
|
+
|
|
733
|
+
## Mission Summary (1,000 tokens)
|
|
734
|
+
- Overall goal and purpose
|
|
735
|
+
|
|
736
|
+
## Accomplishments (2,000 tokens)
|
|
737
|
+
- What was completed
|
|
738
|
+
|
|
739
|
+
## Key Findings (2,500 tokens)
|
|
740
|
+
- Important discoveries
|
|
741
|
+
|
|
742
|
+
## Decisions & Rationale (1,500 tokens)
|
|
743
|
+
- Why choices were made
|
|
744
|
+
|
|
745
|
+
## Next Steps (1,500 tokens)
|
|
746
|
+
- What to do next
|
|
747
|
+
|
|
748
|
+
## Critical Context (1,000 tokens)
|
|
749
|
+
- Essential state, IDs, paths
|
|
750
|
+
```
|
|
751
|
+
|
|
752
|
+
**Configuration** (`.claude-mpm/configuration.yaml`):
|
|
753
|
+
```yaml
|
|
754
|
+
context_management:
|
|
755
|
+
enabled: true
|
|
756
|
+
budget_total: 200000
|
|
757
|
+
thresholds:
|
|
758
|
+
caution: 0.70 # First warning - plan transition
|
|
759
|
+
warning: 0.85 # Strong warning - wrap up
|
|
760
|
+
critical: 0.95 # Urgent - stop new work
|
|
761
|
+
resume_logs:
|
|
762
|
+
enabled: true
|
|
763
|
+
auto_generate: true
|
|
764
|
+
max_tokens: 10000
|
|
765
|
+
storage_dir: ".claude-mpm/resume-logs"
|
|
766
|
+
```
|
|
767
|
+
|
|
768
|
+
**QA Status**: 40/41 tests passing (97.6% coverage), APPROVED FOR PRODUCTION ✅
|
|
769
|
+
|
|
770
|
+
See [docs/user/resume-logs.md](docs/user/resume-logs.md) for complete documentation.
|
|
771
|
+
|
|
182
772
|
### Real-Time Monitoring
|
|
183
773
|
The `--monitor` flag opens a web dashboard showing live agent activity, file operations, and session management.
|
|
184
774
|
|
|
185
|
-
See [docs/MEMORY.md](docs/MEMORY.md) and [docs/developer/11-dashboard/README.md](docs/developer/11-dashboard/README.md) for details.
|
|
775
|
+
See [docs/reference/MEMORY.md](docs/reference/MEMORY.md) and [docs/developer/11-dashboard/README.md](docs/developer/11-dashboard/README.md) for details.
|
|
186
776
|
|
|
187
777
|
|
|
188
778
|
## 📚 Documentation
|
|
@@ -195,7 +785,7 @@ See [docs/MEMORY.md](docs/MEMORY.md) and [docs/developer/11-dashboard/README.md]
|
|
|
195
785
|
- **[🚀 5-Minute Quick Start](docs/user/quickstart.md)** - Get running immediately
|
|
196
786
|
- **[📦 Installation Guide](docs/user/installation.md)** - All installation methods
|
|
197
787
|
- **[📖 User Guide](docs/user/README.md)** - Complete user documentation
|
|
198
|
-
- **[❓ FAQ](docs/
|
|
788
|
+
- **[❓ FAQ](docs/guides/FAQ.md)** - Common questions answered
|
|
199
789
|
|
|
200
790
|
#### 💻 For Developers
|
|
201
791
|
- **[🏗️ Architecture Overview](docs/developer/ARCHITECTURE.md)** - Service-oriented system design
|
|
@@ -217,21 +807,51 @@ See [docs/MEMORY.md](docs/MEMORY.md) and [docs/developer/11-dashboard/README.md]
|
|
|
217
807
|
- **Single Entry Point**: [docs/README.md](docs/README.md) is your navigation hub
|
|
218
808
|
- **Clear User Paths**: Organized by user type and experience level
|
|
219
809
|
- **Cross-Referenced**: Links between related topics and sections
|
|
220
|
-
- **Up-to-Date**: Version 4.
|
|
221
|
-
|
|
222
|
-
## Recent Updates (
|
|
810
|
+
- **Up-to-Date**: Version 4.16.3 with web performance optimization skill
|
|
811
|
+
|
|
812
|
+
## Recent Updates (v5.0) 🎉
|
|
813
|
+
|
|
814
|
+
**Major Release**: Git Repository Integration for Agents & Skills
|
|
815
|
+
|
|
816
|
+
**🚀 What's New:**
|
|
817
|
+
- **Git Repository Support**: Agents and skills now deploy from Git repositories
|
|
818
|
+
- **47+ Agents**: Comprehensive agent library from curated repositories
|
|
819
|
+
- **Hundreds of Skills**: System skills + Official Anthropic skills automatically deployed
|
|
820
|
+
- **Hierarchical BASE-AGENT.md**: Template inheritance for DRY principles
|
|
821
|
+
- **Nested Repository Support**: Automatic flattening of directory structures
|
|
822
|
+
- **Immediate Testing**: Fail-fast validation when adding repositories
|
|
823
|
+
- **Two-Phase Progress**: Clear visibility during sync and deployment
|
|
824
|
+
- **ETag Caching**: 95%+ bandwidth reduction with intelligent caching
|
|
825
|
+
|
|
826
|
+
**🔧 Repository Management:**
|
|
827
|
+
- `claude-mpm agent-source add/list/update` - Manage agent repositories
|
|
828
|
+
- `claude-mpm skill-source add/list/update` - Manage skill repositories
|
|
829
|
+
- Priority-based resolution for multiple sources
|
|
830
|
+
- YAML configuration support
|
|
831
|
+
|
|
832
|
+
**📚 Documentation:**
|
|
833
|
+
- Complete guides for Git repository integration
|
|
834
|
+
- Hierarchical BASE-AGENT.md documentation
|
|
835
|
+
- Migration guides for existing installations
|
|
836
|
+
- Troubleshooting and best practices
|
|
837
|
+
|
|
838
|
+
**🎯 Benefits:**
|
|
839
|
+
- Always up-to-date content from repositories
|
|
840
|
+
- Community-driven agent and skill libraries
|
|
841
|
+
- Easy sharing of organizational content
|
|
842
|
+
- Version control for all templates
|
|
223
843
|
|
|
224
|
-
|
|
844
|
+
See [CHANGELOG.md](CHANGELOG.md) for full history and [docs/user/MIGRATION.md](docs/user/MIGRATION.md) for upgrade instructions.
|
|
225
845
|
|
|
226
|
-
|
|
846
|
+
## 📜 License
|
|
227
847
|
|
|
228
|
-
|
|
848
|
+
[](LICENSE)
|
|
229
849
|
|
|
230
|
-
|
|
850
|
+
Licensed under the [Elastic License 2.0](LICENSE) - free for internal use and commercial products.
|
|
231
851
|
|
|
232
|
-
**
|
|
852
|
+
**Main restriction:** Cannot offer as a hosted SaaS service without a commercial license.
|
|
233
853
|
|
|
234
|
-
|
|
854
|
+
📖 [Licensing FAQ](LICENSE-FAQ.md) | 💼 Commercial licensing: bob@matsuoka.com
|
|
235
855
|
|
|
236
856
|
## Development
|
|
237
857
|
|
|
@@ -256,7 +876,7 @@ The project uses automated code formatting and quality checks:
|
|
|
256
876
|
See [docs/developer/CODE_FORMATTING.md](docs/developer/CODE_FORMATTING.md) for details.
|
|
257
877
|
|
|
258
878
|
### Contributing
|
|
259
|
-
Contributions are welcome! Please see our [project structure guide](docs/STRUCTURE.md) and follow the established patterns.
|
|
879
|
+
Contributions are welcome! Please see our [project structure guide](docs/reference/STRUCTURE.md) and follow the established patterns.
|
|
260
880
|
|
|
261
881
|
**Development Workflow**:
|
|
262
882
|
1. Run `make dev-complete` to set up your environment
|
|
@@ -264,10 +884,7 @@ Contributions are welcome! Please see our [project structure guide](docs/STRUCTU
|
|
|
264
884
|
3. All code must pass quality checks before merging
|
|
265
885
|
|
|
266
886
|
### Project Structure
|
|
267
|
-
See [docs/STRUCTURE.md](docs/STRUCTURE.md) for codebase organization.
|
|
268
|
-
|
|
269
|
-
### License
|
|
270
|
-
MIT License - see [LICENSE](LICENSE) file.
|
|
887
|
+
See [docs/reference/STRUCTURE.md](docs/reference/STRUCTURE.md) for codebase organization.
|
|
271
888
|
|
|
272
889
|
## Credits
|
|
273
890
|
|
package/npm-bin/claude-mpm.js
CHANGED
|
@@ -15,11 +15,11 @@ function checkPythonVersion(pythonCmd) {
|
|
|
15
15
|
try {
|
|
16
16
|
const versionOutput = execSync(`${pythonCmd} --version`, { encoding: 'utf8', stdio: 'pipe' });
|
|
17
17
|
const versionMatch = versionOutput.match(/Python (\d+)\.(\d+)\.(\d+)/);
|
|
18
|
-
|
|
18
|
+
|
|
19
19
|
if (!versionMatch) return false;
|
|
20
|
-
|
|
20
|
+
|
|
21
21
|
const [, major, minor] = versionMatch.map(Number);
|
|
22
|
-
return major > REQUIRED_PYTHON_VERSION[0] ||
|
|
22
|
+
return major > REQUIRED_PYTHON_VERSION[0] ||
|
|
23
23
|
(major === REQUIRED_PYTHON_VERSION[0] && minor >= REQUIRED_PYTHON_VERSION[1]);
|
|
24
24
|
} catch (error) {
|
|
25
25
|
return false;
|
|
@@ -28,7 +28,7 @@ function checkPythonVersion(pythonCmd) {
|
|
|
28
28
|
|
|
29
29
|
function findPython() {
|
|
30
30
|
const pythonCommands = ['python3', 'python', 'python3.11', 'python3.10', 'python3.9', 'python3.8'];
|
|
31
|
-
|
|
31
|
+
|
|
32
32
|
for (const cmd of pythonCommands) {
|
|
33
33
|
if (checkPythonVersion(cmd)) {
|
|
34
34
|
return cmd;
|
|
@@ -39,7 +39,7 @@ function findPython() {
|
|
|
39
39
|
|
|
40
40
|
function main() {
|
|
41
41
|
const pythonCmd = findPython();
|
|
42
|
-
|
|
42
|
+
|
|
43
43
|
if (!pythonCmd) {
|
|
44
44
|
console.error(`
|
|
45
45
|
❌ Error: Python ${REQUIRED_PYTHON_VERSION.join('.')}+ is required but not found.
|
|
@@ -77,9 +77,9 @@ Or using pip directly:
|
|
|
77
77
|
|
|
78
78
|
// Launch claude-mpm with all arguments
|
|
79
79
|
const args = process.argv.slice(2);
|
|
80
|
-
const child = spawn(pythonCmd, ['-m', 'claude_mpm'].concat(args), {
|
|
80
|
+
const child = spawn(pythonCmd, ['-m', 'claude_mpm'].concat(args), {
|
|
81
81
|
stdio: 'inherit',
|
|
82
|
-
env: process.env
|
|
82
|
+
env: process.env
|
|
83
83
|
});
|
|
84
84
|
|
|
85
85
|
child.on('exit', (code) => {
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "claude-mpm",
|
|
3
|
-
"version": "4.
|
|
3
|
+
"version": "5.4.31",
|
|
4
4
|
"description": "NPM wrapper for claude-mpm Python package - Requires Python 3.8+. Orchestrate Claude with agent delegation and ticket tracking",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"claude",
|
|
@@ -52,6 +52,7 @@
|
|
|
52
52
|
"registry": "https://registry.npmjs.org/"
|
|
53
53
|
},
|
|
54
54
|
"devDependencies": {
|
|
55
|
+
"@playwright/test": "^1.57.0",
|
|
55
56
|
"@types/react": "^18.2.0",
|
|
56
57
|
"@types/react-dom": "^18.2.0",
|
|
57
58
|
"@vitejs/plugin-react": "^4.2.0",
|
|
@@ -61,6 +62,7 @@
|
|
|
61
62
|
},
|
|
62
63
|
"dependencies": {
|
|
63
64
|
"playwright": "^1.55.0",
|
|
65
|
+
"puppeteer": "^24.34.0",
|
|
64
66
|
"react": "^18.2.0",
|
|
65
67
|
"react-dom": "^18.2.0",
|
|
66
68
|
"react-window": "^1.8.8",
|