claude-mpm 6.5.42 → 6.5.44
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/README.md +40 -51
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -7,13 +7,13 @@
|
|
|
7
7
|
|
|
8
8
|
**A comprehensive workflow and agent management framework for Claude Code** that transforms your AI coding assistant into a full-featured development platform with multi-agent orchestration, skills system, MCP integration, session management, and semantic code search.
|
|
9
9
|
|
|
10
|
-
> **⚠️ 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.
|
|
10
|
+
> **⚠️ Important**: Claude MPM **requires Claude Code CLI** (v1.0.92+; v2.1.3+ to use Skills features), not Claude Desktop (app). All MCP integrations work with Claude Code's CLI interface only.
|
|
11
11
|
>
|
|
12
12
|
> **Don't have Claude Code?** Install from: https://docs.anthropic.com/en/docs/claude-code
|
|
13
13
|
>
|
|
14
14
|
> **Quick Start**: See [Getting Started Guide](docs/getting-started/README.md) to get running in 5 minutes!
|
|
15
15
|
|
|
16
|
-
> **Current stable version: v6.
|
|
16
|
+
> **Current stable version: v6.5.43** — plugin install path, binary consolidation, and auto-migration. See [Beta Guide](docs/beta-6.0.md) for the v6.0 release notes and [CHANGELOG](CHANGELOG.md) for the full history.
|
|
17
17
|
|
|
18
18
|
---
|
|
19
19
|
|
|
@@ -76,9 +76,9 @@ Claude MPM transforms Claude Code into a **comprehensive AI development platform
|
|
|
76
76
|
- **Skills Optimization** - Intelligent project analysis with automated skill recommendations
|
|
77
77
|
|
|
78
78
|
### 🔌 MCP Integration (Model Context Protocol)
|
|
79
|
-
- **Google Workspace MCP** -
|
|
80
|
-
- **Notion** -
|
|
81
|
-
- **Confluence** -
|
|
79
|
+
- **Google Workspace MCP** - 67 tools for Gmail, Calendar, Drive, Docs, Sheets, Slides, Tasks
|
|
80
|
+
- **Notion** - pages and databases via the official Notion MCP server
|
|
81
|
+
- **Confluence** - pages, spaces, CQL search + bulk operations
|
|
82
82
|
- **Slack** - User proxy for channels, messages, DMs, search
|
|
83
83
|
- **Semantic Code Search** - AI-powered code discovery via trusty-search
|
|
84
84
|
- **Ticket Management** - GitHub, Linear, Jira integration via mcp-ticketer
|
|
@@ -103,7 +103,7 @@ Claude MPM transforms Claude Code into a **comprehensive AI development platform
|
|
|
103
103
|
### Prerequisites
|
|
104
104
|
|
|
105
105
|
1. **Python 3.11-3.13** (Python 3.13 recommended; 3.14 NOT yet supported)
|
|
106
|
-
2. **Claude Code CLI v2.1.3
|
|
106
|
+
2. **Claude Code CLI v1.0.92+** (required!; v2.1.3+ to use Skills features)
|
|
107
107
|
3. **GitHub Token** (recommended for skill sources)
|
|
108
108
|
|
|
109
109
|
> **Python Version Warning**:
|
|
@@ -242,16 +242,6 @@ uv tool install mcp-browser --python 3.13
|
|
|
242
242
|
|
|
243
243
|
[→ Learn more: Developer Use Cases](docs/usecases/developers.md#semantic-code-search)
|
|
244
244
|
|
|
245
|
-
### 🧪 MPM Commander (ALPHA)
|
|
246
|
-
- **Multi-Project Orchestration** with autonomous AI coordination across codebases
|
|
247
|
-
- **Tmux Integration** for isolated project environments and session management
|
|
248
|
-
- **Event-Driven Architecture** with inbox system for cross-project communication
|
|
249
|
-
- **LLM-Powered Decisions** via OpenRouter for autonomous work queue processing
|
|
250
|
-
- **Real-Time Monitoring** with state tracking (IDLE, WORKING, BLOCKED, PAUSED, ERROR)
|
|
251
|
-
- ⚠️ **Experimental** - API and CLI interface subject to change
|
|
252
|
-
|
|
253
|
-
[→ Commander Documentation](docs/commander/usage-guide.md)
|
|
254
|
-
|
|
255
245
|
### 🔌 Advanced Integration
|
|
256
246
|
- **MCP Integration** with full Model Context Protocol support
|
|
257
247
|
- **MCP Session Server** (`claude-mpm mcp serve session`) for programmatic session management
|
|
@@ -259,34 +249,35 @@ uv tool install mcp-browser --python 3.13
|
|
|
259
249
|
- **Multi-Project Support** with per-session working directories
|
|
260
250
|
- **Git Integration** with diff viewing and change tracking
|
|
261
251
|
|
|
262
|
-
[→ Learn more: MCP Gateway](docs/developer/13-mcp-gateway/README.md) | [→ MCP Session Server](docs/mcp-session-server.md)
|
|
252
|
+
[→ Learn more: MCP Gateway](docs/developer/13-mcp-gateway/README.md) | [→ MCP Session Server](docs/integrations/mcp-session-server.md)
|
|
263
253
|
|
|
264
254
|
### 🔐 External Integrations
|
|
265
255
|
- **Browser-Based OAuth** for secure authentication with MCP services
|
|
266
|
-
- **Google Workspace MCP**
|
|
267
|
-
- **Gmail** (
|
|
268
|
-
- **Calendar** (
|
|
269
|
-
- **Drive** (
|
|
270
|
-
- **Docs** (
|
|
271
|
-
- **Tasks** (
|
|
272
|
-
-
|
|
273
|
-
|
|
274
|
-
-
|
|
275
|
-
-
|
|
256
|
+
- **Google Workspace MCP** (`gworkspace-mcp`) with **67 tools** for Gmail, Calendar, Drive, Docs, Sheets, Slides, and Tasks:
|
|
257
|
+
- **Gmail** (18 tools): search, read, send, drafts, labels
|
|
258
|
+
- **Calendar** (10 tools): list, get, create, update, delete events
|
|
259
|
+
- **Drive** (17 tools): search, read, folders, upload, download, move
|
|
260
|
+
- **Docs** (11 tools): create, edit, append, comments, markdown import
|
|
261
|
+
- **Tasks** (10 tools): task lists and task management
|
|
262
|
+
- Setup: `claude-mpm setup gworkspace-mcp`
|
|
263
|
+
- **Notion MCP** via the official `@notionhq/notion-mcp-server` package:
|
|
264
|
+
- Read/write Notion pages and databases
|
|
265
|
+
- Setup: `claude-mpm setup notion-mpm`
|
|
266
|
+
- **Confluence MCP** (`confluence-mcp`) with bulk operations:
|
|
276
267
|
- Get/create/update pages, search with CQL, list spaces, markdown import
|
|
277
268
|
- Setup: `claude-mpm setup confluence`
|
|
278
|
-
- **Slack MCP** user proxy
|
|
279
|
-
- Channels, messages, DMs, search
|
|
269
|
+
- **Slack MCP** user proxy — acts as the authenticated user:
|
|
270
|
+
- Channels, messages, DMs, search
|
|
280
271
|
- Setup: `claude-mpm setup slack-mpm`
|
|
281
272
|
- **Encrypted Token Storage** using Fernet encryption with system keychain
|
|
282
273
|
- **Automatic Token Refresh** handles expiration seamlessly
|
|
283
274
|
|
|
284
275
|
```bash
|
|
285
|
-
# Set up Google Workspace OAuth
|
|
286
|
-
claude-mpm
|
|
276
|
+
# Set up Google Workspace (runs OAuth as part of setup)
|
|
277
|
+
claude-mpm setup gworkspace-mcp
|
|
287
278
|
|
|
288
279
|
# Set up Notion (API token)
|
|
289
|
-
claude-mpm setup notion
|
|
280
|
+
claude-mpm setup notion-mpm
|
|
290
281
|
|
|
291
282
|
# Set up Confluence (URL + API token)
|
|
292
283
|
claude-mpm setup confluence
|
|
@@ -294,14 +285,14 @@ claude-mpm setup confluence
|
|
|
294
285
|
# Set up Slack (OAuth user token)
|
|
295
286
|
claude-mpm setup slack-mpm
|
|
296
287
|
|
|
297
|
-
# Check token status
|
|
298
|
-
claude-mpm oauth status
|
|
288
|
+
# Check Google Workspace token status
|
|
289
|
+
claude-mpm oauth status gworkspace-mcp
|
|
299
290
|
|
|
300
291
|
# List OAuth-capable services
|
|
301
292
|
claude-mpm oauth list
|
|
302
293
|
```
|
|
303
294
|
|
|
304
|
-
[→ Google Workspace Setup](docs/
|
|
295
|
+
[→ Google Workspace Setup](docs/integrations/gworkspace-mcp.md) | [→ Confluence Setup](docs/integrations/CONFLUENCE_SETUP.md) | [→ Slack Setup](docs/integrations/SLACK_USER_PROXY_SETUP.md) | [→ All Integrations](docs/integrations/README.md)
|
|
305
296
|
|
|
306
297
|
### ⚡ Performance & Security
|
|
307
298
|
- **ZTK Shell Output Compression** — 80–97% token reduction on shell commands (find, grep, ls, git, etc.) with automatic bundled binary
|
|
@@ -353,12 +344,12 @@ claude-mpm doctor
|
|
|
353
344
|
claude-mpm verify
|
|
354
345
|
|
|
355
346
|
# Manage memory
|
|
356
|
-
claude-mpm cleanup
|
|
347
|
+
claude-mpm cleanup
|
|
357
348
|
```
|
|
358
349
|
|
|
359
350
|
**💡 Startup Performance**: Claude MPM syncs agents and skills once per day. Subsequent launches are near-instant (~100ms). Use `--force-sync` to pull the latest content immediately or set `CLAUDE_MPM_SYNC_TTL` (seconds) to customize the sync interval.
|
|
360
351
|
|
|
361
|
-
**💡 Update Checking**: Claude MPM automatically checks for updates and verifies Claude Code compatibility on startup. Configure in `~/.claude-mpm/configuration.yaml` or see [
|
|
352
|
+
**💡 Update Checking**: Claude MPM automatically checks for updates and verifies Claude Code compatibility on startup. Configure in `~/.claude-mpm/configuration.yaml` or see the [Configuration Reference](docs/configuration/reference.md).
|
|
362
353
|
|
|
363
354
|
[→ Complete usage examples: User Guide](docs/user/user-guide.md)
|
|
364
355
|
|
|
@@ -372,11 +363,11 @@ Claude MPM lets you pin any agent — including the Planner — to a specific mo
|
|
|
372
363
|
|
|
373
364
|
| Alias | Resolves to |
|
|
374
365
|
|-------|-------------|
|
|
375
|
-
| `haiku` | `
|
|
376
|
-
| `sonnet` | `claude-sonnet-4-
|
|
366
|
+
| `haiku` | `haiku` (current Claude Code haiku tier) |
|
|
367
|
+
| `sonnet` | `claude-sonnet-4-6` |
|
|
377
368
|
| `opus` | `claude-opus-4-7` |
|
|
378
369
|
|
|
379
|
-
Full Anthropic model names (e.g. `claude-opus-4-7`) are also accepted in place of an alias.
|
|
370
|
+
Full Anthropic model names (e.g. `claude-opus-4-7`) are also accepted in place of an alias; dated `opus` IDs all resolve to the opus tier model.
|
|
380
371
|
|
|
381
372
|
### Priority order (highest to lowest)
|
|
382
373
|
|
|
@@ -657,8 +648,6 @@ Before cloud sled work begins, Phase 4 completes the channel hub foundation:
|
|
|
657
648
|
3. GitHub context injection in plain `--sdk` mode (not just channels mode)
|
|
658
649
|
4. Test coverage for the channels and GitHub service layers
|
|
659
650
|
|
|
660
|
-
See [`docs/research/multi-channel-github-phase4-analysis-2026-03-26.md`](docs/research/multi-channel-github-phase4-analysis-2026-03-26.md) for the detailed Phase 4 analysis.
|
|
661
|
-
|
|
662
651
|
---
|
|
663
652
|
|
|
664
653
|
## Documentation
|
|
@@ -669,7 +658,7 @@ See [`docs/research/multi-channel-github-phase4-analysis-2026-03-26.md`](docs/re
|
|
|
669
658
|
|
|
670
659
|
#### 👥 For Users
|
|
671
660
|
- **[🚀 5-Minute Quick Start](docs/user/quickstart.md)** - Get running immediately
|
|
672
|
-
- **[📦 Installation Guide](docs/
|
|
661
|
+
- **[📦 Installation Guide](docs/getting-started/installation.md)** - All installation methods
|
|
673
662
|
- **[📖 User Guide](docs/user/user-guide.md)** - Complete user documentation
|
|
674
663
|
- **[❓ FAQ](docs/guides/FAQ.md)** - Common questions answered
|
|
675
664
|
|
|
@@ -677,17 +666,17 @@ See [`docs/research/multi-channel-github-phase4-analysis-2026-03-26.md`](docs/re
|
|
|
677
666
|
- **[🏗️ Architecture Overview](docs/developer/ARCHITECTURE.md)** - Service-oriented system design
|
|
678
667
|
- **[💻 Developer Guide](docs/developer/README.md)** - Complete development documentation
|
|
679
668
|
- **[🧪 Contributing](docs/developer/03-development/README.md)** - How to contribute
|
|
680
|
-
- **[📊 API Reference](docs/
|
|
669
|
+
- **[📊 API Reference](docs/reference/api-overview.md)** - API documentation overview
|
|
681
670
|
|
|
682
671
|
#### 🤖 For Agent Creators
|
|
683
|
-
- **[🤖 Agent System](docs/
|
|
672
|
+
- **[🤖 Agent System](docs/reference/agents-overview.md)** - Agent system overview
|
|
684
673
|
- **[📝 Creation Guide](docs/developer/07-agent-system/creation-guide.md)** - Step-by-step tutorials
|
|
685
674
|
- **[📋 Schema Reference](docs/developer/10-schemas/agent_schema_documentation.md)** - Agent format specifications
|
|
686
675
|
|
|
687
676
|
#### 🚀 For Operations
|
|
688
|
-
- **[🚀 Deployment](docs/
|
|
689
|
-
- **[📊 Monitoring](docs/
|
|
690
|
-
- **[🐛 Troubleshooting](docs/
|
|
677
|
+
- **[🚀 Deployment](docs/deployment/README.md)** - Release management & versioning
|
|
678
|
+
- **[📊 Monitoring](docs/guides/monitoring.md)** - Real-time dashboard & metrics
|
|
679
|
+
- **[🐛 Troubleshooting](docs/user/troubleshooting.md)** - Enhanced `doctor` command with auto-fix
|
|
691
680
|
|
|
692
681
|
---
|
|
693
682
|
|
|
@@ -706,8 +695,8 @@ Claude MPM supports multiple integrations for enhanced functionality. See **[Com
|
|
|
706
695
|
|
|
707
696
|
- **[Google Workspace MCP](docs/integrations/gworkspace-mcp.md)** - Gmail, Calendar, Drive, Docs, Tasks (67 tools)
|
|
708
697
|
- **[Slack](docs/integrations/slack.md)** - Slack workspace integration via user proxy
|
|
709
|
-
- **[Notion](docs/integrations/
|
|
710
|
-
- **[Confluence](docs/integrations/CONFLUENCE_SETUP.md)** - Confluence pages and spaces (
|
|
698
|
+
- **[Notion](docs/integrations/README.md#notion)** - Notion databases and pages via the official Notion MCP server
|
|
699
|
+
- **[Confluence](docs/integrations/CONFLUENCE_SETUP.md)** - Confluence pages and spaces (MCP tools + bulk CLI)
|
|
711
700
|
|
|
712
701
|
### Quick Setup
|
|
713
702
|
|
|
@@ -721,7 +710,7 @@ claude-mpm setup trusty-search
|
|
|
721
710
|
claude-mpm setup gworkspace-mcp # Canonical name (preferred)
|
|
722
711
|
claude-mpm setup google-workspace-mcp # Legacy alias (also works)
|
|
723
712
|
claude-mpm setup slack-mpm
|
|
724
|
-
claude-mpm setup notion
|
|
713
|
+
claude-mpm setup notion-mpm
|
|
725
714
|
claude-mpm setup confluence
|
|
726
715
|
|
|
727
716
|
# Setup multiple at once
|
package/package.json
CHANGED