@modootoday/pmcp 0.18.0 → 0.18.3
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/CONTRIBUTING.md +80 -0
- package/README.md +100 -206
- package/SECURITY.md +17 -1
- package/dist/{apply-4IGTXOCQ.js → apply-S2QI72W3.js} +13 -13
- package/dist/{available-DBSIVVJ6.js → available-GFMTJW4E.js} +3 -3
- package/dist/{broadcast-3RY3OZGY.js → broadcast-CBMVOV3G.js} +4 -4
- package/dist/{chunk-SG5TPMKH.js → chunk-26WLNWDG.js} +2 -2
- package/dist/{chunk-4VCC2NXE.js → chunk-2RTRY45B.js} +2 -2
- package/dist/{chunk-3NYG4SGU.js → chunk-3MEYKFFO.js} +3 -3
- package/dist/{chunk-KMXRRSKT.js → chunk-4CRRLDDS.js} +1 -1
- package/dist/{chunk-ZH6R642Z.js → chunk-4GSGT55G.js} +2 -2
- package/dist/{chunk-EJBZGIDK.js → chunk-6BN35BHI.js} +3 -3
- package/dist/{chunk-T3LKX23M.js → chunk-7B6IC3F7.js} +3 -3
- package/dist/{chunk-25GHX674.js → chunk-7DEYLLIE.js} +9 -9
- package/dist/{chunk-ELAGZ635.js → chunk-7PTG42QU.js} +5 -5
- package/dist/chunk-AF2IBMWN.js +7 -0
- package/dist/{chunk-IGYRMM62.js → chunk-CKTN6LKP.js} +2 -2
- package/dist/{chunk-PLX3BOOS.js → chunk-E5XVSMBR.js} +2 -2
- package/dist/{chunk-Q65R3XKX.js → chunk-EAWPJHJ7.js} +2 -2
- package/dist/{chunk-7BLPN3W6.js → chunk-F5LEGPGP.js} +2 -2
- package/dist/{chunk-BBTBJCFA.js → chunk-F5WBMUOT.js} +2 -2
- package/dist/{chunk-YMHUM7AV.js → chunk-F5XMGOOX.js} +7 -1
- package/dist/{chunk-R4L6LJJ2.js → chunk-FX3LTTMB.js} +2 -2
- package/dist/{chunk-5QQWS4US.js → chunk-HEBCQTOD.js} +2 -2
- package/dist/{chunk-NZS5CD72.js → chunk-HEWZ6INU.js} +21 -5
- package/dist/{chunk-MWFOUBFC.js → chunk-HFE4QDJQ.js} +2 -2
- package/dist/{chunk-N5AQ3PP7.js → chunk-HQWVGU3W.js} +5 -5
- package/dist/{chunk-UOCLRM7P.js → chunk-IIBB37JE.js} +22 -22
- package/dist/{chunk-MPSQXSC6.js → chunk-ISZOLR3D.js} +5 -3
- package/dist/{chunk-J6QLLQVL.js → chunk-JM2KR2WJ.js} +5 -5
- package/dist/{chunk-CJTKR6K6.js → chunk-JZK7ZO7K.js} +2 -2
- 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-MM2Y43LC.js → chunk-M455QSCW.js} +3 -3
- package/dist/{chunk-7GBYECSK.js → chunk-NLHLA2N5.js} +3 -3
- package/dist/{chunk-HDMBVLCZ.js → chunk-NWOV2E26.js} +2 -2
- package/dist/{chunk-PWSJJXLQ.js → chunk-QK4G7FCU.js} +8 -8
- package/dist/{chunk-47O3X4VS.js → chunk-QRCAGKC6.js} +1 -1
- package/dist/{chunk-665TA55Z.js → chunk-TAOOPXBV.js} +2 -2
- package/dist/{chunk-JUXNIXN4.js → chunk-TZORR6GZ.js} +2 -2
- package/dist/{chunk-LAZQBMAU.js → chunk-WM2RF2MI.js} +3 -3
- package/dist/{chunk-65ZHM5RH.js → chunk-XJUNAVU2.js} +9 -9
- package/dist/{chunk-TNCZ6444.js → chunk-Y2XASHVY.js} +2 -2
- 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-GYN7PX3T.js} +3 -3
- package/dist/{diagnostics-XXH4FLUG.js → diagnostics-WACXQ33W.js} +6 -6
- package/dist/{doctor-ZIOESU3N.js → doctor-VSQ72A6X.js} +13 -13
- package/dist/{entry-ZNFCTDVE.js → entry-VFEZC2XB.js} +10 -10
- package/dist/{exec-mcp-X6372BLE.js → exec-mcp-TOQEJFK3.js} +8 -8
- package/dist/{harness-F2XFDYXF.js → harness-XCEWFGCG.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-32AFBC3Z.js} +3 -3
- package/dist/{host-X6BR6X4O.js → host-72OLHUX7.js} +20 -10
- package/dist/{host-GRY3VAHH.js → host-TE5PNDHJ.js} +7 -7
- package/dist/{host-run-GCA6H6SR.js → host-run-MXCH26ZD.js} +5 -5
- package/dist/http.js +5 -5
- package/dist/{import-mcp-2TTBPVLY.js → import-mcp-QWGZSIZR.js} +6 -6
- package/dist/index.d.ts +1 -1
- package/dist/index.js +18 -18
- package/dist/{init-627KFXTG.js → init-5M3XWOTJ.js} +2 -2
- package/dist/{install-GG7HHZK2.js → install-MQ7QSJQ7.js} +3 -3
- package/dist/{invoke-LW22Z6ET.js → invoke-SFSN4XT7.js} +8 -8
- package/dist/{list-MCP2FXUF.js → list-FB6RNYYB.js} +3 -3
- package/dist/{list-NGMSQ5SH.js → list-FGDUU5DL.js} +8 -8
- package/dist/{logout-6CSHUWWE.js → logout-KM5N5GOC.js} +7 -7
- package/dist/{logs-SPB6AANY.js → logs-TBUA4UWU.js} +4 -4
- package/dist/mailbox/index.js +4 -4
- package/dist/{mailbox-GDJ7BWQN.js → mailbox-5DWLH4W2.js} +3 -3
- package/dist/{mailbox-7BV54Q4R.js → mailbox-BMTZOSZ7.js} +4 -4
- package/dist/{mainline-JQTTYJMI.js → mainline-KAD2ERLP.js} +2 -2
- package/dist/{mcp-V23HC3LB.js → mcp-FJ2UQ4RH.js} +2 -2
- package/dist/{mcp-2DKVU3SW.js → mcp-ND6ZQWJE.js} +2 -2
- package/dist/{pause-FFAYRBWI.js → pause-7LILUVGL.js} +4 -4
- package/dist/{project-FY62G55N.js → project-LZKQUV2W.js} +4 -4
- package/dist/{reindex-Y27QJFDB.js → reindex-ZULHSQWY.js} +5 -5
- package/dist/{resume-UU4HZIUP.js → resume-26VFAAMH.js} +4 -4
- package/dist/{run-HALGEJNJ.js → run-X4663F4M.js} +4 -4
- package/dist/{run-OGA3P7FC.js → run-YEVGHGTN.js} +7 -7
- package/dist/{serve-NBKT5BKY.js → serve-S7MF42SS.js} +12 -12
- package/dist/{start-login-UIQYQBMC.js → start-login-GKFGTE2A.js} +7 -7
- package/dist/{status-NOOHW5WA.js → status-FYG6XYQ6.js} +7 -7
- package/dist/{status-VHODZPXB.js → status-RO55QPKV.js} +4 -4
- package/dist/{status-XQANBVXW.js → status-XG5GRWVU.js} +11 -11
- package/dist/stdio.js +7 -7
- package/dist/{sweep-64JDCGK6.js → sweep-35LGQTTO.js} +4 -4
- package/dist/{test-MKAXFJOL.js → test-KFDO6ROC.js} +7 -7
- package/dist/{tui-MWKAXE4K.js → tui-2MP7DRIX.js} +5 -5
- package/dist/{unbroadcast-KPUEFLZD.js → unbroadcast-5QNGAJR2.js} +4 -4
- package/dist/{validate-5GZ5YWNA.js → validate-AVM2VHMM.js} +4 -4
- package/dist/{worker-RQ575EJL.js → worker-3VS6RQEL.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 +56 -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/known-issues.md +17 -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/docs/upgrading.md +23 -0
- package/gemini-extension.json +2 -2
- package/mcp.json +1 -1
- package/package.json +8 -7
- 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/agent-assets-migrate/SKILL.md +8 -8
- package/plugins/pmcp/skills/headless-agents-ci-scaffold/SKILL.md +12 -11
- package/plugins/pmcp/skills/marketplace-plugin-scaffold/SKILL.md +10 -8
- 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 +16 -15
- 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/agent-assets-migrate/SKILL.md +8 -8
- package/skills/headless-agents-ci-scaffold/SKILL.md +12 -11
- package/skills/marketplace-plugin-scaffold/SKILL.md +10 -8
- 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 +16 -15
- package/CHANGELOG.md +0 -60
- package/dist/chunk-E7OOHLQR.js +0 -7
- package/docs/manual-library-skills.md +0 -74
|
@@ -612,7 +612,7 @@
|
|
|
612
612
|
},
|
|
613
613
|
{
|
|
614
614
|
"name": "pmcp",
|
|
615
|
-
"version": "0.18.
|
|
615
|
+
"version": "0.18.3",
|
|
616
616
|
"description": "Find package skills and use native runtime project configuration.",
|
|
617
617
|
"source": { "source": "local", "path": "./plugins/pmcp" },
|
|
618
618
|
"policy": { "installation": "AVAILABLE", "authentication": "ON_USE" },
|
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "pmcp",
|
|
3
|
-
"version": "0.18.
|
|
3
|
+
"version": "0.18.3",
|
|
4
4
|
"description": "Find package skills and use native runtime project configuration.",
|
|
5
5
|
"author": { "name": "modootoday" },
|
|
6
6
|
"license": "Elastic-2.0",
|
|
7
7
|
"repository": "https://github.com/modootoday/pmcp",
|
|
8
|
-
"homepage": "https://pmcp.build/
|
|
8
|
+
"homepage": "https://pmcp.build/"
|
|
9
9
|
}
|
package/.mcp.json
CHANGED
package/CONTRIBUTING.md
ADDED
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
# Contributing to pmcp
|
|
2
|
+
|
|
3
|
+
pmcp is a TypeScript package (the CLI, MCP server and library, built with tsup) with five Rust
|
|
4
|
+
crates under `crates/` for the native binaries. Rules that agents and people both follow when
|
|
5
|
+
editing are in `AGENTS.md` in the repository; this page is the procedure.
|
|
6
|
+
|
|
7
|
+
## Set up
|
|
8
|
+
|
|
9
|
+
Node.js 22 or later and Bun 1.3 or later. Rust stable for the crates.
|
|
10
|
+
|
|
11
|
+
```sh
|
|
12
|
+
bun install --frozen-lockfile
|
|
13
|
+
npm run build
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
## Check a change
|
|
17
|
+
|
|
18
|
+
TypeScript, from the repository root:
|
|
19
|
+
|
|
20
|
+
```sh
|
|
21
|
+
npm run typecheck
|
|
22
|
+
npm test
|
|
23
|
+
npm run format:check
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
Use the package's typecheck and test scripts for code changes. Documentation changes need
|
|
27
|
+
link, packaging and formatting checks; avoid rebuilding unrelated runtime artifacts.
|
|
28
|
+
|
|
29
|
+
Rust, in each crate you touched (each crate builds on its own):
|
|
30
|
+
|
|
31
|
+
```sh
|
|
32
|
+
cargo fmt --check
|
|
33
|
+
cargo clippy --all-targets -j 2
|
|
34
|
+
cargo test -j 2
|
|
35
|
+
cargo check --all-targets --target aarch64-apple-darwin # code behind cfg for macOS
|
|
36
|
+
cargo check --all-targets --target x86_64-pc-windows-gnu # and for Windows
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
pmcp-pty's tests need `bash` and `python3` on PATH. The browser and desktop plugins' tests start
|
|
40
|
+
a real Chromium and Xvfb; their `doctor` command says what is missing. No test starts a real
|
|
41
|
+
agent runtime.
|
|
42
|
+
|
|
43
|
+
## Documentation
|
|
44
|
+
|
|
45
|
+
- Keep README.md focused on installation, supported features and user workflows.
|
|
46
|
+
- Keep detailed public configuration and integration examples in docs/.
|
|
47
|
+
- Keep agent instructions in AGENTS.md files next to the code they govern.
|
|
48
|
+
|
|
49
|
+
`docs/*.md` are the sources of the guide pages on pmcp.build and ship in the npm package.
|
|
50
|
+
Format them with prettier, then rebuild and check the site:
|
|
51
|
+
|
|
52
|
+
```sh
|
|
53
|
+
npx prettier --write docs/<page>.md
|
|
54
|
+
bun run site:build
|
|
55
|
+
npm run docs:check
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
## Generated files
|
|
59
|
+
|
|
60
|
+
Edit the source, then regenerate; the checks fail on a generated file edited by hand.
|
|
61
|
+
|
|
62
|
+
| Generated | Source | Command |
|
|
63
|
+
| --------------------------------------------------------------------------- | ------------------------------------------- | --------------------------- |
|
|
64
|
+
| `plugins/pmcp/`, the root plugin and extension manifests, `.claude-plugin/` | `skills/`, `src/ui/claude/`, `package.json` | `bun run marketplace:build` |
|
|
65
|
+
| `docs/<page>/index.html`, `docs/assets/` | `docs/*.md`, `scripts/site/` | `bun run site:build` |
|
|
66
|
+
| `dist/` | `src/` | `npm run build` |
|
|
67
|
+
|
|
68
|
+
## Commits and releases
|
|
69
|
+
|
|
70
|
+
Release notes are generated from commit subjects, so each subject is a line a user reads:
|
|
71
|
+
|
|
72
|
+
- `type(scope)!: summary`, with type `feat`, `fix`, `docs`, `ci`, `chore`, `test`,
|
|
73
|
+
`refactor`, `perf`, `build` or `style`; the scope is optional.
|
|
74
|
+
- Mark a breaking change with `!` and a `BREAKING CHANGE: <what users must do>` footer, and
|
|
75
|
+
add the steps to `docs/upgrading.md`.
|
|
76
|
+
- Say what changed for the user, not how the code changed. One logical change per commit:
|
|
77
|
+
one commit is one line in the notes.
|
|
78
|
+
|
|
79
|
+
Releases follow
|
|
80
|
+
[RELEASING.md](https://github.com/modootoday/pmcp/blob/main/.github/RELEASING.md).
|
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,74 @@ 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
|
-
|
|
|
234
|
-
|
|
|
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
|
+
| [Release notes](https://github.com/modootoday/pmcp/releases) | what changed in each release |
|
|
153
|
+
| [Upgrading](docs/upgrading.md) | what to do when a release changes something you rely on |
|
|
154
|
+
| [Known issues](docs/known-issues.md) | what the current release does not do yet |
|
|
155
|
+
| [Contributing](CONTRIBUTING.md), [Security](SECURITY.md) | working on pmcp, reporting a vulnerability |
|
|
262
156
|
|
|
263
157
|
## Licence
|
|
264
158
|
|
|
265
|
-
pmcp is source available under [Elastic License 2.0](LICENSE).
|
|
266
|
-
|
|
159
|
+
pmcp is source available under [Elastic License 2.0](LICENSE). See
|
|
160
|
+
[NOTICE](NOTICE) for dependency notices and the embedding guide for model
|
|
267
161
|
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-F5LEGPGP.js";
|
|
4
4
|
import {
|
|
5
5
|
catalogFrom
|
|
6
|
-
} from "./chunk-
|
|
6
|
+
} from "./chunk-HEBCQTOD.js";
|
|
7
7
|
import "./chunk-7DLZC73N.js";
|
|
8
8
|
import {
|
|
9
9
|
project
|
|
10
|
-
} from "./chunk-
|
|
10
|
+
} from "./chunk-HQWVGU3W.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-JM2KR2WJ.js";
|
|
16
|
+
import "./chunk-E5XVSMBR.js";
|
|
17
17
|
import {
|
|
18
18
|
RUNTIMES
|
|
19
|
-
} from "./chunk-
|
|
19
|
+
} from "./chunk-XJUNAVU2.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";
|
|
@@ -39,15 +39,15 @@ import "./chunk-A4PKLESO.js";
|
|
|
39
39
|
import "./chunk-V4NPDK6X.js";
|
|
40
40
|
import {
|
|
41
41
|
kindOf
|
|
42
|
-
} from "./chunk-
|
|
42
|
+
} from "./chunk-4CRRLDDS.js";
|
|
43
43
|
import "./chunk-YSAWTGNA.js";
|
|
44
|
-
import "./chunk-
|
|
44
|
+
import "./chunk-2RTRY45B.js";
|
|
45
45
|
import {
|
|
46
46
|
recordProjector
|
|
47
|
-
} from "./chunk-
|
|
47
|
+
} from "./chunk-TAOOPXBV.js";
|
|
48
48
|
import "./chunk-OEH47H6A.js";
|
|
49
49
|
import "./chunk-IJBSOWHK.js";
|
|
50
|
-
import "./chunk-
|
|
50
|
+
import "./chunk-AF2IBMWN.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-S2QI72W3.js.map
|
|
@@ -4,7 +4,7 @@ import {
|
|
|
4
4
|
import {
|
|
5
5
|
matchingSkills,
|
|
6
6
|
readInstalledDependencies
|
|
7
|
-
} from "./chunk-
|
|
7
|
+
} from "./chunk-F5WBMUOT.js";
|
|
8
8
|
import {
|
|
9
9
|
invocation
|
|
10
10
|
} from "./chunk-J7UYNJCR.js";
|
|
@@ -20,7 +20,7 @@ import {
|
|
|
20
20
|
import {
|
|
21
21
|
ArgumentError
|
|
22
22
|
} from "./chunk-A4PKLESO.js";
|
|
23
|
-
import "./chunk-
|
|
23
|
+
import "./chunk-4CRRLDDS.js";
|
|
24
24
|
import "./chunk-YSAWTGNA.js";
|
|
25
25
|
|
|
26
26
|
// src/commands/available.ts
|
|
@@ -70,4 +70,4 @@ var availableCommand = {
|
|
|
70
70
|
export {
|
|
71
71
|
availableCommand
|
|
72
72
|
};
|
|
73
|
-
//# sourceMappingURL=available-
|
|
73
|
+
//# sourceMappingURL=available-GFMTJW4E.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
|