@modootoday/pmcp 0.17.4 → 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 +152 -0
- package/CONTRIBUTING.md +71 -0
- package/README.md +98 -201
- package/SECURITY.md +17 -1
- package/dist/apply-JUTGS5WZ.js +242 -0
- package/dist/{attachment-tU5FZrgZ.d.ts → attachment-D84OGI6n.d.ts} +1 -1
- package/dist/available-DBSIVVJ6.js +73 -0
- package/dist/broadcast-CBMVOV3G.js +18 -0
- package/dist/chunk-26WLNWDG.js +93 -0
- package/dist/chunk-2FIV63WC.js +252 -0
- package/dist/chunk-2P4Z2NUX.js +28 -0
- package/dist/chunk-34DECPVC.js +22 -0
- package/dist/chunk-3FCFAQDG.js +42 -0
- package/dist/chunk-3IDXEV5E.js +1934 -0
- package/dist/chunk-3PW4FI7U.js +32 -0
- package/dist/chunk-3Y3HDMHA.js +108 -0
- package/dist/chunk-47O3X4VS.js +113 -0
- package/dist/chunk-4NDEP7HU.js +26 -0
- package/dist/chunk-5OMOPUE6.js +39 -0
- package/dist/chunk-5QQWS4US.js +53 -0
- package/dist/chunk-5ZABTVSW.js +48 -0
- package/dist/chunk-65KAQSJP.js +7 -0
- package/dist/chunk-6STKGOCW.js +27 -0
- package/dist/chunk-6WXMJOMI.js +9 -0
- package/dist/chunk-73AKO4UL.js +24 -0
- package/dist/chunk-7DLZC73N.js +29 -0
- package/dist/chunk-7GBYECSK.js +72 -0
- package/dist/chunk-7HFIGCSL.js +419 -0
- package/dist/chunk-7TD53M7L.js +13 -0
- package/dist/chunk-7UCZAN4J.js +778 -0
- package/dist/chunk-A4PKLESO.js +112 -0
- package/dist/chunk-A7VF7A35.js +1025 -0
- package/dist/chunk-ABTJQ4QV.js +74 -0
- package/dist/chunk-AJ4VXM2U.js +349 -0
- package/dist/chunk-BBTBJCFA.js +380 -0
- package/dist/chunk-BU65MNVU.js +13 -0
- package/dist/chunk-C4NHQGHL.js +142 -0
- package/dist/chunk-CJTKR6K6.js +1213 -0
- package/dist/chunk-D77IRGHO.js +1246 -0
- package/dist/chunk-DCU2EXQV.js +78 -0
- package/dist/chunk-DMZHQZ7P.js +104 -0
- package/dist/chunk-DZ2MRTYT.js +135 -0
- package/dist/chunk-E2YOZ2FF.js +207 -0
- package/dist/chunk-E3DQB5LS.js +48 -0
- package/dist/chunk-EATCUWGG.js +66 -0
- package/dist/chunk-EAWPJHJ7.js +155 -0
- package/dist/chunk-EIDIVIAD.js +33 -0
- package/dist/chunk-F5QYZK7E.js +396 -0
- package/dist/chunk-F5XMGOOX.js +28 -0
- package/dist/chunk-FENOGX3U.js +31 -0
- package/dist/chunk-GZHHEHKY.js +44 -0
- package/dist/chunk-HDMBVLCZ.js +53 -0
- package/dist/chunk-HQOB7OQS.js +81 -0
- package/dist/chunk-I2ZP2PSA.js +211 -0
- package/dist/chunk-IG33DXLT.js +151 -0
- package/dist/chunk-IJBSOWHK.js +86 -0
- package/dist/chunk-INT7QLEU.js +114 -0
- package/dist/chunk-J7UYNJCR.js +9 -0
- package/dist/chunk-JEL35P7S.js +53 -0
- package/dist/chunk-JGJ4INEN.js +32 -0
- package/dist/chunk-JS5RTH4I.js +84 -0
- package/dist/chunk-JWRZDYB5.js +59 -0
- package/dist/chunk-KMXRRSKT.js +660 -0
- package/dist/chunk-LBXO4VPG.js +73 -0
- package/dist/chunk-LLBPVZXM.js +67 -0
- package/dist/chunk-LLT5FQBE.js +57 -0
- package/dist/chunk-LMT3PPXJ.js +17 -0
- package/dist/chunk-LMUBBIE2.js +83 -0
- package/dist/chunk-LTZH5E3G.js +479 -0
- package/dist/chunk-LW4TG7EL.js +39 -0
- package/dist/chunk-MPSQXSC6.js +346 -0
- package/dist/chunk-MVFH26QT.js +97 -0
- package/dist/chunk-NLEXKE7U.js +67 -0
- package/dist/chunk-NQPURJT5.js +44 -0
- package/dist/chunk-NRBQK6UX.js +105 -0
- package/dist/chunk-OEH47H6A.js +48 -0
- package/dist/chunk-OG7QR2DP.js +75 -0
- package/dist/chunk-OPYFEHKG.js +52 -0
- package/dist/chunk-P4N7DBD5.js +83 -0
- package/dist/chunk-PAX3QXX2.js +140 -0
- package/dist/chunk-PKODFR5F.js +102 -0
- package/dist/chunk-PMJG2CXF.js +122 -0
- package/dist/chunk-Q5H3L6Y4.js +23 -0
- package/dist/chunk-QEF7EK3T.js +28 -0
- package/dist/chunk-QEW4J3IZ.js +74 -0
- package/dist/chunk-QPL7E2HW.js +464 -0
- package/dist/chunk-R2GPCZUX.js +22 -0
- package/dist/chunk-R5MT42JS.js +284 -0
- package/dist/chunk-RMATE45Z.js +197 -0
- package/dist/chunk-RPQOBHVU.js +87 -0
- package/dist/chunk-S3PIAMXV.js +230 -0
- package/dist/chunk-T3LKX23M.js +168 -0
- package/dist/chunk-T6GOWHK6.js +30 -0
- package/dist/chunk-TIA4SPU2.js +10 -0
- package/dist/chunk-TNCZ6444.js +57 -0
- package/dist/chunk-TVL5RTE6.js +269 -0
- package/dist/chunk-TXQ7L33K.js +45 -0
- package/dist/chunk-UPQTAHUK.js +189 -0
- package/dist/chunk-V4NPDK6X.js +14 -0
- package/dist/chunk-VJFEN6DJ.js +38 -0
- package/dist/chunk-VMHUEOT5.js +643 -0
- package/dist/chunk-VRPMYPZU.js +4985 -0
- package/dist/chunk-WIW772I3.js +25 -0
- package/dist/chunk-XELAZAIM.js +136 -0
- package/dist/chunk-XNML2KIC.js +23 -0
- package/dist/chunk-XP2U3LO3.js +30 -0
- package/dist/chunk-YGOWIJPE.js +51 -0
- package/dist/chunk-YIXDHQYE.js +11 -0
- package/dist/chunk-YSAWTGNA.js +117 -0
- package/dist/claude-U2JC2DNQ.js +77 -0
- package/dist/cli-MI4ZCAZ3.js +41 -0
- package/dist/cli-ZN7ZVDEZ.js +46 -0
- package/dist/cli.js +144 -16197
- package/dist/completion-ILSRB3LW.js +142 -0
- package/dist/config-DnpLL2kT.d.ts +46 -0
- package/dist/{service-qpCsOXkQ.d.ts → core-C1LPjxK6.d.ts} +2 -6
- package/dist/diagnostics-XKXVVQWH.js +93 -0
- package/dist/doctor-O2E63YGO.js +538 -0
- package/dist/entry-X6CSYQRQ.js +305 -0
- package/dist/exec-mcp-2PMWBPD7.js +365 -0
- package/dist/harness-L2KSI2ZB.js +177 -0
- package/dist/harness-egress-bridge.js +4 -4
- package/dist/harness-launch-gate.js +47 -940
- package/dist/harness-pane-runner.js +13 -80
- package/dist/harness-worker.js +21 -2703
- package/dist/hook-body.js +5222 -0
- package/dist/hook-spec-C5fWTSCH.d.ts +100 -0
- package/dist/hook.js +26 -0
- package/dist/hooks-BHTA44X7.js +21 -0
- package/dist/host-UIZAXXQH.js +22 -0
- package/dist/host-UWK754BW.js +210 -0
- package/dist/host-run-BI2OTZDZ.js +307 -0
- package/dist/http.d.ts +5 -42
- package/dist/http.js +21 -2234
- package/dist/import-mcp-GPKJI7DI.js +400 -0
- package/dist/index.d.ts +146 -168
- package/dist/index.js +133 -4948
- package/dist/init-3C2Y7BNJ.js +14 -0
- package/dist/install-GG7HHZK2.js +796 -0
- package/dist/invoke-44CJRVMK.js +23 -0
- package/dist/list-MCP2FXUF.js +68 -0
- package/dist/list-WL6L4J5H.js +65 -0
- package/dist/load-BEUBABtB.d.ts +21 -0
- package/dist/logout-F5EJ5MOU.js +44 -0
- package/dist/logs-TBUA4UWU.js +107 -0
- package/dist/mailbox/index.d.ts +10 -5
- package/dist/mailbox/index.js +53 -1572
- package/dist/mailbox-BMTZOSZ7.js +285 -0
- package/dist/mailbox-GDJ7BWQN.js +189 -0
- package/dist/mainline-KAD2ERLP.js +639 -0
- package/dist/marketplace-G4VQET5W.js +191 -0
- package/dist/mcp-235QZN2A.js +15 -0
- package/dist/mcp-FJ2UQ4RH.js +193 -0
- package/dist/models-ISU4DCMA.js +32 -0
- package/dist/opencode-CN7JLQYO.js +60 -0
- package/dist/pause-7LILUVGL.js +18 -0
- package/dist/preview-DT7DWG5F.js +91 -0
- package/dist/project/hook-adapter.d.ts +5 -2
- package/dist/project/hook-adapter.js +41 -27
- package/dist/project-5YV5CUEG.js +70 -0
- package/dist/pty-XTJ4MIWK.js +94 -0
- package/dist/recovery-U6QB3PMT.js +100 -0
- package/dist/reindex-Y27QJFDB.js +22 -0
- package/dist/resume-26VFAAMH.js +18 -0
- package/dist/run-3AXTZSR7.js +126 -0
- package/dist/run-3SOVRQIA.js +19 -0
- package/dist/serve-DQMKTFIV.js +104 -0
- package/dist/session-XM2CR425.js +159 -0
- package/dist/setup-DTKZLZUT.js +18 -0
- package/dist/start-login-YTZV6KMF.js +416 -0
- package/dist/status-A2OUTNGK.js +9 -0
- package/dist/status-H2VAHIDV.js +10 -0
- package/dist/status-MROQ7WR7.js +43 -0
- package/dist/status-RO55QPKV.js +55 -0
- package/dist/status-UME2L33L.js +286 -0
- package/dist/stdio.d.ts +3 -13
- package/dist/stdio.js +16 -3186
- package/dist/sweep-35LGQTTO.js +18 -0
- package/dist/test-AGZOJLRZ.js +561 -0
- package/dist/tools-gpHNq9Dh.d.ts +328 -0
- package/dist/tui-G5LLWCSV.js +153 -0
- package/dist/unbroadcast-5QNGAJR2.js +18 -0
- package/dist/validate-IU52H2IC.js +46 -0
- package/dist/worker-QZ5T6LJD.js +80 -0
- package/dist/worktree-create-PZSRB7PH.js +89 -0
- package/dist/worktree-list-JYB6VXLW.js +51 -0
- package/dist/worktree-sync-UF5CXPWV.js +30 -0
- 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/capabilities/antigravity.json +199 -0
- package/docs/hooks/capabilities/claude.json +179 -0
- package/docs/hooks/capabilities/codex.json +179 -0
- package/docs/hooks/capabilities/gemini.json +196 -0
- package/docs/hooks/capabilities/grok.json +192 -0
- package/docs/hooks/capabilities/opencode.json +184 -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 +540 -58
- package/docs/sessions.md +64 -0
- package/docs/skills.md +4 -45
- package/docs/terminal-harness.md +92 -44
- package/docs/terminal-workspace.md +81 -169
- package/gemini-extension.json +2 -2
- package/mcp.json +1 -1
- package/package.json +16 -2
- package/plugin.json +2 -2
- package/plugins/pmcp/.claude-plugin/plugin.json +4 -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/commands.ts +72 -0
- package/plugins/pmcp/mod/contract.d.ts +39 -0
- package/plugins/pmcp/mod/draw.tsx +216 -0
- package/plugins/pmcp/mod/guard.ts +42 -0
- package/plugins/pmcp/mod/hooks.json +4 -0
- package/plugins/pmcp/mod/host.ts +46 -0
- package/plugins/pmcp/mod/model.ts +144 -0
- package/plugins/pmcp/mod/reader/index.ts +18 -0
- package/plugins/pmcp/mod/reader/read.ts +76 -0
- package/plugins/pmcp/mod/reader/settings.ts +54 -0
- package/plugins/pmcp/mod/reader/types.ts +38 -0
- package/plugins/pmcp/mod/register.tsx +73 -0
- package/plugins/pmcp/mod/sessions/format.ts +91 -0
- package/plugins/pmcp/mod/sessions/types.ts +162 -0
- package/plugins/pmcp/mod/snapshot.ts +75 -0
- package/plugins/pmcp/mod/spinner.tsx +30 -0
- package/plugins/pmcp/mod/state.ts +28 -0
- package/plugins/pmcp/plugin.json +2 -2
- package/plugins/pmcp/skills/agent-assets-migrate/SKILL.md +96 -0
- package/plugins/pmcp/skills/headless-agents-ci-scaffold/SKILL.md +101 -0
- package/plugins/pmcp/skills/marketplace-plugin-scaffold/SKILL.md +87 -0
- package/plugins/pmcp/skills/package-skill-catalog/SKILL.md +51 -15
- 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 +153 -0
- package/plugins/pmcp/skills/pmcp-sessions-and-git/SKILL.md +96 -0
- package/plugins/pmcp/skills/skill-package-scaffold/SKILL.md +89 -0
- package/schema/catalog-v1.json +187 -0
- package/schema/library.json +196 -0
- package/schema/marketplace-manifest.json +144 -0
- package/schema/plugin-manifest.json +59 -0
- package/schema/skill-frontmatter.json +170 -0
- package/schema/skill-metadata-core.json +131 -0
- package/skills/agent-assets-migrate/SKILL.md +96 -0
- package/skills/headless-agents-ci-scaffold/SKILL.md +101 -0
- package/skills/marketplace-plugin-scaffold/SKILL.md +87 -0
- package/skills/package-skill-catalog/SKILL.md +51 -15
- package/skills/pmcp-browser/SKILL.md +27 -0
- package/skills/pmcp-desktop/SKILL.md +25 -0
- package/skills/pmcp-project-init/SKILL.md +153 -0
- package/skills/pmcp-sessions-and-git/SKILL.md +96 -0
- package/skills/skill-package-scaffold/SKILL.md +89 -0
- package/dist/config-BkSpjUG6.d.ts +0 -50
- package/dist/embed-DRROSD3F.d.ts +0 -53
- package/dist/hook-spec-CSJJySsH.d.ts +0 -11
- package/dist/server-VWSY3Shw.d.ts +0 -543
- package/dist/tui-worker.js +0 -6549
- package/docs/manual-library-skills.md +0 -74
- /package/dist/{tui-worker.d.ts → hook.d.ts} +0 -0
|
@@ -612,7 +612,7 @@
|
|
|
612
612
|
},
|
|
613
613
|
{
|
|
614
614
|
"name": "pmcp",
|
|
615
|
-
"version": "0.
|
|
615
|
+
"version": "0.18.2",
|
|
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.
|
|
3
|
+
"version": "0.18.2",
|
|
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/CHANGELOG.md
ADDED
|
@@ -0,0 +1,152 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
## 0.18.2 - 2026-10-21
|
|
4
|
+
|
|
5
|
+
The first release after 0.18.0. v0.18.1 was tagged but never published to npm: its
|
|
6
|
+
publish step failed on a path npm read as a GitHub shorthand, before any package was
|
|
7
|
+
uploaded. Everything below ships in 0.18.2.
|
|
8
|
+
|
|
9
|
+
### New
|
|
10
|
+
|
|
11
|
+
- `pmcp sessions send --to worktree:<path>` addresses the session in a linked
|
|
12
|
+
worktree; `desk:<path>` keeps working. Hook messages say "linked worktree"
|
|
13
|
+
and "being delivered". (152e489)
|
|
14
|
+
- The pmcp plugin ships the pmcp-browser and pmcp-desktop skills, so agents
|
|
15
|
+
learn the two MCP servers where they are installed. (cde23e7)
|
|
16
|
+
- The skill tools say when to call them and what to call next. (6b71a00)
|
|
17
|
+
- New pages: Getting started, Run several agents, Command reference,
|
|
18
|
+
Compatibility and Glossary, as Markdown in the npm package and on
|
|
19
|
+
pmcp.build. (446fb90, 4f80203)
|
|
20
|
+
|
|
21
|
+
- The configuration guide is split into task pages: Hooks, Git workflow,
|
|
22
|
+
Browser and desktop, and Library skills (which says how library skills are
|
|
23
|
+
matched and the evidence each carries); the pmcp.toml reference keeps
|
|
24
|
+
every table. Installation, Authoring and How it compares are Markdown too.
|
|
25
|
+
(d29f4de, 5280cfc)
|
|
26
|
+
- The JSON schemas in `schema/` carry a title and a description. (1f83e4c)
|
|
27
|
+
|
|
28
|
+
### Fixes
|
|
29
|
+
|
|
30
|
+
- The release workflow hands npm explicit `./` paths; 0.18.1's publish failed
|
|
31
|
+
because npm read `packed/<name>.tgz` as a GitHub `owner/repo` shorthand.
|
|
32
|
+
(33d9383)
|
|
33
|
+
- Every release mode runs the same publish script: dry-run and bootstrap
|
|
34
|
+
rehearse it with `npm publish --dry-run`, a failed publish reports which
|
|
35
|
+
packages reached npm with the recovery steps, and a rerun skips what is
|
|
36
|
+
already published. (e963375)
|
|
37
|
+
- pmcp-browser's `close` leaves no browser process behind even when Chromium
|
|
38
|
+
starts a helper while shutting down. (164cfb5)
|
|
39
|
+
- smol-toml 1.9.0 fixes a quadratic-time `parse()` on documents with many key
|
|
40
|
+
lines (GHSA-r4xh-jqrq-34v2, moderate), which `npm audit` reported for 0.18.0.
|
|
41
|
+
(dea8fc1)
|
|
42
|
+
- The release and cross-OS workflows build the Intel macOS binaries on
|
|
43
|
+
`macos-15-intel`; GitHub retired the macOS 13 image, so the job never started.
|
|
44
|
+
- The arm64 macOS binaries and tests run on `macos-15`; GitHub marks the macOS
|
|
45
|
+
14 image deprecated.
|
|
46
|
+
- Links to a section of a guide page on pmcp.build open at that section;
|
|
47
|
+
guide headings had no anchors. (446fb90)
|
|
48
|
+
|
|
49
|
+
- The pmcp plugin for Claude Code and Codex and the Gemini extension start
|
|
50
|
+
the pmcp release they ship in; in 0.18.0 they still started 0.13.1.
|
|
51
|
+
(0840cdc)
|
|
52
|
+
- `pmcp harness host up` and `host unit` stop with `platform_unsupported` on
|
|
53
|
+
macOS instead of failing inside `systemd-run`. (b2d1e8d)
|
|
54
|
+
- The pmcp-project-init and skill-package-scaffold skills describe
|
|
55
|
+
`pmcp init` and `[catalog.validation]` correctly. (44cd959)
|
|
56
|
+
- The pmcp.build pages no longer say the harness needs tmux, and the commands
|
|
57
|
+
page lists `pmcp harness host` and `pmcp harness mcp`. (7315b23)
|
|
58
|
+
|
|
59
|
+
## 0.18.1 - 2026-10-21
|
|
60
|
+
|
|
61
|
+
Tagged, never published to npm; its changes ship in 0.18.2.
|
|
62
|
+
|
|
63
|
+
## 0.18.0
|
|
64
|
+
|
|
65
|
+
This release replaces tmux with pmcp's own terminal host and adds project
|
|
66
|
+
hooks, sessions and two MCP servers for browser and desktop use. As a 0.x minor
|
|
67
|
+
release it contains breaking changes. (29bad53)
|
|
68
|
+
|
|
69
|
+
### Upgrading from 0.17
|
|
70
|
+
|
|
71
|
+
Stop what 0.17 started before you upgrade; 0.18 does not read tmux groups or
|
|
72
|
+
views. With the 0.17 release that created them:
|
|
73
|
+
|
|
74
|
+
```sh
|
|
75
|
+
npx @modootoday/pmcp@0.17.4 tui recovery # a workspace from bare pmcp: prints groupFile and generation
|
|
76
|
+
npx @modootoday/pmcp@0.17.4 tui close --view "$VIEW_FILE"
|
|
77
|
+
npx @modootoday/pmcp@0.17.4 harness group inspect --group-file "$GROUP_FILE" # any other group: prints the generation
|
|
78
|
+
npx @modootoday/pmcp@0.17.4 harness group stop --group-file "$GROUP_FILE" --generation "$GENERATION"
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
Then upgrade and start a new workspace with `pmcp tui --new` (plain `pmcp`
|
|
82
|
+
once no 0.17 checkpoint is left). Scripts that called the removed
|
|
83
|
+
`pmcp tui` view operations now get a usage error (exit 2).
|
|
84
|
+
|
|
85
|
+
### Known issues
|
|
86
|
+
|
|
87
|
+
- macOS binaries are unsigned. They run when installed through npm.
|
|
88
|
+
(`scripts/platform-packages.mjs`)
|
|
89
|
+
- Windows is not supported: the harness, `pmcp tui` and pmcp-pty stop with
|
|
90
|
+
`platform_unsupported`. (`src/harness/platform.ts`)
|
|
91
|
+
- `pmcp harness host up` and `host unit` need Linux with a user systemd
|
|
92
|
+
manager. In 0.18.0 they fail inside `systemd-run` on macOS; see Unreleased.
|
|
93
|
+
(`src/harness/host/daemon.ts`)
|
|
94
|
+
- pmcp-browser and pmcp-desktop ship for Linux only.
|
|
95
|
+
(`scripts/platform-packages.mjs`)
|
|
96
|
+
- The plugin for Claude Code and Codex and the Gemini extension start pmcp
|
|
97
|
+
0.13.1 for skill search; install the CLI for 0.18 features. Fixed in
|
|
98
|
+
Unreleased. (`scripts/marketplace/manifests.mjs`)
|
|
99
|
+
- `[sessions.roles]` applies to Claude Code only; Codex sends no agent type.
|
|
100
|
+
(`docs/project-configuration.md`)
|
|
101
|
+
|
|
102
|
+
### Breaking
|
|
103
|
+
|
|
104
|
+
- tmux is no longer used or required. Native sessions run in pmcp-pty, a PTY
|
|
105
|
+
host with one daemon per harness group, and `pmcp tui` draws the workspace
|
|
106
|
+
with pmcp-tui. Groups and workspaces created by 0.17 and earlier are not
|
|
107
|
+
migrated: stop them as in Upgrading from 0.17, then start a new one. (29bad53: `src/harness/adapters/terminal/`)
|
|
108
|
+
- The `pmcp tui` view operations (`create`, `open`, `close`, `stop` and the
|
|
109
|
+
others taking `--view`) and their options are removed. `pmcp tui`,
|
|
110
|
+
`plan`, `recovery`, `doctor` and `start-worker` remain. (29bad53: `src/commands/tui/invocation.ts`)
|
|
111
|
+
- Harness session records hold the pmcp-pty session, host instance and
|
|
112
|
+
process id instead of tmux pane identities. (29bad53: `src/harness/contracts.ts`)
|
|
113
|
+
- The terminal workspace and harness need Linux (glibc 2.35 or later) or
|
|
114
|
+
macOS. On Linux a user systemd manager caps each session's memory; macOS
|
|
115
|
+
runs sessions uncapped. Windows is not supported yet. (29bad53: `src/harness/platform.ts`)
|
|
116
|
+
|
|
117
|
+
### Terminal host and workspace
|
|
118
|
+
|
|
119
|
+
- pmcp-pty hosts native runtimes with guarded writes, per-runtime screen
|
|
120
|
+
profiles, turn detection from hook events, and a lease that refuses any
|
|
121
|
+
other writer while someone holds control. (29bad53: `crates/pmcp-pty/`)
|
|
122
|
+
- pmcp-tui shows main, a worker dock and a coordination panel, with explicit
|
|
123
|
+
control, history and mailbox views, read only until you take control. (29bad53: `crates/pmcp-tui/`)
|
|
124
|
+
- npm installs pmcp-pty and pmcp-tui through a platform package
|
|
125
|
+
(`@modootoday/pmcp-<os>-<cpu>`) for Linux and macOS on x64 and arm64.
|
|
126
|
+
`PMCP_PTY_BIN` and `PMCP_TUI_BIN` override it. The macOS binaries are
|
|
127
|
+
unsigned. (29bad53: `scripts/platform-packages.mjs`)
|
|
128
|
+
- `[host]` in pmcp.toml declares which tool dialogs a host you approved may
|
|
129
|
+
answer; login, authentication and trust prompts are never answered. (29bad53: `src/project/host-spec.ts`)
|
|
130
|
+
- `pmcp harness host up`, `down` and `unit` manage a host for the project. (29bad53: `src/commands/harness/host.ts`)
|
|
131
|
+
|
|
132
|
+
### Browser and desktop
|
|
133
|
+
|
|
134
|
+
- pmcp-browser runs an isolated, headless Chromium over MCP that reaches
|
|
135
|
+
public sites only. pmcp-desktop drives an Xvfb desktop through screenshots
|
|
136
|
+
and input. Both ship in the Linux platform package; name them bare in
|
|
137
|
+
`[mcp.<alias>] command` and `pmcp project` resolves the installed binary. (29bad53: `crates/pmcp-plugin-browser-use/`, `crates/pmcp-plugin-computer-use/`)
|
|
138
|
+
|
|
139
|
+
### Hooks, sessions and project configuration
|
|
140
|
+
|
|
141
|
+
- `[hooks]` compiles to one hook bundle projected for Claude Code, Codex,
|
|
142
|
+
Gemini CLI, Grok, Antigravity and opencode, with guards for secrets,
|
|
143
|
+
staging, pushes and worktrees. (29bad53: `src/hooks/`)
|
|
144
|
+
- Sessions: see who else works in the repository (`pmcp sessions status`),
|
|
145
|
+
pause them, send addressed messages and wake idle sessions. (29bad53: `src/sessions/`)
|
|
146
|
+
- `pmcp logs` reads the project's JSONL logs, with rotation and retention set
|
|
147
|
+
by `[logging]`. (29bad53: `src/logging/`)
|
|
148
|
+
- `pmcp git` creates and syncs worktrees and delivers commits to the mainline. (29bad53: `src/git/`)
|
|
149
|
+
- `pmcp mcp` shares remote MCP authentication across runtimes. (29bad53: `src/mcp-auth/`)
|
|
150
|
+
- `pmcp status`, `pmcp init`, `pmcp hooks` and `pmcp completion` are new;
|
|
151
|
+
`[permissions.claude]`, `[catalog.validation]` and declared marketplaces
|
|
152
|
+
are projected from pmcp.toml. (29bad53: `src/commands/specs/inspection.ts`, `src/project/permissions.ts`)
|
package/CONTRIBUTING.md
ADDED
|
@@ -0,0 +1,71 @@
|
|
|
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
|
+
Commit messages describe the change for a reader of the public history. Releases follow
|
|
71
|
+
[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,146 +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
|
|
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.
|
|
144
100
|
|
|
145
|
-
|
|
146
|
-
coordination panel in one terminal workspace. The optional harness and TUI need
|
|
147
|
-
Linux, tmux, util-linux flock, Node.js 22 or later and a working user systemd
|
|
148
|
-
manager. Provider login, folder trust and tool approvals remain native.
|
|
149
|
-
|
|
150
|
-
PMCP 0.16.0 adds the numbered runtime picker, worker menu, worker-start and
|
|
151
|
-
read-only recovery flows below.
|
|
152
|
-
|
|
153
|
-
```sh
|
|
154
|
-
npx @modootoday/pmcp --version
|
|
155
|
-
npx @modootoday/pmcp harness doctor inspect
|
|
156
|
-
npx @modootoday/pmcp tui doctor
|
|
157
|
-
```
|
|
158
|
-
|
|
159
|
-
On a supported interactive host, open the workspace with:
|
|
160
|
-
|
|
161
|
-
```sh
|
|
162
|
-
pmcp
|
|
163
|
-
```
|
|
164
|
-
|
|
165
|
-
The first launch lists installed native runtimes. Choose a number or accept the
|
|
166
|
-
default, then confirm the start; q cancels without creating a group. No group or
|
|
167
|
-
view JSON is required. Later launches reconnect to the workspace
|
|
168
|
-
created for this project. Native login and folder trust stay with the runtime.
|
|
169
|
-
Use `pmcp tui --runtime codex-cli` to choose the main, or set an optional default:
|
|
170
|
-
|
|
171
|
-
```toml
|
|
172
|
-
[tui]
|
|
173
|
-
runtime = "codex-cli"
|
|
174
|
-
```
|
|
101
|
+
## Guard commands and run several agents
|
|
175
102
|
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
does not restart a runtime or replay input.
|
|
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.
|
|
182
108
|
|
|
183
|
-
|
|
184
|
-
[terminal workspace guide](docs/terminal-workspace.md) covers defaults, custom
|
|
185
|
-
configuration and advanced controls. The [native terminal guide](docs/terminal-harness.md)
|
|
186
|
-
explains explicit group and session operations.
|
|
187
|
-
Views start read only; acquiring control and stopping a runtime are explicit
|
|
188
|
-
actions. This optional CLI feature does not add execution tools to the MCP server.
|
|
109
|
+
## Watch and steer agent terminals
|
|
189
110
|
|
|
190
|
-
|
|
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.
|
|
191
117
|
|
|
192
|
-
|
|
118
|
+
## Commands
|
|
193
119
|
|
|
194
120
|
```sh
|
|
195
|
-
pmcp list
|
|
196
|
-
pmcp available
|
|
121
|
+
pmcp list # skills the server sees
|
|
122
|
+
pmcp available # catalog skill packages that match your dependencies
|
|
197
123
|
pmcp install --all --dry-run
|
|
198
|
-
pmcp
|
|
199
|
-
pmcp
|
|
200
|
-
pmcp
|
|
124
|
+
pmcp validate # check skill documents
|
|
125
|
+
pmcp status # features, drift, live sessions
|
|
126
|
+
pmcp --help
|
|
201
127
|
```
|
|
202
128
|
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
skills.
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
|
226
|
-
|
|
|
227
|
-
|
|
|
228
|
-
| Optional terminal workspace | Linux PTY/tmux checks and bounded native Codex, Gemini, Grok and agy main/worker acceptance; Claude remains deferred |
|
|
229
|
-
| Public skill installation | npm, Bun and pnpm 10.17.1; confirmation required, scripts disabled |
|
|
230
|
-
| Native plugin export | Claude, Codex, Gemini, Grok and agy formats; export does not install or activate a vendor plugin |
|
|
231
|
-
| pnpm workspace installation | Selects the member, preserves root dependencies and updates the shared lockfile |
|
|
232
|
-
| Yarn skill installation | Refused without changing project files; Yarn PnP is not supported |
|
|
233
|
-
| macOS, Windows and other architectures | Not qualified by the Linux Docker tests |
|
|
234
|
-
|
|
235
|
-
Provider authentication, native children and vendor behavior have separate
|
|
236
|
-
qualification scopes. An installed executable or exported manifest is not proof
|
|
237
|
-
that every native feature works. Public package CI checks actual packed-archive
|
|
238
|
-
installation, CLI startup, MCP and SQLite before publication; isolated projects
|
|
239
|
-
on a host are distinct from Docker and OS qualification.
|
|
240
|
-
|
|
241
|
-
## Guides
|
|
242
|
-
|
|
243
|
-
| Guide | Contents |
|
|
244
|
-
| ------------------------------------------------------ | ------------------------------------------------------------- |
|
|
245
|
-
| [Project configuration](docs/project-configuration.md) | Catalog sources, native files, MCP import, guards and doctor |
|
|
246
|
-
| [Skills and MCP reference](docs/skills.md) | Skill documents, tools, resources, prompts and compatibility |
|
|
247
|
-
| [Embedding models](docs/embeddings.md) | E5, EmbeddingGemma and custom local model selection |
|
|
248
|
-
| [Local mailbox](docs/mailbox.md) | Actor credentials, messages, receipts and library integration |
|
|
249
|
-
| [HTTP hosting](docs/hosting.md) | Authentication, catalog access and request controls |
|
|
250
|
-
| [Native terminal control](docs/terminal-harness.md) | Owned sessions, explicit input, Docker profiles and recovery |
|
|
251
|
-
| [Terminal workspace](docs/terminal-workspace.md) | Main and worker panels, observation, control and failures |
|
|
252
|
-
| [Security policy](SECURITY.md) | Reporting vulnerabilities |
|
|
253
|
-
|
|
254
|
-
Semantic search is optional and requires `@huggingface/transformers` installed
|
|
255
|
-
separately. Lexical search works without downloading a model. The mailbox is
|
|
256
|
-
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 |
|
|
257
154
|
|
|
258
155
|
## Licence
|
|
259
156
|
|
|
260
|
-
pmcp is source available under [Elastic License 2.0](LICENSE).
|
|
261
|
-
|
|
157
|
+
pmcp is source available under [Elastic License 2.0](LICENSE). See
|
|
158
|
+
[NOTICE](NOTICE) for dependency notices and the embedding guide for model
|
|
262
159
|
licences. Website: [pmcp.build](https://pmcp.build).
|