@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.
Files changed (272) hide show
  1. package/.agents/plugins/marketplace.json +1 -1
  2. package/.claude-plugin/marketplace.json +1 -1
  3. package/.claude-plugin/plugin.json +2 -2
  4. package/.mcp.json +1 -1
  5. package/CHANGELOG.md +152 -0
  6. package/CONTRIBUTING.md +71 -0
  7. package/README.md +98 -201
  8. package/SECURITY.md +17 -1
  9. package/dist/apply-JUTGS5WZ.js +242 -0
  10. package/dist/{attachment-tU5FZrgZ.d.ts → attachment-D84OGI6n.d.ts} +1 -1
  11. package/dist/available-DBSIVVJ6.js +73 -0
  12. package/dist/broadcast-CBMVOV3G.js +18 -0
  13. package/dist/chunk-26WLNWDG.js +93 -0
  14. package/dist/chunk-2FIV63WC.js +252 -0
  15. package/dist/chunk-2P4Z2NUX.js +28 -0
  16. package/dist/chunk-34DECPVC.js +22 -0
  17. package/dist/chunk-3FCFAQDG.js +42 -0
  18. package/dist/chunk-3IDXEV5E.js +1934 -0
  19. package/dist/chunk-3PW4FI7U.js +32 -0
  20. package/dist/chunk-3Y3HDMHA.js +108 -0
  21. package/dist/chunk-47O3X4VS.js +113 -0
  22. package/dist/chunk-4NDEP7HU.js +26 -0
  23. package/dist/chunk-5OMOPUE6.js +39 -0
  24. package/dist/chunk-5QQWS4US.js +53 -0
  25. package/dist/chunk-5ZABTVSW.js +48 -0
  26. package/dist/chunk-65KAQSJP.js +7 -0
  27. package/dist/chunk-6STKGOCW.js +27 -0
  28. package/dist/chunk-6WXMJOMI.js +9 -0
  29. package/dist/chunk-73AKO4UL.js +24 -0
  30. package/dist/chunk-7DLZC73N.js +29 -0
  31. package/dist/chunk-7GBYECSK.js +72 -0
  32. package/dist/chunk-7HFIGCSL.js +419 -0
  33. package/dist/chunk-7TD53M7L.js +13 -0
  34. package/dist/chunk-7UCZAN4J.js +778 -0
  35. package/dist/chunk-A4PKLESO.js +112 -0
  36. package/dist/chunk-A7VF7A35.js +1025 -0
  37. package/dist/chunk-ABTJQ4QV.js +74 -0
  38. package/dist/chunk-AJ4VXM2U.js +349 -0
  39. package/dist/chunk-BBTBJCFA.js +380 -0
  40. package/dist/chunk-BU65MNVU.js +13 -0
  41. package/dist/chunk-C4NHQGHL.js +142 -0
  42. package/dist/chunk-CJTKR6K6.js +1213 -0
  43. package/dist/chunk-D77IRGHO.js +1246 -0
  44. package/dist/chunk-DCU2EXQV.js +78 -0
  45. package/dist/chunk-DMZHQZ7P.js +104 -0
  46. package/dist/chunk-DZ2MRTYT.js +135 -0
  47. package/dist/chunk-E2YOZ2FF.js +207 -0
  48. package/dist/chunk-E3DQB5LS.js +48 -0
  49. package/dist/chunk-EATCUWGG.js +66 -0
  50. package/dist/chunk-EAWPJHJ7.js +155 -0
  51. package/dist/chunk-EIDIVIAD.js +33 -0
  52. package/dist/chunk-F5QYZK7E.js +396 -0
  53. package/dist/chunk-F5XMGOOX.js +28 -0
  54. package/dist/chunk-FENOGX3U.js +31 -0
  55. package/dist/chunk-GZHHEHKY.js +44 -0
  56. package/dist/chunk-HDMBVLCZ.js +53 -0
  57. package/dist/chunk-HQOB7OQS.js +81 -0
  58. package/dist/chunk-I2ZP2PSA.js +211 -0
  59. package/dist/chunk-IG33DXLT.js +151 -0
  60. package/dist/chunk-IJBSOWHK.js +86 -0
  61. package/dist/chunk-INT7QLEU.js +114 -0
  62. package/dist/chunk-J7UYNJCR.js +9 -0
  63. package/dist/chunk-JEL35P7S.js +53 -0
  64. package/dist/chunk-JGJ4INEN.js +32 -0
  65. package/dist/chunk-JS5RTH4I.js +84 -0
  66. package/dist/chunk-JWRZDYB5.js +59 -0
  67. package/dist/chunk-KMXRRSKT.js +660 -0
  68. package/dist/chunk-LBXO4VPG.js +73 -0
  69. package/dist/chunk-LLBPVZXM.js +67 -0
  70. package/dist/chunk-LLT5FQBE.js +57 -0
  71. package/dist/chunk-LMT3PPXJ.js +17 -0
  72. package/dist/chunk-LMUBBIE2.js +83 -0
  73. package/dist/chunk-LTZH5E3G.js +479 -0
  74. package/dist/chunk-LW4TG7EL.js +39 -0
  75. package/dist/chunk-MPSQXSC6.js +346 -0
  76. package/dist/chunk-MVFH26QT.js +97 -0
  77. package/dist/chunk-NLEXKE7U.js +67 -0
  78. package/dist/chunk-NQPURJT5.js +44 -0
  79. package/dist/chunk-NRBQK6UX.js +105 -0
  80. package/dist/chunk-OEH47H6A.js +48 -0
  81. package/dist/chunk-OG7QR2DP.js +75 -0
  82. package/dist/chunk-OPYFEHKG.js +52 -0
  83. package/dist/chunk-P4N7DBD5.js +83 -0
  84. package/dist/chunk-PAX3QXX2.js +140 -0
  85. package/dist/chunk-PKODFR5F.js +102 -0
  86. package/dist/chunk-PMJG2CXF.js +122 -0
  87. package/dist/chunk-Q5H3L6Y4.js +23 -0
  88. package/dist/chunk-QEF7EK3T.js +28 -0
  89. package/dist/chunk-QEW4J3IZ.js +74 -0
  90. package/dist/chunk-QPL7E2HW.js +464 -0
  91. package/dist/chunk-R2GPCZUX.js +22 -0
  92. package/dist/chunk-R5MT42JS.js +284 -0
  93. package/dist/chunk-RMATE45Z.js +197 -0
  94. package/dist/chunk-RPQOBHVU.js +87 -0
  95. package/dist/chunk-S3PIAMXV.js +230 -0
  96. package/dist/chunk-T3LKX23M.js +168 -0
  97. package/dist/chunk-T6GOWHK6.js +30 -0
  98. package/dist/chunk-TIA4SPU2.js +10 -0
  99. package/dist/chunk-TNCZ6444.js +57 -0
  100. package/dist/chunk-TVL5RTE6.js +269 -0
  101. package/dist/chunk-TXQ7L33K.js +45 -0
  102. package/dist/chunk-UPQTAHUK.js +189 -0
  103. package/dist/chunk-V4NPDK6X.js +14 -0
  104. package/dist/chunk-VJFEN6DJ.js +38 -0
  105. package/dist/chunk-VMHUEOT5.js +643 -0
  106. package/dist/chunk-VRPMYPZU.js +4985 -0
  107. package/dist/chunk-WIW772I3.js +25 -0
  108. package/dist/chunk-XELAZAIM.js +136 -0
  109. package/dist/chunk-XNML2KIC.js +23 -0
  110. package/dist/chunk-XP2U3LO3.js +30 -0
  111. package/dist/chunk-YGOWIJPE.js +51 -0
  112. package/dist/chunk-YIXDHQYE.js +11 -0
  113. package/dist/chunk-YSAWTGNA.js +117 -0
  114. package/dist/claude-U2JC2DNQ.js +77 -0
  115. package/dist/cli-MI4ZCAZ3.js +41 -0
  116. package/dist/cli-ZN7ZVDEZ.js +46 -0
  117. package/dist/cli.js +144 -16197
  118. package/dist/completion-ILSRB3LW.js +142 -0
  119. package/dist/config-DnpLL2kT.d.ts +46 -0
  120. package/dist/{service-qpCsOXkQ.d.ts → core-C1LPjxK6.d.ts} +2 -6
  121. package/dist/diagnostics-XKXVVQWH.js +93 -0
  122. package/dist/doctor-O2E63YGO.js +538 -0
  123. package/dist/entry-X6CSYQRQ.js +305 -0
  124. package/dist/exec-mcp-2PMWBPD7.js +365 -0
  125. package/dist/harness-L2KSI2ZB.js +177 -0
  126. package/dist/harness-egress-bridge.js +4 -4
  127. package/dist/harness-launch-gate.js +47 -940
  128. package/dist/harness-pane-runner.js +13 -80
  129. package/dist/harness-worker.js +21 -2703
  130. package/dist/hook-body.js +5222 -0
  131. package/dist/hook-spec-C5fWTSCH.d.ts +100 -0
  132. package/dist/hook.js +26 -0
  133. package/dist/hooks-BHTA44X7.js +21 -0
  134. package/dist/host-UIZAXXQH.js +22 -0
  135. package/dist/host-UWK754BW.js +210 -0
  136. package/dist/host-run-BI2OTZDZ.js +307 -0
  137. package/dist/http.d.ts +5 -42
  138. package/dist/http.js +21 -2234
  139. package/dist/import-mcp-GPKJI7DI.js +400 -0
  140. package/dist/index.d.ts +146 -168
  141. package/dist/index.js +133 -4948
  142. package/dist/init-3C2Y7BNJ.js +14 -0
  143. package/dist/install-GG7HHZK2.js +796 -0
  144. package/dist/invoke-44CJRVMK.js +23 -0
  145. package/dist/list-MCP2FXUF.js +68 -0
  146. package/dist/list-WL6L4J5H.js +65 -0
  147. package/dist/load-BEUBABtB.d.ts +21 -0
  148. package/dist/logout-F5EJ5MOU.js +44 -0
  149. package/dist/logs-TBUA4UWU.js +107 -0
  150. package/dist/mailbox/index.d.ts +10 -5
  151. package/dist/mailbox/index.js +53 -1572
  152. package/dist/mailbox-BMTZOSZ7.js +285 -0
  153. package/dist/mailbox-GDJ7BWQN.js +189 -0
  154. package/dist/mainline-KAD2ERLP.js +639 -0
  155. package/dist/marketplace-G4VQET5W.js +191 -0
  156. package/dist/mcp-235QZN2A.js +15 -0
  157. package/dist/mcp-FJ2UQ4RH.js +193 -0
  158. package/dist/models-ISU4DCMA.js +32 -0
  159. package/dist/opencode-CN7JLQYO.js +60 -0
  160. package/dist/pause-7LILUVGL.js +18 -0
  161. package/dist/preview-DT7DWG5F.js +91 -0
  162. package/dist/project/hook-adapter.d.ts +5 -2
  163. package/dist/project/hook-adapter.js +41 -27
  164. package/dist/project-5YV5CUEG.js +70 -0
  165. package/dist/pty-XTJ4MIWK.js +94 -0
  166. package/dist/recovery-U6QB3PMT.js +100 -0
  167. package/dist/reindex-Y27QJFDB.js +22 -0
  168. package/dist/resume-26VFAAMH.js +18 -0
  169. package/dist/run-3AXTZSR7.js +126 -0
  170. package/dist/run-3SOVRQIA.js +19 -0
  171. package/dist/serve-DQMKTFIV.js +104 -0
  172. package/dist/session-XM2CR425.js +159 -0
  173. package/dist/setup-DTKZLZUT.js +18 -0
  174. package/dist/start-login-YTZV6KMF.js +416 -0
  175. package/dist/status-A2OUTNGK.js +9 -0
  176. package/dist/status-H2VAHIDV.js +10 -0
  177. package/dist/status-MROQ7WR7.js +43 -0
  178. package/dist/status-RO55QPKV.js +55 -0
  179. package/dist/status-UME2L33L.js +286 -0
  180. package/dist/stdio.d.ts +3 -13
  181. package/dist/stdio.js +16 -3186
  182. package/dist/sweep-35LGQTTO.js +18 -0
  183. package/dist/test-AGZOJLRZ.js +561 -0
  184. package/dist/tools-gpHNq9Dh.d.ts +328 -0
  185. package/dist/tui-G5LLWCSV.js +153 -0
  186. package/dist/unbroadcast-5QNGAJR2.js +18 -0
  187. package/dist/validate-IU52H2IC.js +46 -0
  188. package/dist/worker-QZ5T6LJD.js +80 -0
  189. package/dist/worktree-create-PZSRB7PH.js +89 -0
  190. package/dist/worktree-list-JYB6VXLW.js +51 -0
  191. package/dist/worktree-sync-UF5CXPWV.js +30 -0
  192. package/docs/authoring.md +82 -0
  193. package/docs/browser-and-desktop.md +46 -0
  194. package/docs/commands.md +325 -0
  195. package/docs/compare.md +35 -0
  196. package/docs/compatibility.md +55 -0
  197. package/docs/embeddings.md +1 -1
  198. package/docs/getting-started.md +105 -0
  199. package/docs/git-workflow.md +60 -0
  200. package/docs/glossary.md +31 -0
  201. package/docs/hooks/capabilities/antigravity.json +199 -0
  202. package/docs/hooks/capabilities/claude.json +179 -0
  203. package/docs/hooks/capabilities/codex.json +179 -0
  204. package/docs/hooks/capabilities/gemini.json +196 -0
  205. package/docs/hooks/capabilities/grok.json +192 -0
  206. package/docs/hooks/capabilities/opencode.json +184 -0
  207. package/docs/hooks.md +264 -0
  208. package/docs/install.md +72 -0
  209. package/docs/library-skills.md +132 -0
  210. package/docs/mailbox.md +16 -5
  211. package/docs/project-configuration.md +540 -58
  212. package/docs/sessions.md +64 -0
  213. package/docs/skills.md +4 -45
  214. package/docs/terminal-harness.md +92 -44
  215. package/docs/terminal-workspace.md +81 -169
  216. package/gemini-extension.json +2 -2
  217. package/mcp.json +1 -1
  218. package/package.json +16 -2
  219. package/plugin.json +2 -2
  220. package/plugins/pmcp/.claude-plugin/plugin.json +4 -2
  221. package/plugins/pmcp/.mcp.json +1 -1
  222. package/plugins/pmcp/gemini-extension.json +2 -2
  223. package/plugins/pmcp/mcp.json +1 -1
  224. package/plugins/pmcp/mod/commands.ts +72 -0
  225. package/plugins/pmcp/mod/contract.d.ts +39 -0
  226. package/plugins/pmcp/mod/draw.tsx +216 -0
  227. package/plugins/pmcp/mod/guard.ts +42 -0
  228. package/plugins/pmcp/mod/hooks.json +4 -0
  229. package/plugins/pmcp/mod/host.ts +46 -0
  230. package/plugins/pmcp/mod/model.ts +144 -0
  231. package/plugins/pmcp/mod/reader/index.ts +18 -0
  232. package/plugins/pmcp/mod/reader/read.ts +76 -0
  233. package/plugins/pmcp/mod/reader/settings.ts +54 -0
  234. package/plugins/pmcp/mod/reader/types.ts +38 -0
  235. package/plugins/pmcp/mod/register.tsx +73 -0
  236. package/plugins/pmcp/mod/sessions/format.ts +91 -0
  237. package/plugins/pmcp/mod/sessions/types.ts +162 -0
  238. package/plugins/pmcp/mod/snapshot.ts +75 -0
  239. package/plugins/pmcp/mod/spinner.tsx +30 -0
  240. package/plugins/pmcp/mod/state.ts +28 -0
  241. package/plugins/pmcp/plugin.json +2 -2
  242. package/plugins/pmcp/skills/agent-assets-migrate/SKILL.md +96 -0
  243. package/plugins/pmcp/skills/headless-agents-ci-scaffold/SKILL.md +101 -0
  244. package/plugins/pmcp/skills/marketplace-plugin-scaffold/SKILL.md +87 -0
  245. package/plugins/pmcp/skills/package-skill-catalog/SKILL.md +51 -15
  246. package/plugins/pmcp/skills/pmcp-browser/SKILL.md +27 -0
  247. package/plugins/pmcp/skills/pmcp-desktop/SKILL.md +25 -0
  248. package/plugins/pmcp/skills/pmcp-project-init/SKILL.md +153 -0
  249. package/plugins/pmcp/skills/pmcp-sessions-and-git/SKILL.md +96 -0
  250. package/plugins/pmcp/skills/skill-package-scaffold/SKILL.md +89 -0
  251. package/schema/catalog-v1.json +187 -0
  252. package/schema/library.json +196 -0
  253. package/schema/marketplace-manifest.json +144 -0
  254. package/schema/plugin-manifest.json +59 -0
  255. package/schema/skill-frontmatter.json +170 -0
  256. package/schema/skill-metadata-core.json +131 -0
  257. package/skills/agent-assets-migrate/SKILL.md +96 -0
  258. package/skills/headless-agents-ci-scaffold/SKILL.md +101 -0
  259. package/skills/marketplace-plugin-scaffold/SKILL.md +87 -0
  260. package/skills/package-skill-catalog/SKILL.md +51 -15
  261. package/skills/pmcp-browser/SKILL.md +27 -0
  262. package/skills/pmcp-desktop/SKILL.md +25 -0
  263. package/skills/pmcp-project-init/SKILL.md +153 -0
  264. package/skills/pmcp-sessions-and-git/SKILL.md +96 -0
  265. package/skills/skill-package-scaffold/SKILL.md +89 -0
  266. package/dist/config-BkSpjUG6.d.ts +0 -50
  267. package/dist/embed-DRROSD3F.d.ts +0 -53
  268. package/dist/hook-spec-CSJJySsH.d.ts +0 -11
  269. package/dist/server-VWSY3Shw.d.ts +0 -543
  270. package/dist/tui-worker.js +0 -6549
  271. package/docs/manual-library-skills.md +0 -74
  272. /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.17.4",
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" },
@@ -445,7 +445,7 @@
445
445
  },
446
446
  {
447
447
  "name": "pmcp",
448
- "version": "0.17.4",
448
+ "version": "0.18.2",
449
449
  "description": "Find package skills and use native runtime project configuration.",
450
450
  "source": "./plugins/pmcp"
451
451
  },
@@ -1,9 +1,9 @@
1
1
  {
2
2
  "name": "pmcp",
3
- "version": "0.17.4",
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/skills/"
8
+ "homepage": "https://pmcp.build/"
9
9
  }
package/.mcp.json CHANGED
@@ -3,7 +3,7 @@
3
3
  "pmcp": {
4
4
  "type": "stdio",
5
5
  "command": "npx",
6
- "args": ["-y", "@modootoday/pmcp@0.13.1", "serve"]
6
+ "args": ["-y", "@modootoday/pmcp@0.18.2", "serve"]
7
7
  }
8
8
  }
9
9
  }
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`)
@@ -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 discovers `SKILL.md` documents in installed packages, workspace packages
7
- and plugin marketplaces. Your AI tool can search the catalog and open a skill
8
- when it needs one, without loading the entire catalog into each conversation.
9
-
10
- Claude Code, Codex, Gemini CLI, Grok Build and Antigravity keep their native
11
- model calls, account login and permission controls. pmcp supplies skills,
12
- projects shared configuration into their native formats, and optionally provides
13
- a local mailbox for exchanging messages.
14
-
15
- | What you want to do | Use |
16
- | ------------------------------------------------------------- | ------------------------------ |
17
- | Find and read package skills from your AI tool | The MCP skill catalog |
18
- | Install selected free library instructions as native plugins | The PMCP public marketplace |
19
- | Keep several tools' MCP servers and project assets consistent | `pmcp.toml` and `pmcp project` |
20
- | Check what an installed tool loads | `pmcp doctor` |
21
- | Search across languages using local embeddings | `pmcp models` and `pmcp index` |
22
- | Exchange messages between authorized local actors | The optional mailbox |
23
- | Supervise native main and worker terminals locally | `pmcp harness` |
24
- | View a native main, worker dock and coordination panel | `pmcp tui` |
25
- | Serve a catalog to your own application | The HTTP library |
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 can use a stdio entry:
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
- Restart or reconnect your tool's MCP connection after changing its configuration.
57
- Ask your tool to find a skill relevant to your task and open the result.
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
- ## Native plugins and free library skills
48
+ ## Find your first skill
61
49
 
62
- The public GitHub repository is also a marketplace. Choose individual library
63
- major lines; adding the marketplace does not activate its entire catalog.
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
- claude plugin marketplace add modootoday/pmcp
68
- claude plugin install typescript-5@pmcp
69
- claude plugin install pmcp@pmcp
54
+ npx @modootoday/pmcp list
70
55
  ```
71
56
 
72
- ```sh
73
- codex plugin marketplace add modootoday/pmcp
74
- codex plugin add typescript-5@pmcp
75
- codex plugin add pmcp@pmcp
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
- Grok supports the same marketplace with `grok plugin marketplace add modootoday/pmcp`
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
- Since 0.14.0, the CLI bundles the free catalog and can export one
85
- plugin for Claude, Codex, Gemini, Grok or Antigravity:
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
- pmcp marketplace list
89
- pmcp marketplace export typescript-5 --runtime agy --output ./typescript-plugin
90
- agy plugin install ./typescript-plugin
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
- Run `npx @modootoday/pmcp list` to see the local catalog. Paths in the configuration resolve
106
- relative to `pmcp.toml`; pmcp searches for this file above the working directory.
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 project
124
- npx @modootoday/pmcp project --check
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` generates native files for the selected tools and records its ownership
129
- in `pmcp.lock`. It preserves unrelated settings and refuses conflicting unmanaged
130
- entries. `--check` reports drift without writing files. Each runtime retains its
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
- PMCP 0.13.0 or later can show a native main runtime, its worker terminals and a
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
- Once the workspace is open, press Ctrl-g then n to choose and confirm a worker.
177
- The menu releases input control and preserves the current draft. You can also use
178
- `pmcp tui start-worker --runtime gemini-cli`. The existing group keeps its
179
- runtime grants and resource bounds. Use `pmcp tui recovery` to inspect a saved
180
- workspace and obtain explicit next commands after an interrupted start. Inspection
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
- `pmcp tui plan` previews the settings without starting anything. The
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
- ## Everyday commands
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
- Run these with `npx @modootoday/pmcp`, or with `pmcp` when it is on your PATH:
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 install <skill-package> --yes
199
- pmcp sync --dry-run
200
- pmcp validate
124
+ pmcp validate # check skill documents
125
+ pmcp status # features, drift, live sessions
126
+ pmcp --help
201
127
  ```
202
128
 
203
- `available` checks catalog packages against your installed dependencies.
204
- `install` and `sync` use npm, Bun or pnpm and require confirmation
205
- before changing your manifest and lockfile. `--dry-run` previews the work.
206
- Use `--catalog <file>` to read a saved catalog response.
207
-
208
- These commands use the bundled public catalog by default.
209
- Public installation downloads verified content-only archives without PMCP login.
210
- Use `--provider hosted` or an explicit `--api` for a separately hosted service.
211
- CLI discovery includes the free marketplace unless `--no-builtin` is passed or
212
- `[catalog] builtin = false` is configured. Library APIs keep explicit catalog selection.
213
-
214
- `pmcp login`, `whoami` and `logout` manage optional hosted-service login.
215
- skills.modoo.today is a separate service built on PMCP. Your runtime's provider
216
- login remains with that runtime.
217
-
218
- Run `pmcp --help` or `pmcp <command> --help` for options.
219
- With no command, a supported interactive terminal opens the workspace. Piped
220
- launches retain MCP stdio; `pmcp serve` selects MCP explicitly. Unsupported
221
- interactive hosts show help and prerequisite guidance.
222
-
223
- ## Compatibility
224
-
225
- | Surface | Current qualification |
226
- | -------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
227
- | CLI and MCP on Linux amd64 | Published 0.15.0 passed clean Docker installation with npm on Debian/Alpine and Bun/pnpm on Debian; 60 installation and failure contracts |
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
- See [NOTICE](NOTICE) for dependency notices and the embedding guide for model
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).