@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
@@ -1,21 +1,19 @@
1
1
  # Terminal workspace
2
2
 
3
- Use `pmcp tui` to view an existing main runtime and its workers in one terminal.
4
- The main conversation stays in its native interface. PMCP adds a worker dock,
3
+ Use `pmcp tui` to view a main runtime and its workers in one terminal. The main
4
+ conversation stays in its native interface. PMCP adds a worker dock, a
5
5
  coordination panel and explicit control switching. Provider login, folder trust
6
- and tool approvals stay in their native screens.
6
+ and tool approvals stay in their native screens. Sessions that pmcp-pty hosts
7
+ from a `[host]` you approved are the one place where listed tool dialogs
8
+ may be answered for you (see
9
+ [Sessions pmcp-pty hosts](project-configuration.md#sessions-pmcp-pty-hosts)).
7
10
 
8
- This feature requires PMCP 0.13.0 or later. The host requires Linux, tmux,
9
- util-linux flock, Node.js 22 or later and a working
10
- user systemd manager. The PMCP CLI supports Node or Bun; pane helpers use Node.
11
- The presentation gets its own 512 MiB, 128-task, one-CPU scope. Native sessions
12
- retain their existing group budgets and execution profile.
11
+ pmcp-tui (`crates/pmcp-tui`) draws the workspace on the group's pmcp-pty host
12
+ (`crates/pmcp-pty`), and npm installs both with pmcp. It runs on Linux and macOS;
13
+ [Compatibility](compatibility.md) lists what each platform needs.
13
14
 
14
15
  ## Open a workspace
15
16
 
16
- The numbered runtime picker, worker menu and worker-start/recovery commands in
17
- this guide require PMCP 0.16.0 or later.
18
-
19
17
  From a supported interactive terminal, run `pmcp` or `pmcp tui`. The first
20
18
  launch lists installed runtimes, with a default in this order: Codex, Gemini,
21
19
  agy, Grok, Claude. Enter accepts that default; a number selects another runtime.
@@ -30,42 +28,26 @@ pmcp tui --runtime codex-cli
30
28
  pmcp tui plan
31
29
  ```
32
30
 
33
- The start creates a private owned group and read-only view, then reconnects to
34
- that workspace on later launches. Defaults are 2048 MiB for the group, 768 MiB
35
- for its main and at most two active sessions. Terminal size selects the existing
36
- A or compact layout. Taking control remains explicit with Ctrl-g then c.
31
+ The start creates a private owned group with its own pmcp-pty host and opens
32
+ pmcp-tui on it, read-only, with main shown first. Later launches reconnect to
33
+ that workspace. Defaults are 2048 MiB for the group, 768 MiB for its main and at
34
+ most two active sessions. Taking control remains explicit with Ctrl-g then c.
37
35
  This launches a native process; the defaults are cooperative host supervision,
38
36
  not a Docker isolation policy. Use an explicitly configured Docker group when
39
37
  you require that execution profile.
40
38
 
41
- After opening a workspace, start a worker without preparing a session JSON file:
39
+ Start a worker in the saved project workspace without preparing a session JSON
40
+ file:
42
41
 
43
42
  ```sh
44
43
  pmcp tui start-worker --runtime gemini-cli
45
44
  ```
46
45
 
47
- This explicitly starts a worker in the saved project workspace. It uses the
48
- configured session memory by default; `--memory-mb` overrides that reservation.
49
- The existing group retains its allowed runtimes, execution profile and budgets.
50
- An unavailable main, paused group or stale generation blocks the start. Native
51
- login, folder trust and tool approvals remain in the worker's own screen.
52
-
53
- In the view, Ctrl-g then n opens a worker picker. It releases input control
54
- without submitting the main draft. Select a granted installed runtime and
55
- confirm its start; q cancels without creating a worker. The new worker reserves
56
- the same memory as the live main, within the existing group limits. Selection
57
- does not switch the input target or acquire control. To use a different
58
- reservation or an advanced view, run:
59
-
60
- ```sh
61
- pmcp tui start-worker --view "$VIEW_FILE" --runtime gemini-cli --memory-mb 512
62
- ```
63
-
64
- Use either --view or --config. A view start uses its owned group and generation;
65
- it does not discover another project workspace. Docker runtime availability
66
- follows that group's command policy rather than host native executables.
67
- This worker menu is qualified on native groups; Docker execution remains subject
68
- to its separately tested CLI and profile grants.
46
+ It uses the configured session memory by default; `--memory-mb` overrides that
47
+ reservation. The existing group retains its allowed runtimes, execution profile
48
+ and budgets. An unavailable main, paused group or stale generation blocks the
49
+ start. The new worker appears in the dock. Native login, folder trust and tool
50
+ approvals remain in the worker's own screen.
69
51
 
70
52
  The nearest `pmcp.toml` within the Git repository determines the project root,
71
53
  including from nested cwd. A submodule does not inherit its parent's config;
@@ -94,145 +76,87 @@ resolved settings and saved paths without writing or invoking a provider.
94
76
  The launcher checkpoint lives under XDG_STATE_HOME/pmcp/launcher, or
95
77
  ~/.local/state/pmcp/launcher, with private file permissions.
96
78
 
97
- Reopening never adopts an unrelated tmux session or restarts a stopped main.
98
- A paused group, interrupted start or changed generation requires explicit
99
- harness inspection and recovery. After explicitly stopping the old owned group,
79
+ Reopening never adopts an unrelated session or restarts a stopped main. A
80
+ paused group, interrupted start or changed generation requires explicit harness
81
+ inspection and recovery. After explicitly stopping the old owned group,
100
82
  `pmcp tui --new` creates a new workspace. Detach preserves the existing native
101
- process and draft. Closing only the view permits a new presentation over the
102
- same live group. Keep original state when investigating a failed start.
103
- If a creation checkpoint has no group path yet, keep it for manual inspection;
104
- the launcher refuses to infer ownership or restart from that incomplete state.
83
+ process and draft. Keep original state when investigating a failed start. If a
84
+ creation checkpoint has no group path yet, keep it for manual inspection; the
85
+ launcher refuses to infer ownership or restart from that incomplete state.
86
+
87
+ Workspaces created by releases that used tmux are not migrated. Close them with
88
+ the release that created them, then start a new one here. The tmux view
89
+ operations (`pmcp tui create`, `open`, `close` and the others taking `--view`)
90
+ are removed: they end with a usage error (exit 2) that names the change.
105
91
 
106
92
  Piped bare launches and leading MCP server options preserve the existing stdio
107
93
  contract. Use `pmcp serve` explicitly in MCP configuration. Unsupported
108
94
  interactive hosts show help; they do not wait for JSON-RPC input.
109
95
 
110
- ## Advanced view operations
96
+ `pmcp tui doctor` checks the host: platform, Node, pmcp-pty, pmcp-tui and on
97
+ Linux the systemd tools and user manager. It lists native executables found on
98
+ PATH; an installed executable is not proof of authentication or successful
99
+ native behavior.
111
100
 
112
- First [create a harness group and its sessions](terminal-harness.md). Set GROUP_FILE
113
- to that group's private state path, then check prerequisites and create a view:
114
-
115
- ```sh
116
- pmcp --version
117
- pmcp tui doctor
118
- pmcp tui create --group-file "$GROUP_FILE" --columns 160 --rows 48
119
- ```
120
-
121
- Set VIEW_FILE to viewFile from the JSON receipt:
122
-
123
- ```sh
124
- pmcp tui inspect --view "$VIEW_FILE"
125
- pmcp tui open --view "$VIEW_FILE"
126
- ```
101
+ ## Layout
127
102
 
128
- Only open requires an interactive terminal. Create can take its dimensions from
129
- the current terminal; give both dimensions explicitly when calling from a script.
130
103
  At 120 columns by 32 rows or larger, main fills the left, workers appear on the
131
104
  right, and coordination occupies four bottom rows. Smaller terminals keep a
132
- full-width main and a separate management window. The minimum is 40 by 12.
133
- Views refer to an existing owned group and do not start a provider.
134
-
135
- Doctor checks host prerequisites, including access to the systemd user manager,
136
- and lists native executables found on PATH. An installed executable is not proof
137
- of authentication or successful native behavior. The report leaves native
138
- acceptance unassessed and does not read authentication profiles.
139
-
140
- | Finding | Next step |
141
- | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
142
- | Missing tmux or flock | Install tmux or util-linux for your Linux distribution and check PATH in this terminal. |
143
- | Unsupported Node | Select Node.js 22 or later through your existing version manager, then check node --version. |
144
- | Unreachable user manager | Run systemctl --user status in the same login session; restore manager access before launching. Doctor does not start services. |
145
- | Missing native runtime | Install the vendor's CLI and select its runtime ID explicitly. Installation alone does not establish login or folder trust. |
146
- | Unsupported terminal host | Use a qualified Linux host for this workspace. Other PMCP features keep their own prerequisites. |
147
-
148
- Doctor does not invoke a native runtime, inspect private authentication files,
149
- test a model reply or prove cgroup delegation. Native acceptance and isolated
150
- execution require separate measurements against the exact installed version.
151
-
152
- ### Measured terminal behavior
153
-
154
- Linux acceptance on 2026-10-10 covered the following native main/worker pairs.
155
- Each run checked read-only observation, explicit worker input with an actual
156
- reply, main draft preservation, resize and detach/reconnect. These bounded
157
- checks do not certify every vendor feature or another authentication profile.
158
-
159
- | Native runtime | Tested version | Main and worker terminal checks |
160
- | -------------- | ------------------------- | ------------------------------- |
161
- | Codex | 0.161.0 | Passed |
162
- | Gemini CLI | 0.63.0 | Passed |
163
- | Grok CLI | 1.0.50 | Passed |
164
- | agy | 1.3.3 | Passed |
165
- | Claude Code | Not measured in this wave | Deferred |
166
-
167
- Separate synthetic PTY checks cover multiline Korean paste, read-only mouse
168
- input, owned history and nested tmux. They do not establish each vendor's
169
- own editing or mouse behavior. Use Ctrl-g then h to read owned history without
170
- sending input. Claude acceptance, other operating systems and physical host
171
- loss remain outside these results. Docker installation and native credential
172
- isolation have separate qualification; this terminal run does not replace them.
105
+ full-width main; Ctrl-g then g shows the dock and coordination instead. The
106
+ minimum is 40 by 12. A shown session keeps its own size, so watching never
107
+ reflows a session someone else is driving; a session you control is resized to
108
+ the main pane.
173
109
 
174
110
  ## Observe and control
175
111
 
176
112
  Press Ctrl-g, release it, then press a key:
177
113
 
178
- | Key | Action | CLI operation |
179
- | -------- | -------------------------------------------- | ----------------------- |
180
- | m | Return to main and release worker control | main |
181
- | w or 1–4 | Observe a worker | observe --index 1 |
182
- | n | Choose and confirm a new worker | worker-menu |
183
- | c | Request control of the current native target | control |
184
- | r | Release control | release |
185
- | h | Read owned native history | history |
186
- | b | Show configured inbox metadata | mailbox |
187
- | g | Open compact management window | management |
188
- | d | Detach the view, preserving runtimes | detach |
189
- | ! | Dismiss the last visible error | dismiss |
190
- | ? | Show key help | Help in the status line |
191
-
192
- CLI operations use pmcp tui OPERATION --view "$VIEW_FILE". Worker indices follow
193
- the dock; CLI observe supports all available indices. Press Ctrl-g twice to
194
- forward Ctrl-g to the native interface. Native Ctrl-b remains available when
195
- you hold control. A surrounding tmux may consume its own prefix first.
196
-
197
- The status line identifies MAIN or WORKER, its session and OBSERVE / INPUT OFF.
198
- Control progresses through REQUESTING CONTROL and
199
- CONNECTING WRITER to CONTROL READY. A lease alone does not enable typing: PMCP
200
- checks that the writable native client is attached to the selected pane's TTY.
201
- Only CONTROL READY shows INPUT ON.
202
- Input stays blocked during acquisition and release. A control lease identifies
203
- the writer, not which native prompt or approval menu is active.
204
-
205
- Another writer causes a visible error with a next step. Failures remain in the
206
- status line, coordination panel and inspect receipt until explicitly dismissed.
207
- Resize does not clear them. CONTROL UNKNOWN blocks input and requires inspection.
208
- PMCP never replays uncertain input. An input receipt or mailbox ACK does not
114
+ | Key | Action |
115
+ | -------- | ------------------------------------------------ |
116
+ | m | Return to main, giving control back first |
117
+ | w or 1–9 | Observe a worker |
118
+ | c | Take control of the shown session |
119
+ | r | Give control back |
120
+ | h | Read the shown session's history |
121
+ | b | Show inbox metadata (when an observer is set up) |
122
+ | g | Show or hide the management screen (compact) |
123
+ | d | Leave the workspace, every session still running |
124
+ | ! | Dismiss the last visible error |
125
+ | ? | Show the keys |
126
+
127
+ Press Ctrl-g twice to send Ctrl-g to the native interface.
128
+
129
+ The status line names MAIN or WORKER, the session and OBSERVE / INPUT OFF.
130
+ Control goes through REQUESTING CONTROL and CONNECTING WRITER to CONTROL READY,
131
+ the only state with INPUT ON. Taking control holds the session's lease in
132
+ pmcp-pty, which then refuses any other writer and any program input (such as an
133
+ automatic wake) without it. Control is not taken while the runtime is mid-turn.
134
+ Leaving the session, or Ctrl-g r, gives the lease back first. A failed release
135
+ shows CONTROL UNKNOWN and keeps input off until Ctrl-g r succeeds. Even without
136
+ control, a person typing in an attachment wins over program input for five
137
+ seconds after the last keystroke.
138
+
139
+ Failures stay in the status line and coordination panel until dismissed. PMCP
140
+ never replays uncertain input. An input receipt or mailbox ACK does not
209
141
  establish model completion. Provider state remains unknown.
210
142
 
211
143
  ## History and mailbox
212
144
 
213
- History reads only the owned runtime pane, bounded to 2000 lines and 64 KiB.
214
- It does not include shell history from before the runtime. The history panel
215
- supports tmux copy mode; returning to main preserves its native draft. Closing
216
- the view removes its private history cache.
217
-
218
- To observe inbox metadata, supply an explicitly chosen mailbox observer actor:
145
+ History shows the shown session's own output, bounded to 2000 lines and 64 KiB,
146
+ scrolled with the arrow and page keys; Esc or q returns. It does not include
147
+ shell history from before the runtime.
219
148
 
220
- ```sh
221
- pmcp tui create --group-file "$GROUP_FILE" --columns 160 --rows 48 --config ./pmcp.toml --actor-file "$OBSERVER_ACTOR_FILE"
222
- ```
149
+ The mailbox panel shows message, thread and reply IDs through the existing
150
+ mailbox CLI for an explicitly chosen observer actor. Run pmcp-tui with
151
+ `--mailbox-config ./pmcp.toml --actor-file "$OBSERVER_ACTOR_FILE"` to enable it.
152
+ It never reads bodies, marks messages read, acknowledges them, submits input or
153
+ wakes a runtime. Use the [mailbox CLI](mailbox.md) for those explicit actions.
223
154
 
224
- The actor must have no live attachment. PMCP uses the existing mailbox service
225
- and refuses a conflicting attachment. The panel shows message, thread and reply
226
- IDs. It never reads bodies, marks messages read, acknowledges them, submits input
227
- or wakes a runtime. Use the [mailbox CLI](mailbox.md) for those explicit actions.
228
- The view stores the private credential file reference, not its contents.
229
-
230
- ## Detach, close and stop
155
+ ## Detach and recovery
231
156
 
232
157
  Detach preserves processes and drafts. Reopening returns to read-only main
233
- observation after releasing this view's control. A lost outer terminal also
234
- requests release; a crash or unreachable manager may prevent confirmation.
235
- Inspect before retrying, without replaying input:
158
+ observation. Leaving while in control gives the lease back; a crash leaves it to
159
+ lapse within 30 seconds. Inspect before retrying, without replaying input:
236
160
 
237
161
  ```sh
238
162
  pmcp harness recovery inspect --group-file "$GROUP_FILE"
@@ -261,18 +185,6 @@ manual-inspection. Preserve the reported checkpoint and examine owned launch
261
185
  evidence before changing it. Matching project paths alone cannot establish
262
186
  ownership. Paused work stays paused, and uncertain input is never replayed.
263
187
 
264
- Close ends the presentation and preserves all native runtimes:
265
-
266
- ```sh
267
- pmcp tui close --view "$VIEW_FILE"
268
- ```
269
-
270
- Stop names the exact current native target and requires confirmation:
271
-
272
- ```sh
273
- pmcp tui stop --view "$VIEW_FILE" --confirm-session "$SESSION"
274
- ```
275
-
276
- There is no stop keyboard shortcut. Group replacement invalidates a view's
277
- generation: create a fresh view instead of transferring old authority. These
278
- controls are CLI-only and cannot be invoked through the MCP server.
188
+ Stopping a session is a harness operation (`pmcp harness session stop`); there
189
+ is no stop key. These controls are CLI-only and cannot be invoked through the
190
+ MCP server.
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "name": "pmcp",
3
- "version": "0.17.4",
3
+ "version": "0.18.2",
4
4
  "mcpServers": {
5
5
  "pmcp": {
6
6
  "type": "stdio",
7
7
  "command": "npx",
8
- "args": ["-y", "@modootoday/pmcp@0.13.1", "serve"]
8
+ "args": ["-y", "@modootoday/pmcp@0.18.2", "serve"]
9
9
  }
10
10
  }
11
11
  }
package/mcp.json CHANGED
@@ -4,7 +4,7 @@
4
4
  "pmcp": {
5
5
  "type": "stdio",
6
6
  "command": "npx",
7
- "args": ["-y", "@modootoday/pmcp@0.13.1", "serve"]
7
+ "args": ["-y", "@modootoday/pmcp@0.18.2", "serve"]
8
8
  }
9
9
  }
10
10
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@modootoday/pmcp",
3
- "version": "0.17.4",
3
+ "version": "0.18.2",
4
4
  "license": "Elastic-2.0",
5
5
  "author": "modootoday",
6
6
  "description": "Use the skills your packages already ship, and keep your AI tools' project configuration in one place.",
@@ -55,11 +55,15 @@
55
55
  "pmcp": "dist/cli.js"
56
56
  },
57
57
  "files": [
58
+ "schema",
58
59
  "dist",
59
60
  "!dist/**/*.map",
60
61
  "!dist/.tsbuildinfo",
61
62
  "skills",
63
+ "!skills/*/evals/**",
62
64
  "plugins",
65
+ "!plugins/*/tsconfig.json",
66
+ "!plugins/*/.claude-plugin/types",
63
67
  ".claude-plugin/marketplace.json",
64
68
  ".claude-plugin/plugin.json",
65
69
  ".agents/plugins/marketplace.json",
@@ -68,8 +72,11 @@
68
72
  ".mcp.json",
69
73
  "gemini-extension.json",
70
74
  "docs/catalog.json",
75
+ "docs/hooks/capabilities/*.json",
71
76
  "docs/*.md",
72
77
  "README.md",
78
+ "CHANGELOG.md",
79
+ "CONTRIBUTING.md",
73
80
  "SECURITY.md",
74
81
  "LICENSE",
75
82
  "NOTICE"
@@ -78,6 +85,7 @@
78
85
  "build": "tsup",
79
86
  "typecheck": "tsgo --noEmit --incremental --tsBuildInfoFile ./dist/.tsbuildinfo --singleThreaded && tsgo -p tsconfig.tests.json --noEmit --singleThreaded",
80
87
  "test": "vitest run",
88
+ "metadata:schema": "bun scripts/metadata-schema.ts",
81
89
  "clean": "rimraf dist",
82
90
  "site:build": "bun run marketplace:build && node scripts/build-site-styles.mjs && node scripts/build-site-assets.mjs && node scripts/build-public-pages.mjs && node scripts/build-guide-pages.mjs && node scripts/build-catalog-pages.mjs && node scripts/build-observation-pages.mjs && node scripts/build-sitemap.mjs",
83
91
  "site:check": "node scripts/build-site-styles.mjs --check && node scripts/build-site-assets.mjs --check && node scripts/build-public-pages.mjs --check && node scripts/build-guide-pages.mjs --check && node scripts/build-catalog-pages.mjs --check && node scripts/build-observation-pages.mjs --check && node scripts/build-sitemap.mjs --check",
@@ -100,7 +108,7 @@
100
108
  "@modelcontextprotocol/server": "^2.0.0",
101
109
  "zod": "^4.5.1",
102
110
  "semver": "7.8.5",
103
- "smol-toml": "1.8.0",
111
+ "smol-toml": "1.9.0",
104
112
  "yaml": "2.9.0"
105
113
  },
106
114
  "peerDependencies": {
@@ -127,5 +135,11 @@
127
135
  "engines": {
128
136
  "node": ">=22.0.0",
129
137
  "bun": ">=1.3.0"
138
+ },
139
+ "optionalDependencies": {
140
+ "@modootoday/pmcp-linux-x64": "0.18.2",
141
+ "@modootoday/pmcp-linux-arm64": "0.18.2",
142
+ "@modootoday/pmcp-darwin-x64": "0.18.2",
143
+ "@modootoday/pmcp-darwin-arm64": "0.18.2"
130
144
  }
131
145
  }
package/plugin.json CHANGED
@@ -1,10 +1,10 @@
1
1
  {
2
2
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
3
3
  "name": "pmcp",
4
- "version": "0.17.4",
4
+ "version": "0.18.2",
5
5
  "description": "Find package skills and use native runtime project configuration.",
6
6
  "author": { "name": "modootoday" },
7
7
  "license": "Elastic-2.0",
8
8
  "repository": "https://github.com/modootoday/pmcp",
9
- "homepage": "https://pmcp.build/skills/"
9
+ "homepage": "https://pmcp.build/"
10
10
  }
@@ -1,9 +1,11 @@
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
+ "hooks": ["./mod/hooks.json"],
10
+ "types": "./mod/contract.d.ts"
9
11
  }
@@ -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
  }
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "name": "pmcp",
3
- "version": "0.17.4",
3
+ "version": "0.18.2",
4
4
  "mcpServers": {
5
5
  "pmcp": {
6
6
  "type": "stdio",
7
7
  "command": "npx",
8
- "args": ["-y", "@modootoday/pmcp@0.13.1", "serve"]
8
+ "args": ["-y", "@modootoday/pmcp@0.18.2", "serve"]
9
9
  }
10
10
  }
11
11
  }
@@ -4,7 +4,7 @@
4
4
  "pmcp": {
5
5
  "type": "stdio",
6
6
  "command": "npx",
7
- "args": ["-y", "@modootoday/pmcp@0.13.1", "serve"]
7
+ "args": ["-y", "@modootoday/pmcp@0.18.2", "serve"]
8
8
  }
9
9
  }
10
10
  }
@@ -0,0 +1,72 @@
1
+ import { STATE_PATHS } from "./reader/index";
2
+ import { refresh } from "./snapshot";
3
+ import { PANE_ID, state } from "./state";
4
+
5
+ async function writeState($: any, name: string, value: object): Promise<void> {
6
+ const dir = state.stateDir;
7
+ await $.process.run(["mkdir", "-p", dir]);
8
+ await $.fs.write(`${dir}/${name}`, `${JSON.stringify(value, null, 2)}\n`);
9
+ }
10
+
11
+ async function removeState($: any, name: string): Promise<void> {
12
+ await $.process.run(["rm", "-f", `${state.stateDir}/${name}`]);
13
+ }
14
+
15
+ async function togglePane($: any): Promise<{ text: string }> {
16
+ if (!state.settings?.sessionsPane)
17
+ return { text: "The sessions pane is off in [ui.claude]." };
18
+ if (state.isOpen) {
19
+ await $.ui.close({ id: PANE_ID });
20
+ state.isOpen = false;
21
+ await refresh($);
22
+ return { text: "Sessions pane closed." };
23
+ }
24
+ await $.ui.open({ id: PANE_ID, title: "Sessions" });
25
+ state.isOpen = true;
26
+ await refresh($);
27
+ return { text: `${state.snapshot.records.length} live session(s).` };
28
+ }
29
+
30
+ export async function runCommand(
31
+ $: any,
32
+ args: string,
33
+ ): Promise<{ text: string }> {
34
+ if (!state.settings) return { text: "The pmcp mod has not started yet." };
35
+ const [verb = "", ...words] = args.trim().split(/\s+/);
36
+ const since = new Date().toISOString();
37
+ if (verb === "pause") {
38
+ const reason = words.join(" ");
39
+ if (!reason) return { text: "Usage: /pmcp pause <reason>" };
40
+ await writeState($, STATE_PATHS.pause, { by: state.self, reason, since });
41
+ await refresh($);
42
+ return {
43
+ text: `Paused: ${reason}. Other sessions' edits and mutating commands are refused until /pmcp resume.`,
44
+ };
45
+ }
46
+ if (verb === "resume") {
47
+ await removeState($, STATE_PATHS.pause);
48
+ await refresh($);
49
+ return { text: "Resumed." };
50
+ }
51
+ if (verb === "broadcast") {
52
+ const text = words.join(" ");
53
+ if (!text) return { text: "Usage: /pmcp broadcast <text>" };
54
+ const id = `${Date.now()}`;
55
+ await writeState($, STATE_PATHS.broadcast, {
56
+ id,
57
+ by: state.self,
58
+ text,
59
+ since,
60
+ });
61
+ await refresh($);
62
+ return {
63
+ text: "Broadcast sent; every other session sees it at its next prompt.",
64
+ };
65
+ }
66
+ if (verb === "unbroadcast") {
67
+ await removeState($, STATE_PATHS.broadcast);
68
+ await refresh($);
69
+ return { text: "Broadcast cleared." };
70
+ }
71
+ return togglePane($);
72
+ }
@@ -0,0 +1,39 @@
1
+ // The state contract the plugin manifest names. The host requires it to be self-contained,
2
+ // so these shapes repeat src/sessions/types.ts and reader/types.ts for the one kept value.
3
+
4
+ export type PmcpRecord = {
5
+ readonly session: string;
6
+ readonly worktree?: string;
7
+ readonly status?: "idle" | "working" | "waiting";
8
+ readonly behind?: number;
9
+ readonly [key: string]: unknown;
10
+ };
11
+
12
+ export type PmcpSnapshot = {
13
+ readonly records: readonly PmcpRecord[];
14
+ readonly pause: {
15
+ readonly by: string;
16
+ readonly reason: string;
17
+ readonly since: string;
18
+ } | null;
19
+ readonly lease: {
20
+ readonly pid: number;
21
+ readonly subject: string;
22
+ readonly cwd?: string;
23
+ readonly since: string;
24
+ } | null;
25
+ readonly broadcast: {
26
+ readonly id: string;
27
+ readonly by: string;
28
+ readonly text: string;
29
+ readonly since: string;
30
+ } | null;
31
+ };
32
+
33
+ declare module "claude-code" {
34
+ interface PluginState {
35
+ pmcp: {
36
+ kept: { snapshot: PmcpSnapshot; isOpen: boolean; now: number } | null;
37
+ };
38
+ }
39
+ }