@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.
Files changed (156) 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/CONTRIBUTING.md +80 -0
  6. package/README.md +100 -206
  7. package/SECURITY.md +17 -1
  8. package/dist/{apply-4IGTXOCQ.js → apply-S2QI72W3.js} +13 -13
  9. package/dist/{available-DBSIVVJ6.js → available-GFMTJW4E.js} +3 -3
  10. package/dist/{broadcast-3RY3OZGY.js → broadcast-CBMVOV3G.js} +4 -4
  11. package/dist/{chunk-SG5TPMKH.js → chunk-26WLNWDG.js} +2 -2
  12. package/dist/{chunk-4VCC2NXE.js → chunk-2RTRY45B.js} +2 -2
  13. package/dist/{chunk-3NYG4SGU.js → chunk-3MEYKFFO.js} +3 -3
  14. package/dist/{chunk-KMXRRSKT.js → chunk-4CRRLDDS.js} +1 -1
  15. package/dist/{chunk-ZH6R642Z.js → chunk-4GSGT55G.js} +2 -2
  16. package/dist/{chunk-EJBZGIDK.js → chunk-6BN35BHI.js} +3 -3
  17. package/dist/{chunk-T3LKX23M.js → chunk-7B6IC3F7.js} +3 -3
  18. package/dist/{chunk-25GHX674.js → chunk-7DEYLLIE.js} +9 -9
  19. package/dist/{chunk-ELAGZ635.js → chunk-7PTG42QU.js} +5 -5
  20. package/dist/chunk-AF2IBMWN.js +7 -0
  21. package/dist/{chunk-IGYRMM62.js → chunk-CKTN6LKP.js} +2 -2
  22. package/dist/{chunk-PLX3BOOS.js → chunk-E5XVSMBR.js} +2 -2
  23. package/dist/{chunk-Q65R3XKX.js → chunk-EAWPJHJ7.js} +2 -2
  24. package/dist/{chunk-7BLPN3W6.js → chunk-F5LEGPGP.js} +2 -2
  25. package/dist/{chunk-BBTBJCFA.js → chunk-F5WBMUOT.js} +2 -2
  26. package/dist/{chunk-YMHUM7AV.js → chunk-F5XMGOOX.js} +7 -1
  27. package/dist/{chunk-R4L6LJJ2.js → chunk-FX3LTTMB.js} +2 -2
  28. package/dist/{chunk-5QQWS4US.js → chunk-HEBCQTOD.js} +2 -2
  29. package/dist/{chunk-NZS5CD72.js → chunk-HEWZ6INU.js} +21 -5
  30. package/dist/{chunk-MWFOUBFC.js → chunk-HFE4QDJQ.js} +2 -2
  31. package/dist/{chunk-N5AQ3PP7.js → chunk-HQWVGU3W.js} +5 -5
  32. package/dist/{chunk-UOCLRM7P.js → chunk-IIBB37JE.js} +22 -22
  33. package/dist/{chunk-MPSQXSC6.js → chunk-ISZOLR3D.js} +5 -3
  34. package/dist/{chunk-J6QLLQVL.js → chunk-JM2KR2WJ.js} +5 -5
  35. package/dist/{chunk-CJTKR6K6.js → chunk-JZK7ZO7K.js} +2 -2
  36. package/dist/{chunk-RK4PYD7L.js → chunk-LBXO4VPG.js} +2 -2
  37. package/dist/{chunk-BVCTKPT3.js → chunk-LMUBBIE2.js} +2 -2
  38. package/dist/{chunk-Z4HRRXRF.js → chunk-LTZH5E3G.js} +6 -5
  39. package/dist/{chunk-MM2Y43LC.js → chunk-M455QSCW.js} +3 -3
  40. package/dist/{chunk-7GBYECSK.js → chunk-NLHLA2N5.js} +3 -3
  41. package/dist/{chunk-HDMBVLCZ.js → chunk-NWOV2E26.js} +2 -2
  42. package/dist/{chunk-PWSJJXLQ.js → chunk-QK4G7FCU.js} +8 -8
  43. package/dist/{chunk-47O3X4VS.js → chunk-QRCAGKC6.js} +1 -1
  44. package/dist/{chunk-665TA55Z.js → chunk-TAOOPXBV.js} +2 -2
  45. package/dist/{chunk-JUXNIXN4.js → chunk-TZORR6GZ.js} +2 -2
  46. package/dist/{chunk-LAZQBMAU.js → chunk-WM2RF2MI.js} +3 -3
  47. package/dist/{chunk-65ZHM5RH.js → chunk-XJUNAVU2.js} +9 -9
  48. package/dist/{chunk-TNCZ6444.js → chunk-Y2XASHVY.js} +2 -2
  49. package/dist/{cli-VYCQJZ5X.js → cli-MI4ZCAZ3.js} +9 -9
  50. package/dist/{cli-ZTCBSDW4.js → cli-ZN7ZVDEZ.js} +3 -3
  51. package/dist/cli.js +4 -4
  52. package/dist/{completion-E7RRG3ZT.js → completion-GYN7PX3T.js} +3 -3
  53. package/dist/{diagnostics-XXH4FLUG.js → diagnostics-WACXQ33W.js} +6 -6
  54. package/dist/{doctor-ZIOESU3N.js → doctor-VSQ72A6X.js} +13 -13
  55. package/dist/{entry-ZNFCTDVE.js → entry-VFEZC2XB.js} +10 -10
  56. package/dist/{exec-mcp-X6372BLE.js → exec-mcp-TOQEJFK3.js} +8 -8
  57. package/dist/{harness-F2XFDYXF.js → harness-XCEWFGCG.js} +5 -5
  58. package/dist/harness-launch-gate.js +4 -4
  59. package/dist/harness-worker.js +6 -6
  60. package/dist/hook-body.js +7 -6
  61. package/dist/{hooks-FYE2L5RW.js → hooks-32AFBC3Z.js} +3 -3
  62. package/dist/{host-X6BR6X4O.js → host-72OLHUX7.js} +20 -10
  63. package/dist/{host-GRY3VAHH.js → host-TE5PNDHJ.js} +7 -7
  64. package/dist/{host-run-GCA6H6SR.js → host-run-MXCH26ZD.js} +5 -5
  65. package/dist/http.js +5 -5
  66. package/dist/{import-mcp-2TTBPVLY.js → import-mcp-QWGZSIZR.js} +6 -6
  67. package/dist/index.d.ts +1 -1
  68. package/dist/index.js +18 -18
  69. package/dist/{init-627KFXTG.js → init-5M3XWOTJ.js} +2 -2
  70. package/dist/{install-GG7HHZK2.js → install-MQ7QSJQ7.js} +3 -3
  71. package/dist/{invoke-LW22Z6ET.js → invoke-SFSN4XT7.js} +8 -8
  72. package/dist/{list-MCP2FXUF.js → list-FB6RNYYB.js} +3 -3
  73. package/dist/{list-NGMSQ5SH.js → list-FGDUU5DL.js} +8 -8
  74. package/dist/{logout-6CSHUWWE.js → logout-KM5N5GOC.js} +7 -7
  75. package/dist/{logs-SPB6AANY.js → logs-TBUA4UWU.js} +4 -4
  76. package/dist/mailbox/index.js +4 -4
  77. package/dist/{mailbox-GDJ7BWQN.js → mailbox-5DWLH4W2.js} +3 -3
  78. package/dist/{mailbox-7BV54Q4R.js → mailbox-BMTZOSZ7.js} +4 -4
  79. package/dist/{mainline-JQTTYJMI.js → mainline-KAD2ERLP.js} +2 -2
  80. package/dist/{mcp-V23HC3LB.js → mcp-FJ2UQ4RH.js} +2 -2
  81. package/dist/{mcp-2DKVU3SW.js → mcp-ND6ZQWJE.js} +2 -2
  82. package/dist/{pause-FFAYRBWI.js → pause-7LILUVGL.js} +4 -4
  83. package/dist/{project-FY62G55N.js → project-LZKQUV2W.js} +4 -4
  84. package/dist/{reindex-Y27QJFDB.js → reindex-ZULHSQWY.js} +5 -5
  85. package/dist/{resume-UU4HZIUP.js → resume-26VFAAMH.js} +4 -4
  86. package/dist/{run-HALGEJNJ.js → run-X4663F4M.js} +4 -4
  87. package/dist/{run-OGA3P7FC.js → run-YEVGHGTN.js} +7 -7
  88. package/dist/{serve-NBKT5BKY.js → serve-S7MF42SS.js} +12 -12
  89. package/dist/{start-login-UIQYQBMC.js → start-login-GKFGTE2A.js} +7 -7
  90. package/dist/{status-NOOHW5WA.js → status-FYG6XYQ6.js} +7 -7
  91. package/dist/{status-VHODZPXB.js → status-RO55QPKV.js} +4 -4
  92. package/dist/{status-XQANBVXW.js → status-XG5GRWVU.js} +11 -11
  93. package/dist/stdio.js +7 -7
  94. package/dist/{sweep-64JDCGK6.js → sweep-35LGQTTO.js} +4 -4
  95. package/dist/{test-MKAXFJOL.js → test-KFDO6ROC.js} +7 -7
  96. package/dist/{tui-MWKAXE4K.js → tui-2MP7DRIX.js} +5 -5
  97. package/dist/{unbroadcast-KPUEFLZD.js → unbroadcast-5QNGAJR2.js} +4 -4
  98. package/dist/{validate-5GZ5YWNA.js → validate-AVM2VHMM.js} +4 -4
  99. package/dist/{worker-RQ575EJL.js → worker-3VS6RQEL.js} +8 -8
  100. package/docs/authoring.md +82 -0
  101. package/docs/browser-and-desktop.md +46 -0
  102. package/docs/commands.md +325 -0
  103. package/docs/compare.md +35 -0
  104. package/docs/compatibility.md +56 -0
  105. package/docs/embeddings.md +1 -1
  106. package/docs/getting-started.md +105 -0
  107. package/docs/git-workflow.md +60 -0
  108. package/docs/glossary.md +31 -0
  109. package/docs/hooks.md +264 -0
  110. package/docs/install.md +72 -0
  111. package/docs/known-issues.md +17 -0
  112. package/docs/library-skills.md +132 -0
  113. package/docs/mailbox.md +16 -5
  114. package/docs/project-configuration.md +51 -386
  115. package/docs/sessions.md +64 -0
  116. package/docs/skills.md +4 -45
  117. package/docs/terminal-harness.md +26 -21
  118. package/docs/terminal-workspace.md +4 -13
  119. package/docs/upgrading.md +23 -0
  120. package/gemini-extension.json +2 -2
  121. package/mcp.json +1 -1
  122. package/package.json +8 -7
  123. package/plugin.json +2 -2
  124. package/plugins/pmcp/.claude-plugin/plugin.json +2 -2
  125. package/plugins/pmcp/.mcp.json +1 -1
  126. package/plugins/pmcp/gemini-extension.json +2 -2
  127. package/plugins/pmcp/mcp.json +1 -1
  128. package/plugins/pmcp/mod/sessions/types.ts +1 -1
  129. package/plugins/pmcp/plugin.json +2 -2
  130. package/plugins/pmcp/skills/agent-assets-migrate/SKILL.md +8 -8
  131. package/plugins/pmcp/skills/headless-agents-ci-scaffold/SKILL.md +12 -11
  132. package/plugins/pmcp/skills/marketplace-plugin-scaffold/SKILL.md +10 -8
  133. package/plugins/pmcp/skills/package-skill-catalog/SKILL.md +0 -4
  134. package/plugins/pmcp/skills/pmcp-browser/SKILL.md +27 -0
  135. package/plugins/pmcp/skills/pmcp-desktop/SKILL.md +25 -0
  136. package/plugins/pmcp/skills/pmcp-project-init/SKILL.md +19 -11
  137. package/plugins/pmcp/skills/pmcp-sessions-and-git/SKILL.md +20 -28
  138. package/plugins/pmcp/skills/skill-package-scaffold/SKILL.md +16 -15
  139. package/schema/catalog-v1.json +36 -7
  140. package/schema/library.json +40 -8
  141. package/schema/marketplace-manifest.json +19 -5
  142. package/schema/plugin-manifest.json +6 -2
  143. package/schema/skill-frontmatter.json +33 -7
  144. package/schema/skill-metadata-core.json +26 -5
  145. package/skills/agent-assets-migrate/SKILL.md +8 -8
  146. package/skills/headless-agents-ci-scaffold/SKILL.md +12 -11
  147. package/skills/marketplace-plugin-scaffold/SKILL.md +10 -8
  148. package/skills/package-skill-catalog/SKILL.md +0 -4
  149. package/skills/pmcp-browser/SKILL.md +27 -0
  150. package/skills/pmcp-desktop/SKILL.md +25 -0
  151. package/skills/pmcp-project-init/SKILL.md +19 -11
  152. package/skills/pmcp-sessions-and-git/SKILL.md +20 -28
  153. package/skills/skill-package-scaffold/SKILL.md +16 -15
  154. package/CHANGELOG.md +0 -60
  155. package/dist/chunk-E7OOHLQR.js +0 -7
  156. package/docs/manual-library-skills.md +0 -74
@@ -612,7 +612,7 @@
612
612
  },
613
613
  {
614
614
  "name": "pmcp",
615
- "version": "0.18.0",
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" },
@@ -445,7 +445,7 @@
445
445
  },
446
446
  {
447
447
  "name": "pmcp",
448
- "version": "0.18.0",
448
+ "version": "0.18.3",
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.18.0",
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/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.3", "serve"]
7
7
  }
8
8
  }
9
9
  }
@@ -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 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,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 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
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
- On a supported interactive host, open the workspace with:
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
- Add a worker with `pmcp tui start-worker --runtime gemini-cli`; it appears in
183
- the workspace's dock. The existing group keeps its
184
- runtime grants and resource bounds. Use `pmcp tui recovery` to inspect a saved
185
- workspace and obtain explicit next commands after an interrupted start. Inspection
186
- 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.
187
108
 
188
- `pmcp tui plan` previews the settings without starting anything. The
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
- ## 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.
196
117
 
197
- Run these with `npx @modootoday/pmcp`, or with `pmcp` when it is on your PATH:
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 install <skill-package> --yes
204
- pmcp sync --dry-run
205
- pmcp validate
124
+ pmcp validate # check skill documents
125
+ pmcp status # features, drift, live sessions
126
+ pmcp --help
206
127
  ```
207
128
 
208
- `available` checks catalog packages against your installed dependencies.
209
- `install` and `sync` use npm, Bun or pnpm and require confirmation
210
- before changing your manifest and lockfile. `--dry-run` previews the work.
211
- Use `--catalog <file>` to read a saved catalog response.
212
-
213
- These commands use the bundled public catalog by default.
214
- Public installation downloads verified content-only archives without PMCP login.
215
- Use `--provider hosted` or an explicit `--api` for a separately hosted service.
216
- CLI discovery includes the free marketplace unless `--no-builtin` is passed or
217
- `[catalog] builtin = false` is configured. Library APIs keep explicit catalog selection.
218
-
219
- `pmcp login`, `whoami` and `logout` manage optional hosted-service login.
220
- skills.modoo.today is a separate service built on PMCP. Your runtime's provider
221
- login remains with that runtime.
222
-
223
- Run `pmcp --help` or `pmcp <command> --help` for options.
224
- With no command, a supported interactive terminal opens the workspace. Piped
225
- launches retain MCP stdio; `pmcp serve` selects MCP explicitly. Unsupported
226
- interactive hosts show help and prerequisite guidance.
227
-
228
- ## Compatibility
229
-
230
- | Surface | Current qualification |
231
- | -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
232
- | 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 |
233
- | Optional terminal workspace | Linux pmcp-pty checks and a native Claude main with a Gemini worker (control, input, wake turns, recovery); other runtimes measured on tmux in 0.17 |
234
- | Public skill installation | npm, Bun and pnpm 10.17.1; confirmation required, scripts disabled |
235
- | Native plugin export | Claude, Codex, Gemini, Grok and agy formats; export does not install or activate a vendor plugin |
236
- | pnpm workspace installation | Selects the member, preserves root dependencies and updates the shared lockfile |
237
- | Yarn skill installation | Refused without changing project files; Yarn PnP is not supported |
238
- | macOS, Windows and other architectures | Not qualified by the Linux Docker tests; macOS terminal binaries ship unsigned, Windows is not supported yet |
239
-
240
- Provider authentication, native children and vendor behavior have separate
241
- qualification scopes. An installed executable or exported manifest is not proof
242
- that every native feature works. The packed-package check, run before a
243
- release, covers actual archive installation, CLI startup, MCP and SQLite; isolated projects
244
- on a host are distinct from Docker and OS qualification.
245
-
246
- ## Guides
247
-
248
- | Guide | Contents |
249
- | ------------------------------------------------------ | ------------------------------------------------------------- |
250
- | [Project configuration](docs/project-configuration.md) | Catalog sources, native files, MCP import, guards and doctor |
251
- | [Skills and MCP reference](docs/skills.md) | Skill documents, tools, resources, prompts and compatibility |
252
- | [Embedding models](docs/embeddings.md) | E5, EmbeddingGemma and custom local model selection |
253
- | [Local mailbox](docs/mailbox.md) | Actor credentials, messages, receipts and library integration |
254
- | [HTTP hosting](docs/hosting.md) | Authentication, catalog access and request controls |
255
- | [Native terminal control](docs/terminal-harness.md) | Owned sessions, explicit input, Docker profiles and recovery |
256
- | [Terminal workspace](docs/terminal-workspace.md) | Main and worker panels, observation, control and failures |
257
- | [Security policy](SECURITY.md) | Reporting vulnerabilities |
258
-
259
- Semantic search is optional and requires `@huggingface/transformers` installed
260
- separately. Lexical search works without downloading a model. The mailbox is
261
- disabled until explicitly configured.
129
+ The [command reference](docs/commands.md) lists every command, flag and exit
130
+ code.
131
+
132
+ ## Documentation
133
+
134
+ | Page | For |
135
+ | ------------------------------------------------------------ | ----------------------------------------------------------- |
136
+ | [Getting started](docs/getting-started.md) | connecting a tool and finding skills |
137
+ | [pmcp.toml reference](docs/project-configuration.md) | every `pmcp.toml` table with its keys and defaults |
138
+ | [Hooks](docs/hooks.md) | guards and checks, and which runtime supports what |
139
+ | [Git workflow](docs/git-workflow.md) | linked worktrees, delivery and sync |
140
+ | [Browser and desktop](docs/browser-and-desktop.md) | pmcp-browser and pmcp-desktop for agents |
141
+ | [Library skills](docs/library-skills.md) | free library instructions as plugins, npm packages or files |
142
+ | [Run several agents](docs/sessions.md) | sessions, messages, leases, worktrees and delivery |
143
+ | [Skills and MCP reference](docs/skills.md) | skill layouts, tools, resources and the marketplace |
144
+ | [Terminal workspace](docs/terminal-workspace.md) | the `pmcp tui` workspace |
145
+ | [Native terminal control](docs/terminal-harness.md) | harness groups, control, recovery and `[host]` |
146
+ | [Embedding models](docs/embeddings.md) | semantic search with a local model |
147
+ | [Local mailbox](docs/mailbox.md) | messages between actors with their own credentials |
148
+ | [HTTP hosting](docs/hosting.md) | serving a catalog from your application |
149
+ | [Command reference](docs/commands.md) | commands, flags and exit codes |
150
+ | [Compatibility](docs/compatibility.md) | platforms, runtimes and qualification |
151
+ | [Glossary](docs/glossary.md) | the terms these pages use |
152
+ | [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
- See [NOTICE](NOTICE) for dependency notices and the embedding guide for model
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 Bun.
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-7BLPN3W6.js";
3
+ } from "./chunk-F5LEGPGP.js";
4
4
  import {
5
5
  catalogFrom
6
- } from "./chunk-5QQWS4US.js";
6
+ } from "./chunk-HEBCQTOD.js";
7
7
  import "./chunk-7DLZC73N.js";
8
8
  import {
9
9
  project
10
- } from "./chunk-N5AQ3PP7.js";
10
+ } from "./chunk-HQWVGU3W.js";
11
11
  import "./chunk-P4N7DBD5.js";
12
12
  import {
13
13
  renderFrontmatter,
14
14
  splitFrontmatter
15
- } from "./chunk-J6QLLQVL.js";
16
- import "./chunk-PLX3BOOS.js";
15
+ } from "./chunk-JM2KR2WJ.js";
16
+ import "./chunk-E5XVSMBR.js";
17
17
  import {
18
18
  RUNTIMES
19
- } from "./chunk-65ZHM5RH.js";
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-SG5TPMKH.js";
33
- import "./chunk-Z4HRRXRF.js";
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-KMXRRSKT.js";
42
+ } from "./chunk-4CRRLDDS.js";
43
43
  import "./chunk-YSAWTGNA.js";
44
- import "./chunk-4VCC2NXE.js";
44
+ import "./chunk-2RTRY45B.js";
45
45
  import {
46
46
  recordProjector
47
- } from "./chunk-665TA55Z.js";
47
+ } from "./chunk-TAOOPXBV.js";
48
48
  import "./chunk-OEH47H6A.js";
49
49
  import "./chunk-IJBSOWHK.js";
50
- import "./chunk-E7OOHLQR.js";
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-4IGTXOCQ.js.map
242
+ //# sourceMappingURL=apply-S2QI72W3.js.map
@@ -4,7 +4,7 @@ import {
4
4
  import {
5
5
  matchingSkills,
6
6
  readInstalledDependencies
7
- } from "./chunk-BBTBJCFA.js";
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-KMXRRSKT.js";
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-DBSIVVJ6.js.map
73
+ //# sourceMappingURL=available-GFMTJW4E.js.map
@@ -1,8 +1,8 @@
1
1
  import {
2
2
  change
3
- } from "./chunk-RK4PYD7L.js";
4
- import "./chunk-SG5TPMKH.js";
5
- import "./chunk-Z4HRRXRF.js";
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-3RY3OZGY.js.map
18
+ //# sourceMappingURL=broadcast-CBMVOV3G.js.map