@modootoday/pmcp 0.18.0 → 0.18.2
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/.agents/plugins/marketplace.json +1 -1
- package/.claude-plugin/marketplace.json +1 -1
- package/.claude-plugin/plugin.json +2 -2
- package/.mcp.json +1 -1
- package/CHANGELOG.md +112 -20
- package/CONTRIBUTING.md +71 -0
- package/README.md +98 -206
- package/SECURITY.md +17 -1
- package/dist/{apply-4IGTXOCQ.js → apply-JUTGS5WZ.js} +11 -11
- package/dist/{broadcast-3RY3OZGY.js → broadcast-CBMVOV3G.js} +4 -4
- package/dist/{chunk-SG5TPMKH.js → chunk-26WLNWDG.js} +2 -2
- package/dist/{chunk-ELAGZ635.js → chunk-2FIV63WC.js} +5 -5
- package/dist/{chunk-JUXNIXN4.js → chunk-3FCFAQDG.js} +2 -2
- package/dist/{chunk-EJBZGIDK.js → chunk-3IDXEV5E.js} +3 -3
- package/dist/chunk-65KAQSJP.js +7 -0
- package/dist/{chunk-665TA55Z.js → chunk-7HFIGCSL.js} +2 -2
- package/dist/{chunk-R4L6LJJ2.js → chunk-7UCZAN4J.js} +2 -2
- package/dist/{chunk-J6QLLQVL.js → chunk-A7VF7A35.js} +5 -5
- package/dist/{chunk-NZS5CD72.js → chunk-AJ4VXM2U.js} +20 -4
- package/dist/{chunk-25GHX674.js → chunk-D77IRGHO.js} +6 -6
- package/dist/{chunk-4VCC2NXE.js → chunk-DMZHQZ7P.js} +2 -2
- package/dist/{chunk-Q65R3XKX.js → chunk-EAWPJHJ7.js} +2 -2
- package/dist/{chunk-PLX3BOOS.js → chunk-F5QYZK7E.js} +2 -2
- package/dist/{chunk-YMHUM7AV.js → chunk-F5XMGOOX.js} +7 -1
- package/dist/{chunk-7BLPN3W6.js → chunk-FENOGX3U.js} +2 -2
- package/dist/{chunk-N5AQ3PP7.js → chunk-I2ZP2PSA.js} +5 -5
- package/dist/{chunk-UOCLRM7P.js → chunk-IG33DXLT.js} +16 -16
- package/dist/{chunk-RK4PYD7L.js → chunk-LBXO4VPG.js} +2 -2
- package/dist/{chunk-BVCTKPT3.js → chunk-LMUBBIE2.js} +2 -2
- package/dist/{chunk-Z4HRRXRF.js → chunk-LTZH5E3G.js} +6 -5
- package/dist/{chunk-MWFOUBFC.js → chunk-LW4TG7EL.js} +2 -2
- package/dist/{chunk-LAZQBMAU.js → chunk-NLEXKE7U.js} +3 -3
- package/dist/{chunk-ZH6R642Z.js → chunk-PKODFR5F.js} +2 -2
- package/dist/{chunk-IGYRMM62.js → chunk-QEF7EK3T.js} +2 -2
- package/dist/{chunk-MM2Y43LC.js → chunk-RPQOBHVU.js} +2 -2
- package/dist/{chunk-3NYG4SGU.js → chunk-TXQ7L33K.js} +3 -3
- package/dist/{chunk-PWSJJXLQ.js → chunk-VMHUEOT5.js} +8 -8
- package/dist/{chunk-65ZHM5RH.js → chunk-VRPMYPZU.js} +9 -9
- package/dist/{cli-VYCQJZ5X.js → cli-MI4ZCAZ3.js} +9 -9
- package/dist/{cli-ZTCBSDW4.js → cli-ZN7ZVDEZ.js} +3 -3
- package/dist/cli.js +4 -4
- package/dist/{completion-E7RRG3ZT.js → completion-ILSRB3LW.js} +3 -3
- package/dist/{diagnostics-XXH4FLUG.js → diagnostics-XKXVVQWH.js} +6 -6
- package/dist/{doctor-ZIOESU3N.js → doctor-O2E63YGO.js} +13 -13
- package/dist/{entry-ZNFCTDVE.js → entry-X6CSYQRQ.js} +10 -10
- package/dist/{exec-mcp-X6372BLE.js → exec-mcp-2PMWBPD7.js} +8 -8
- package/dist/{harness-F2XFDYXF.js → harness-L2KSI2ZB.js} +5 -5
- package/dist/harness-launch-gate.js +4 -4
- package/dist/harness-worker.js +6 -6
- package/dist/hook-body.js +7 -6
- package/dist/{hooks-FYE2L5RW.js → hooks-BHTA44X7.js} +3 -3
- package/dist/{host-GRY3VAHH.js → host-UIZAXXQH.js} +7 -7
- package/dist/{host-X6BR6X4O.js → host-UWK754BW.js} +20 -10
- package/dist/{host-run-GCA6H6SR.js → host-run-BI2OTZDZ.js} +5 -5
- package/dist/http.js +1 -1
- package/dist/{import-mcp-2TTBPVLY.js → import-mcp-GPKJI7DI.js} +6 -6
- package/dist/index.d.ts +1 -1
- package/dist/index.js +13 -13
- package/dist/{init-627KFXTG.js → init-3C2Y7BNJ.js} +2 -2
- package/dist/{invoke-LW22Z6ET.js → invoke-44CJRVMK.js} +8 -8
- package/dist/{list-NGMSQ5SH.js → list-WL6L4J5H.js} +8 -8
- package/dist/{logout-6CSHUWWE.js → logout-F5EJ5MOU.js} +7 -7
- package/dist/{logs-SPB6AANY.js → logs-TBUA4UWU.js} +4 -4
- package/dist/{mailbox-7BV54Q4R.js → mailbox-BMTZOSZ7.js} +4 -4
- package/dist/{mainline-JQTTYJMI.js → mainline-KAD2ERLP.js} +2 -2
- package/dist/{mcp-2DKVU3SW.js → mcp-235QZN2A.js} +2 -2
- package/dist/{mcp-V23HC3LB.js → mcp-FJ2UQ4RH.js} +2 -2
- package/dist/{pause-FFAYRBWI.js → pause-7LILUVGL.js} +4 -4
- package/dist/{project-FY62G55N.js → project-5YV5CUEG.js} +4 -4
- package/dist/{resume-UU4HZIUP.js → resume-26VFAAMH.js} +4 -4
- package/dist/{run-OGA3P7FC.js → run-3AXTZSR7.js} +7 -7
- package/dist/{run-HALGEJNJ.js → run-3SOVRQIA.js} +4 -4
- package/dist/{serve-NBKT5BKY.js → serve-DQMKTFIV.js} +3 -3
- package/dist/{start-login-UIQYQBMC.js → start-login-YTZV6KMF.js} +7 -7
- package/dist/{status-NOOHW5WA.js → status-MROQ7WR7.js} +7 -7
- package/dist/{status-VHODZPXB.js → status-RO55QPKV.js} +4 -4
- package/dist/{status-XQANBVXW.js → status-UME2L33L.js} +11 -11
- package/dist/stdio.js +2 -2
- package/dist/{sweep-64JDCGK6.js → sweep-35LGQTTO.js} +4 -4
- package/dist/{test-MKAXFJOL.js → test-AGZOJLRZ.js} +7 -7
- package/dist/{tui-MWKAXE4K.js → tui-G5LLWCSV.js} +5 -5
- package/dist/{unbroadcast-KPUEFLZD.js → unbroadcast-5QNGAJR2.js} +4 -4
- package/dist/{validate-5GZ5YWNA.js → validate-IU52H2IC.js} +2 -2
- package/dist/{worker-RQ575EJL.js → worker-QZ5T6LJD.js} +8 -8
- package/docs/authoring.md +82 -0
- package/docs/browser-and-desktop.md +46 -0
- package/docs/commands.md +325 -0
- package/docs/compare.md +35 -0
- package/docs/compatibility.md +55 -0
- package/docs/embeddings.md +1 -1
- package/docs/getting-started.md +105 -0
- package/docs/git-workflow.md +60 -0
- package/docs/glossary.md +31 -0
- package/docs/hooks.md +264 -0
- package/docs/install.md +72 -0
- package/docs/library-skills.md +132 -0
- package/docs/mailbox.md +16 -5
- package/docs/project-configuration.md +51 -386
- package/docs/sessions.md +64 -0
- package/docs/skills.md +4 -45
- package/docs/terminal-harness.md +26 -21
- package/docs/terminal-workspace.md +4 -13
- package/gemini-extension.json +2 -2
- package/mcp.json +1 -1
- package/package.json +8 -6
- package/plugin.json +2 -2
- package/plugins/pmcp/.claude-plugin/plugin.json +2 -2
- package/plugins/pmcp/.mcp.json +1 -1
- package/plugins/pmcp/gemini-extension.json +2 -2
- package/plugins/pmcp/mcp.json +1 -1
- package/plugins/pmcp/mod/sessions/types.ts +1 -1
- package/plugins/pmcp/plugin.json +2 -2
- package/plugins/pmcp/skills/headless-agents-ci-scaffold/SKILL.md +12 -11
- package/plugins/pmcp/skills/package-skill-catalog/SKILL.md +0 -4
- package/plugins/pmcp/skills/pmcp-browser/SKILL.md +27 -0
- package/plugins/pmcp/skills/pmcp-desktop/SKILL.md +25 -0
- package/plugins/pmcp/skills/pmcp-project-init/SKILL.md +19 -11
- package/plugins/pmcp/skills/pmcp-sessions-and-git/SKILL.md +20 -28
- package/plugins/pmcp/skills/skill-package-scaffold/SKILL.md +4 -3
- package/schema/catalog-v1.json +36 -7
- package/schema/library.json +40 -8
- package/schema/marketplace-manifest.json +19 -5
- package/schema/plugin-manifest.json +6 -2
- package/schema/skill-frontmatter.json +33 -7
- package/schema/skill-metadata-core.json +26 -5
- package/skills/headless-agents-ci-scaffold/SKILL.md +12 -11
- package/skills/package-skill-catalog/SKILL.md +0 -4
- package/skills/pmcp-browser/SKILL.md +27 -0
- package/skills/pmcp-desktop/SKILL.md +25 -0
- package/skills/pmcp-project-init/SKILL.md +19 -11
- package/skills/pmcp-sessions-and-git/SKILL.md +20 -28
- package/skills/skill-package-scaffold/SKILL.md +4 -3
- package/dist/chunk-E7OOHLQR.js +0 -7
- package/docs/manual-library-skills.md +0 -74
package/README.md
CHANGED
|
@@ -3,112 +3,83 @@
|
|
|
3
3
|
Use the skills your packages already ship, and keep your AI tools' project
|
|
4
4
|
configuration in one place.
|
|
5
5
|
|
|
6
|
-
pmcp
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
|
16
|
-
|
|
|
17
|
-
|
|
|
18
|
-
| Install
|
|
19
|
-
|
|
|
20
|
-
|
|
|
21
|
-
|
|
|
22
|
-
|
|
|
23
|
-
|
|
|
24
|
-
|
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
## Get started
|
|
6
|
+
pmcp is for repositories where people work with AI coding tools such as Claude
|
|
7
|
+
Code, Codex, Gemini CLI, Grok Build, Antigravity and opencode. It finds the
|
|
8
|
+
`SKILL.md` instructions your installed packages and marketplaces carry and lets
|
|
9
|
+
the tool load one when a task needs it, and it writes each tool's native
|
|
10
|
+
configuration from one `pmcp.toml`. The tools keep their own model calls,
|
|
11
|
+
logins and permission controls.
|
|
12
|
+
|
|
13
|
+
| What you want to do | Use | Part |
|
|
14
|
+
| --------------------------------------------------------- | ------------------------------ | -------- |
|
|
15
|
+
| Find and read the skills your packages ship | the MCP skill catalog | core |
|
|
16
|
+
| Keep several tools' MCP servers, skills and rules in sync | `pmcp.toml` and `pmcp project` | core |
|
|
17
|
+
| Check what each installed tool actually loads | `pmcp doctor` | core |
|
|
18
|
+
| Install free library instructions as native plugins | the public marketplace | optional |
|
|
19
|
+
| Stop agents from running risky commands | `[hooks]` guards | optional |
|
|
20
|
+
| Run several agents in one repository without collisions | `pmcp sessions`, `pmcp git` | optional |
|
|
21
|
+
| Watch and steer native agent terminals (Linux, macOS) | `pmcp tui`, `pmcp harness` | optional |
|
|
22
|
+
| Give agents a browser or a desktop on a Linux server | pmcp-browser, pmcp-desktop | optional |
|
|
23
|
+
| Search skills in any language with a local model | `pmcp models`, `pmcp index` | optional |
|
|
24
|
+
| Serve a catalog or a mailbox from your own application | the HTTP and mailbox libraries | optional |
|
|
25
|
+
|
|
26
|
+
## Install and connect
|
|
28
27
|
|
|
29
28
|
Requires Node.js 22 or later, or Bun 1.3 or later.
|
|
30
29
|
|
|
31
|
-
Install pmcp in your project:
|
|
32
|
-
|
|
33
30
|
```sh
|
|
34
31
|
npm install --save-dev @modootoday/pmcp
|
|
35
|
-
```
|
|
36
|
-
|
|
37
|
-
For Claude Code, register the MCP server from the project directory:
|
|
38
|
-
|
|
39
|
-
```sh
|
|
40
32
|
claude mcp add pmcp -- npx @modootoday/pmcp serve
|
|
41
33
|
```
|
|
42
34
|
|
|
43
|
-
Other MCP hosts
|
|
35
|
+
Other MCP hosts take a stdio entry:
|
|
44
36
|
|
|
45
37
|
```json
|
|
46
38
|
{
|
|
47
39
|
"mcpServers": {
|
|
48
|
-
"pmcp": {
|
|
49
|
-
"command": "npx",
|
|
50
|
-
"args": ["@modootoday/pmcp", "serve"]
|
|
51
|
-
}
|
|
40
|
+
"pmcp": { "command": "npx", "args": ["@modootoday/pmcp", "serve"] }
|
|
52
41
|
}
|
|
53
42
|
}
|
|
54
43
|
```
|
|
55
44
|
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
Local skill discovery and reading require no pmcp login.
|
|
45
|
+
Reconnect your tool's MCP servers after changing the configuration. Reading
|
|
46
|
+
local skills needs no pmcp account.
|
|
59
47
|
|
|
60
|
-
##
|
|
48
|
+
## Find your first skill
|
|
61
49
|
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
For example, install the TypeScript 5 instructions with your native manager:
|
|
50
|
+
`pmcp list` shows what the server sees from here: one row per skill, with the
|
|
51
|
+
name and the description the search ranks.
|
|
65
52
|
|
|
66
53
|
```sh
|
|
67
|
-
|
|
68
|
-
claude plugin install typescript-5@pmcp
|
|
69
|
-
claude plugin install pmcp@pmcp
|
|
54
|
+
npx @modootoday/pmcp list
|
|
70
55
|
```
|
|
71
56
|
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
57
|
+
Then ask your tool for help with a task in a full sentence. It calls
|
|
58
|
+
`skill_find`, which returns matching skill names without their bodies, and
|
|
59
|
+
`skill_call` for the one it picks. An empty catalog exits 1 and names the
|
|
60
|
+
directories it searched. [Getting started](docs/getting-started.md) walks
|
|
61
|
+
through the search and the options.
|
|
77
62
|
|
|
78
|
-
|
|
79
|
-
and `grok plugin install typescript-5@pmcp`. The separate `pmcp` plugin adds the
|
|
80
|
-
PMCP MCP bridge. Gemini can install that bridge with
|
|
81
|
-
`gemini extensions install https://github.com/modootoday/pmcp`.
|
|
82
|
-
Native confirmation and runtime provider login remain with each tool.
|
|
63
|
+
## Free library skills as native plugins
|
|
83
64
|
|
|
84
|
-
|
|
85
|
-
|
|
65
|
+
This repository is also a plugin marketplace. Install the library major lines
|
|
66
|
+
you use, one at a time:
|
|
86
67
|
|
|
87
68
|
```sh
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
```
|
|
92
|
-
|
|
93
|
-
The marketplace export command, bundled catalog and anonymous `install` provider
|
|
94
|
-
are included in npm 0.14.0. GitHub native marketplace installation and the
|
|
95
|
-
website's free archives are available independently. See the [skills guide](docs/skills.md) for layouts,
|
|
96
|
-
runtime-specific formats and version selection.
|
|
97
|
-
|
|
98
|
-
To include your workspace's own skills, create `pmcp.toml` at the project root:
|
|
99
|
-
|
|
100
|
-
```toml
|
|
101
|
-
[catalog]
|
|
102
|
-
workspaces = ["."]
|
|
69
|
+
claude plugin marketplace add modootoday/pmcp
|
|
70
|
+
claude plugin install typescript-5@pmcp
|
|
71
|
+
claude plugin install pmcp@pmcp
|
|
103
72
|
```
|
|
104
73
|
|
|
105
|
-
|
|
106
|
-
|
|
74
|
+
Codex (`codex plugin add`) and Grok (`grok plugin install`) take the same
|
|
75
|
+
names; Gemini installs the `pmcp` bridge with
|
|
76
|
+
`gemini extensions install https://github.com/modootoday/pmcp`, and
|
|
77
|
+
`pmcp marketplace export` writes a plugin for Antigravity. The
|
|
78
|
+
[skills reference](docs/skills.md) covers formats and versions; the
|
|
79
|
+
[library skills](docs/library-skills.md) page also covers Python, Rust and Go.
|
|
107
80
|
|
|
108
81
|
## Share configuration across your tools
|
|
109
82
|
|
|
110
|
-
Declare your tools and MCP servers in the same `pmcp.toml`:
|
|
111
|
-
|
|
112
83
|
```toml
|
|
113
84
|
[targets]
|
|
114
85
|
tools = ["claude", "codex", "gemini", "grok", "antigravity", "opencode"]
|
|
@@ -117,151 +88,72 @@ tools = ["claude", "codex", "gemini", "grok", "antigravity", "opencode"]
|
|
|
117
88
|
url = "https://example.com/mcp"
|
|
118
89
|
```
|
|
119
90
|
|
|
120
|
-
Replace the example URL with your server, then run:
|
|
121
|
-
|
|
122
91
|
```sh
|
|
123
|
-
npx @modootoday/pmcp
|
|
124
|
-
npx @modootoday/pmcp project
|
|
125
|
-
npx @modootoday/pmcp doctor
|
|
92
|
+
npx @modootoday/pmcp init # or write pmcp.toml yourself
|
|
93
|
+
npx @modootoday/pmcp project # write each tool's native files
|
|
94
|
+
npx @modootoday/pmcp doctor # ask each tool what it loads
|
|
126
95
|
```
|
|
127
96
|
|
|
128
|
-
`project`
|
|
129
|
-
in `pmcp.lock
|
|
130
|
-
|
|
131
|
-
own OAuth session.
|
|
132
|
-
|
|
133
|
-
OpenCode receives project MCP configuration in `opencode.json` and reads
|
|
134
|
-
`.agents/skills` directly. User-only skills stay available through native
|
|
135
|
-
slash commands while being hidden from automatic skill selection. Its provider
|
|
136
|
-
and model choices stay in native user configuration. OpenCode mailbox, terminal
|
|
137
|
-
control and hook enforcement are outside this projection's supported scope.
|
|
138
|
-
|
|
139
|
-
The [configuration guide](docs/project-configuration.md) covers importing
|
|
140
|
-
existing servers, environment references, shared skills and rules, shell guards
|
|
141
|
-
and memory metadata.
|
|
142
|
-
|
|
143
|
-
## Manage native terminals
|
|
144
|
-
|
|
145
|
-
PMCP 0.13.0 or later can show a native main runtime, its worker terminals and a
|
|
146
|
-
coordination panel in one terminal workspace. PMCP 0.18.0 and later run it on
|
|
147
|
-
pmcp-pty (`crates/pmcp-pty`), a PTY host, and draw it with pmcp-tui
|
|
148
|
-
(`crates/pmcp-tui`); earlier releases used tmux. The optional harness and TUI
|
|
149
|
-
need Linux (glibc 2.35 or later) or macOS, Node.js 22 or later, and on Linux a
|
|
150
|
-
working user systemd manager; npm installs pmcp-pty and pmcp-tui with PMCP.
|
|
151
|
-
Windows is not supported yet. Provider login, folder trust and tool approvals
|
|
152
|
-
remain native; an operator-approved `[host]` may answer the tool dialogs it
|
|
153
|
-
lists, and never login, auth or trust prompts (see
|
|
154
|
-
[Sessions pmcp-pty hosts](docs/project-configuration.md#sessions-pmcp-pty-hosts)).
|
|
155
|
-
|
|
156
|
-
See the [changelog](CHANGELOG.md) for what changed in 0.18.0, including the
|
|
157
|
-
removal of tmux.
|
|
158
|
-
|
|
159
|
-
```sh
|
|
160
|
-
npx @modootoday/pmcp --version
|
|
161
|
-
npx @modootoday/pmcp harness doctor inspect
|
|
162
|
-
npx @modootoday/pmcp tui doctor
|
|
163
|
-
```
|
|
97
|
+
`project` preserves settings it did not write, refuses conflicting ones and
|
|
98
|
+
records what it owns in `pmcp.lock`; `--check` reports drift without writing.
|
|
99
|
+
The [pmcp.toml reference](docs/project-configuration.md) covers every table.
|
|
164
100
|
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
```sh
|
|
168
|
-
pmcp
|
|
169
|
-
```
|
|
170
|
-
|
|
171
|
-
The first launch lists installed native runtimes. Choose a number or accept the
|
|
172
|
-
default, then confirm the start; q cancels without creating a group. No group JSON is
|
|
173
|
-
required. Later launches reconnect to the workspace
|
|
174
|
-
created for this project. Native login and folder trust stay with the runtime.
|
|
175
|
-
Use `pmcp tui --runtime codex-cli` to choose the main, or set an optional default:
|
|
176
|
-
|
|
177
|
-
```toml
|
|
178
|
-
[tui]
|
|
179
|
-
runtime = "codex-cli"
|
|
180
|
-
```
|
|
101
|
+
## Guard commands and run several agents
|
|
181
102
|
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
103
|
+
`[hooks]` compiles guards (heredocs, `git add -A`, pushes that skip checks,
|
|
104
|
+
credential reads and more) into one hook bundle every targeted tool runs. With
|
|
105
|
+
sessions and the git workflow on, agents see each other, wait on shared files,
|
|
106
|
+
work in linked worktrees and deliver through one gate instead of pushing.
|
|
107
|
+
[Run several agents in one repository](docs/sessions.md) shows how.
|
|
187
108
|
|
|
188
|
-
|
|
189
|
-
[terminal workspace guide](docs/terminal-workspace.md) covers defaults, custom
|
|
190
|
-
configuration and advanced controls. The [native terminal guide](docs/terminal-harness.md)
|
|
191
|
-
explains explicit group and session operations.
|
|
192
|
-
The workspace starts read only; taking control (Ctrl-g then c) and stopping a
|
|
193
|
-
runtime are explicit actions. This optional CLI feature does not add execution tools to the MCP server.
|
|
109
|
+
## Watch and steer agent terminals
|
|
194
110
|
|
|
195
|
-
|
|
111
|
+
On Linux or macOS, `pmcp` opens a terminal workspace: a native main session, a
|
|
112
|
+
dock of workers and a coordination panel, read only until you take control.
|
|
113
|
+
npm installs the terminal host (pmcp-pty) and the workspace (pmcp-tui) with
|
|
114
|
+
pmcp. Login, folder trust and tool approvals stay in each tool. See the
|
|
115
|
+
[terminal workspace](docs/terminal-workspace.md) and
|
|
116
|
+
[native terminal control](docs/terminal-harness.md) guides.
|
|
196
117
|
|
|
197
|
-
|
|
118
|
+
## Commands
|
|
198
119
|
|
|
199
120
|
```sh
|
|
200
|
-
pmcp list
|
|
201
|
-
pmcp available
|
|
121
|
+
pmcp list # skills the server sees
|
|
122
|
+
pmcp available # catalog skill packages that match your dependencies
|
|
202
123
|
pmcp install --all --dry-run
|
|
203
|
-
pmcp
|
|
204
|
-
pmcp
|
|
205
|
-
pmcp
|
|
124
|
+
pmcp validate # check skill documents
|
|
125
|
+
pmcp status # features, drift, live sessions
|
|
126
|
+
pmcp --help
|
|
206
127
|
```
|
|
207
128
|
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
skills.
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
|
231
|
-
|
|
|
232
|
-
|
|
|
233
|
-
| Optional terminal workspace | Linux pmcp-pty checks and a native Claude main with a Gemini worker (control, input, wake turns, recovery); other runtimes measured on tmux in 0.17 |
|
|
234
|
-
| Public skill installation | npm, Bun and pnpm 10.17.1; confirmation required, scripts disabled |
|
|
235
|
-
| Native plugin export | Claude, Codex, Gemini, Grok and agy formats; export does not install or activate a vendor plugin |
|
|
236
|
-
| pnpm workspace installation | Selects the member, preserves root dependencies and updates the shared lockfile |
|
|
237
|
-
| Yarn skill installation | Refused without changing project files; Yarn PnP is not supported |
|
|
238
|
-
| macOS, Windows and other architectures | Not qualified by the Linux Docker tests; macOS terminal binaries ship unsigned, Windows is not supported yet |
|
|
239
|
-
|
|
240
|
-
Provider authentication, native children and vendor behavior have separate
|
|
241
|
-
qualification scopes. An installed executable or exported manifest is not proof
|
|
242
|
-
that every native feature works. The packed-package check, run before a
|
|
243
|
-
release, covers actual archive installation, CLI startup, MCP and SQLite; isolated projects
|
|
244
|
-
on a host are distinct from Docker and OS qualification.
|
|
245
|
-
|
|
246
|
-
## Guides
|
|
247
|
-
|
|
248
|
-
| Guide | Contents |
|
|
249
|
-
| ------------------------------------------------------ | ------------------------------------------------------------- |
|
|
250
|
-
| [Project configuration](docs/project-configuration.md) | Catalog sources, native files, MCP import, guards and doctor |
|
|
251
|
-
| [Skills and MCP reference](docs/skills.md) | Skill documents, tools, resources, prompts and compatibility |
|
|
252
|
-
| [Embedding models](docs/embeddings.md) | E5, EmbeddingGemma and custom local model selection |
|
|
253
|
-
| [Local mailbox](docs/mailbox.md) | Actor credentials, messages, receipts and library integration |
|
|
254
|
-
| [HTTP hosting](docs/hosting.md) | Authentication, catalog access and request controls |
|
|
255
|
-
| [Native terminal control](docs/terminal-harness.md) | Owned sessions, explicit input, Docker profiles and recovery |
|
|
256
|
-
| [Terminal workspace](docs/terminal-workspace.md) | Main and worker panels, observation, control and failures |
|
|
257
|
-
| [Security policy](SECURITY.md) | Reporting vulnerabilities |
|
|
258
|
-
|
|
259
|
-
Semantic search is optional and requires `@huggingface/transformers` installed
|
|
260
|
-
separately. Lexical search works without downloading a model. The mailbox is
|
|
261
|
-
disabled until explicitly configured.
|
|
129
|
+
The [command reference](docs/commands.md) lists every command, flag and exit
|
|
130
|
+
code.
|
|
131
|
+
|
|
132
|
+
## Documentation
|
|
133
|
+
|
|
134
|
+
| Page | For |
|
|
135
|
+
| -------------------------------------------------------- | ----------------------------------------------------------- |
|
|
136
|
+
| [Getting started](docs/getting-started.md) | connecting a tool and finding skills |
|
|
137
|
+
| [pmcp.toml reference](docs/project-configuration.md) | every `pmcp.toml` table with its keys and defaults |
|
|
138
|
+
| [Hooks](docs/hooks.md) | guards and checks, and which runtime supports what |
|
|
139
|
+
| [Git workflow](docs/git-workflow.md) | linked worktrees, delivery and sync |
|
|
140
|
+
| [Browser and desktop](docs/browser-and-desktop.md) | pmcp-browser and pmcp-desktop for agents |
|
|
141
|
+
| [Library skills](docs/library-skills.md) | free library instructions as plugins, npm packages or files |
|
|
142
|
+
| [Run several agents](docs/sessions.md) | sessions, messages, leases, worktrees and delivery |
|
|
143
|
+
| [Skills and MCP reference](docs/skills.md) | skill layouts, tools, resources and the marketplace |
|
|
144
|
+
| [Terminal workspace](docs/terminal-workspace.md) | the `pmcp tui` workspace |
|
|
145
|
+
| [Native terminal control](docs/terminal-harness.md) | harness groups, control, recovery and `[host]` |
|
|
146
|
+
| [Embedding models](docs/embeddings.md) | semantic search with a local model |
|
|
147
|
+
| [Local mailbox](docs/mailbox.md) | messages between actors with their own credentials |
|
|
148
|
+
| [HTTP hosting](docs/hosting.md) | serving a catalog from your application |
|
|
149
|
+
| [Command reference](docs/commands.md) | commands, flags and exit codes |
|
|
150
|
+
| [Compatibility](docs/compatibility.md) | platforms, runtimes and qualification |
|
|
151
|
+
| [Glossary](docs/glossary.md) | the terms these pages use |
|
|
152
|
+
| [Changelog](CHANGELOG.md) | what changed, and how to upgrade |
|
|
153
|
+
| [Contributing](CONTRIBUTING.md), [Security](SECURITY.md) | working on pmcp, reporting a vulnerability |
|
|
262
154
|
|
|
263
155
|
## Licence
|
|
264
156
|
|
|
265
|
-
pmcp is source available under [Elastic License 2.0](LICENSE).
|
|
266
|
-
|
|
157
|
+
pmcp is source available under [Elastic License 2.0](LICENSE). See
|
|
158
|
+
[NOTICE](NOTICE) for dependency notices and the embedding guide for model
|
|
267
159
|
licences. Website: [pmcp.build](https://pmcp.build).
|
package/SECURITY.md
CHANGED
|
@@ -15,7 +15,7 @@ It must not send dependency inventories or search queries over the network.
|
|
|
15
15
|
Network access belongs to explicit CLI commands such as catalog retrieval,
|
|
16
16
|
authentication, installation, and synchronization.
|
|
17
17
|
|
|
18
|
-
Package installation changes a project manifest and lockfile through npm or
|
|
18
|
+
Package installation changes a project manifest and lockfile through npm, Bun or pnpm.
|
|
19
19
|
Inspect the plan with `--dry-run`; non-interactive application requires `--yes`.
|
|
20
20
|
The CLI disables dependency install scripts for skill-package installation and
|
|
21
21
|
checks catalog integrity against registry metadata before applying a plan.
|
|
@@ -25,6 +25,22 @@ The server returns skill files as text or base64 and never runs them. An MCP con
|
|
|
25
25
|
refuses browser origins it was not given, and caps request size; host names and a
|
|
26
26
|
per-caller rate limit are options. Authentication and call records belong to the host.
|
|
27
27
|
|
|
28
|
+
The optional parts that act on your machine run as your own user:
|
|
29
|
+
|
|
30
|
+
- The [hook bundle](docs/hooks.md) refuses risky commands and edits for the runtimes it
|
|
31
|
+
targets. Guards fail closed; a bundle that cannot load fails open. It stops accidents and
|
|
32
|
+
agents that were told to do something unsafe; it does not replace the runtime's own sandbox.
|
|
33
|
+
- [pmcp-browser](docs/browser-and-desktop.md) sends every request through its own proxy,
|
|
34
|
+
which refuses loopback, private, link-local, metadata and CGNAT addresses and ports other
|
|
35
|
+
than 80 and 443, and starts each Chromium with a fresh profile. Page content reaches the
|
|
36
|
+
agent as data, not instructions.
|
|
37
|
+
- [pmcp-desktop](docs/browser-and-desktop.md) launches only the apps an approved policy
|
|
38
|
+
lists, never a browser.
|
|
39
|
+
- A [`[host]` policy](docs/project-configuration.md#sessions-pmcp-pty-hosts) takes effect
|
|
40
|
+
only after you approve it in your own terminal, and login, auth, trust and hook-review
|
|
41
|
+
dialogs are never answered. The approval check stops accidents, not a process running as
|
|
42
|
+
you, which can write the approvals directory; that guide says what a real boundary needs.
|
|
43
|
+
|
|
28
44
|
## Supported versions
|
|
29
45
|
|
|
30
46
|
Security fixes are released on the latest published version. Include the pmcp
|
|
@@ -1,22 +1,22 @@
|
|
|
1
1
|
import {
|
|
2
2
|
specFrom
|
|
3
|
-
} from "./chunk-
|
|
3
|
+
} from "./chunk-FENOGX3U.js";
|
|
4
4
|
import {
|
|
5
5
|
catalogFrom
|
|
6
6
|
} from "./chunk-5QQWS4US.js";
|
|
7
7
|
import "./chunk-7DLZC73N.js";
|
|
8
8
|
import {
|
|
9
9
|
project
|
|
10
|
-
} from "./chunk-
|
|
10
|
+
} from "./chunk-I2ZP2PSA.js";
|
|
11
11
|
import "./chunk-P4N7DBD5.js";
|
|
12
12
|
import {
|
|
13
13
|
renderFrontmatter,
|
|
14
14
|
splitFrontmatter
|
|
15
|
-
} from "./chunk-
|
|
16
|
-
import "./chunk-
|
|
15
|
+
} from "./chunk-A7VF7A35.js";
|
|
16
|
+
import "./chunk-F5QYZK7E.js";
|
|
17
17
|
import {
|
|
18
18
|
RUNTIMES
|
|
19
|
-
} from "./chunk-
|
|
19
|
+
} from "./chunk-VRPMYPZU.js";
|
|
20
20
|
import "./chunk-HQOB7OQS.js";
|
|
21
21
|
import "./chunk-S3PIAMXV.js";
|
|
22
22
|
import "./chunk-JS5RTH4I.js";
|
|
@@ -29,8 +29,8 @@ import {
|
|
|
29
29
|
ProjectError
|
|
30
30
|
} from "./chunk-NRBQK6UX.js";
|
|
31
31
|
import "./chunk-3PW4FI7U.js";
|
|
32
|
-
import "./chunk-
|
|
33
|
-
import "./chunk-
|
|
32
|
+
import "./chunk-26WLNWDG.js";
|
|
33
|
+
import "./chunk-LTZH5E3G.js";
|
|
34
34
|
import "./chunk-C4NHQGHL.js";
|
|
35
35
|
import "./chunk-Q5H3L6Y4.js";
|
|
36
36
|
import "./chunk-73AKO4UL.js";
|
|
@@ -41,13 +41,13 @@ import {
|
|
|
41
41
|
kindOf
|
|
42
42
|
} from "./chunk-KMXRRSKT.js";
|
|
43
43
|
import "./chunk-YSAWTGNA.js";
|
|
44
|
-
import "./chunk-
|
|
44
|
+
import "./chunk-DMZHQZ7P.js";
|
|
45
45
|
import {
|
|
46
46
|
recordProjector
|
|
47
|
-
} from "./chunk-
|
|
47
|
+
} from "./chunk-7HFIGCSL.js";
|
|
48
48
|
import "./chunk-OEH47H6A.js";
|
|
49
49
|
import "./chunk-IJBSOWHK.js";
|
|
50
|
-
import "./chunk-
|
|
50
|
+
import "./chunk-65KAQSJP.js";
|
|
51
51
|
import "./chunk-QPL7E2HW.js";
|
|
52
52
|
import "./chunk-PMJG2CXF.js";
|
|
53
53
|
|
|
@@ -239,4 +239,4 @@ export {
|
|
|
239
239
|
projectOrCheck,
|
|
240
240
|
removeAndProject
|
|
241
241
|
};
|
|
242
|
-
//# sourceMappingURL=apply-
|
|
242
|
+
//# sourceMappingURL=apply-JUTGS5WZ.js.map
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
import {
|
|
2
2
|
change
|
|
3
|
-
} from "./chunk-
|
|
4
|
-
import "./chunk-
|
|
5
|
-
import "./chunk-
|
|
3
|
+
} from "./chunk-LBXO4VPG.js";
|
|
4
|
+
import "./chunk-26WLNWDG.js";
|
|
5
|
+
import "./chunk-LTZH5E3G.js";
|
|
6
6
|
import "./chunk-C4NHQGHL.js";
|
|
7
7
|
import "./chunk-A4PKLESO.js";
|
|
8
8
|
import "./chunk-OEH47H6A.js";
|
|
@@ -15,4 +15,4 @@ var run = (context) => change(context, "broadcast");
|
|
|
15
15
|
export {
|
|
16
16
|
run
|
|
17
17
|
};
|
|
18
|
-
//# sourceMappingURL=broadcast-
|
|
18
|
+
//# sourceMappingURL=broadcast-CBMVOV3G.js.map
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import {
|
|
2
2
|
createFilesStore
|
|
3
|
-
} from "./chunk-
|
|
3
|
+
} from "./chunk-LTZH5E3G.js";
|
|
4
4
|
import {
|
|
5
5
|
projectStateDir
|
|
6
6
|
} from "./chunk-OEH47H6A.js";
|
|
@@ -90,4 +90,4 @@ export {
|
|
|
90
90
|
readStoreSettings,
|
|
91
91
|
openStore
|
|
92
92
|
};
|
|
93
|
-
//# sourceMappingURL=chunk-
|
|
93
|
+
//# sourceMappingURL=chunk-26WLNWDG.js.map
|
|
@@ -7,20 +7,20 @@ import {
|
|
|
7
7
|
observeSession,
|
|
8
8
|
openGroup,
|
|
9
9
|
runOperation
|
|
10
|
-
} from "./chunk-
|
|
10
|
+
} from "./chunk-3IDXEV5E.js";
|
|
11
11
|
import {
|
|
12
12
|
nativeHostTools
|
|
13
|
-
} from "./chunk-
|
|
13
|
+
} from "./chunk-LW4TG7EL.js";
|
|
14
14
|
import {
|
|
15
15
|
locateExecutable
|
|
16
16
|
} from "./chunk-R2GPCZUX.js";
|
|
17
17
|
import {
|
|
18
18
|
artifact,
|
|
19
19
|
stateDirectory
|
|
20
|
-
} from "./chunk-
|
|
20
|
+
} from "./chunk-7UCZAN4J.js";
|
|
21
21
|
import {
|
|
22
22
|
ptyBinary
|
|
23
|
-
} from "./chunk-
|
|
23
|
+
} from "./chunk-DMZHQZ7P.js";
|
|
24
24
|
import {
|
|
25
25
|
GroupStore,
|
|
26
26
|
privateJson
|
|
@@ -249,4 +249,4 @@ async function invoke(operation) {
|
|
|
249
249
|
export {
|
|
250
250
|
invoke
|
|
251
251
|
};
|
|
252
|
-
//# sourceMappingURL=chunk-
|
|
252
|
+
//# sourceMappingURL=chunk-2FIV63WC.js.map
|
|
@@ -5,7 +5,7 @@ import {
|
|
|
5
5
|
POLICIES,
|
|
6
6
|
RUNTIMES,
|
|
7
7
|
customPolicy
|
|
8
|
-
} from "./chunk-
|
|
8
|
+
} from "./chunk-VRPMYPZU.js";
|
|
9
9
|
|
|
10
10
|
// src/hooks/inspection/list.ts
|
|
11
11
|
function policyRows(compiled) {
|
|
@@ -39,4 +39,4 @@ function policyRows(compiled) {
|
|
|
39
39
|
export {
|
|
40
40
|
policyRows
|
|
41
41
|
};
|
|
42
|
-
//# sourceMappingURL=chunk-
|
|
42
|
+
//# sourceMappingURL=chunk-3FCFAQDG.js.map
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import {
|
|
2
2
|
assertNativeHost
|
|
3
|
-
} from "./chunk-
|
|
3
|
+
} from "./chunk-LW4TG7EL.js";
|
|
4
4
|
import {
|
|
5
5
|
locateExecutable
|
|
6
6
|
} from "./chunk-R2GPCZUX.js";
|
|
@@ -33,7 +33,7 @@ import {
|
|
|
33
33
|
resourceClaim,
|
|
34
34
|
resourceRunning,
|
|
35
35
|
runtimeUnit
|
|
36
|
-
} from "./chunk-
|
|
36
|
+
} from "./chunk-7UCZAN4J.js";
|
|
37
37
|
import {
|
|
38
38
|
command
|
|
39
39
|
} from "./chunk-34DECPVC.js";
|
|
@@ -1931,4 +1931,4 @@ export {
|
|
|
1931
1931
|
isReadOnly,
|
|
1932
1932
|
runOperation
|
|
1933
1933
|
};
|
|
1934
|
-
//# sourceMappingURL=chunk-
|
|
1934
|
+
//# sourceMappingURL=chunk-3IDXEV5E.js.map
|
|
@@ -3,7 +3,7 @@ import {
|
|
|
3
3
|
} from "./chunk-OEH47H6A.js";
|
|
4
4
|
import {
|
|
5
5
|
VERSION
|
|
6
|
-
} from "./chunk-
|
|
6
|
+
} from "./chunk-65KAQSJP.js";
|
|
7
7
|
import {
|
|
8
8
|
ConfigError
|
|
9
9
|
} from "./chunk-QPL7E2HW.js";
|
|
@@ -416,4 +416,4 @@ export {
|
|
|
416
416
|
writeLock,
|
|
417
417
|
readHost
|
|
418
418
|
};
|
|
419
|
-
//# sourceMappingURL=chunk-
|
|
419
|
+
//# sourceMappingURL=chunk-7HFIGCSL.js.map
|
|
@@ -3,7 +3,7 @@ import {
|
|
|
3
3
|
} from "./chunk-34DECPVC.js";
|
|
4
4
|
import {
|
|
5
5
|
ptyBinary
|
|
6
|
-
} from "./chunk-
|
|
6
|
+
} from "./chunk-DMZHQZ7P.js";
|
|
7
7
|
import {
|
|
8
8
|
GroupStore,
|
|
9
9
|
egressPolicy,
|
|
@@ -775,4 +775,4 @@ export {
|
|
|
775
775
|
prepareBridge,
|
|
776
776
|
assertBridge
|
|
777
777
|
};
|
|
778
|
-
//# sourceMappingURL=chunk-
|
|
778
|
+
//# sourceMappingURL=chunk-7UCZAN4J.js.map
|