@modootoday/pmcp 0.17.4 → 0.18.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.agents/plugins/marketplace.json +1 -1
- package/.claude-plugin/marketplace.json +1 -1
- package/.claude-plugin/plugin.json +2 -2
- package/.mcp.json +1 -1
- package/CHANGELOG.md +152 -0
- package/CONTRIBUTING.md +71 -0
- package/README.md +98 -201
- package/SECURITY.md +17 -1
- package/dist/apply-JUTGS5WZ.js +242 -0
- package/dist/{attachment-tU5FZrgZ.d.ts → attachment-D84OGI6n.d.ts} +1 -1
- package/dist/available-DBSIVVJ6.js +73 -0
- package/dist/broadcast-CBMVOV3G.js +18 -0
- package/dist/chunk-26WLNWDG.js +93 -0
- package/dist/chunk-2FIV63WC.js +252 -0
- package/dist/chunk-2P4Z2NUX.js +28 -0
- package/dist/chunk-34DECPVC.js +22 -0
- package/dist/chunk-3FCFAQDG.js +42 -0
- package/dist/chunk-3IDXEV5E.js +1934 -0
- package/dist/chunk-3PW4FI7U.js +32 -0
- package/dist/chunk-3Y3HDMHA.js +108 -0
- package/dist/chunk-47O3X4VS.js +113 -0
- package/dist/chunk-4NDEP7HU.js +26 -0
- package/dist/chunk-5OMOPUE6.js +39 -0
- package/dist/chunk-5QQWS4US.js +53 -0
- package/dist/chunk-5ZABTVSW.js +48 -0
- package/dist/chunk-65KAQSJP.js +7 -0
- package/dist/chunk-6STKGOCW.js +27 -0
- package/dist/chunk-6WXMJOMI.js +9 -0
- package/dist/chunk-73AKO4UL.js +24 -0
- package/dist/chunk-7DLZC73N.js +29 -0
- package/dist/chunk-7GBYECSK.js +72 -0
- package/dist/chunk-7HFIGCSL.js +419 -0
- package/dist/chunk-7TD53M7L.js +13 -0
- package/dist/chunk-7UCZAN4J.js +778 -0
- package/dist/chunk-A4PKLESO.js +112 -0
- package/dist/chunk-A7VF7A35.js +1025 -0
- package/dist/chunk-ABTJQ4QV.js +74 -0
- package/dist/chunk-AJ4VXM2U.js +349 -0
- package/dist/chunk-BBTBJCFA.js +380 -0
- package/dist/chunk-BU65MNVU.js +13 -0
- package/dist/chunk-C4NHQGHL.js +142 -0
- package/dist/chunk-CJTKR6K6.js +1213 -0
- package/dist/chunk-D77IRGHO.js +1246 -0
- package/dist/chunk-DCU2EXQV.js +78 -0
- package/dist/chunk-DMZHQZ7P.js +104 -0
- package/dist/chunk-DZ2MRTYT.js +135 -0
- package/dist/chunk-E2YOZ2FF.js +207 -0
- package/dist/chunk-E3DQB5LS.js +48 -0
- package/dist/chunk-EATCUWGG.js +66 -0
- package/dist/chunk-EAWPJHJ7.js +155 -0
- package/dist/chunk-EIDIVIAD.js +33 -0
- package/dist/chunk-F5QYZK7E.js +396 -0
- package/dist/chunk-F5XMGOOX.js +28 -0
- package/dist/chunk-FENOGX3U.js +31 -0
- package/dist/chunk-GZHHEHKY.js +44 -0
- package/dist/chunk-HDMBVLCZ.js +53 -0
- package/dist/chunk-HQOB7OQS.js +81 -0
- package/dist/chunk-I2ZP2PSA.js +211 -0
- package/dist/chunk-IG33DXLT.js +151 -0
- package/dist/chunk-IJBSOWHK.js +86 -0
- package/dist/chunk-INT7QLEU.js +114 -0
- package/dist/chunk-J7UYNJCR.js +9 -0
- package/dist/chunk-JEL35P7S.js +53 -0
- package/dist/chunk-JGJ4INEN.js +32 -0
- package/dist/chunk-JS5RTH4I.js +84 -0
- package/dist/chunk-JWRZDYB5.js +59 -0
- package/dist/chunk-KMXRRSKT.js +660 -0
- package/dist/chunk-LBXO4VPG.js +73 -0
- package/dist/chunk-LLBPVZXM.js +67 -0
- package/dist/chunk-LLT5FQBE.js +57 -0
- package/dist/chunk-LMT3PPXJ.js +17 -0
- package/dist/chunk-LMUBBIE2.js +83 -0
- package/dist/chunk-LTZH5E3G.js +479 -0
- package/dist/chunk-LW4TG7EL.js +39 -0
- package/dist/chunk-MPSQXSC6.js +346 -0
- package/dist/chunk-MVFH26QT.js +97 -0
- package/dist/chunk-NLEXKE7U.js +67 -0
- package/dist/chunk-NQPURJT5.js +44 -0
- package/dist/chunk-NRBQK6UX.js +105 -0
- package/dist/chunk-OEH47H6A.js +48 -0
- package/dist/chunk-OG7QR2DP.js +75 -0
- package/dist/chunk-OPYFEHKG.js +52 -0
- package/dist/chunk-P4N7DBD5.js +83 -0
- package/dist/chunk-PAX3QXX2.js +140 -0
- package/dist/chunk-PKODFR5F.js +102 -0
- package/dist/chunk-PMJG2CXF.js +122 -0
- package/dist/chunk-Q5H3L6Y4.js +23 -0
- package/dist/chunk-QEF7EK3T.js +28 -0
- package/dist/chunk-QEW4J3IZ.js +74 -0
- package/dist/chunk-QPL7E2HW.js +464 -0
- package/dist/chunk-R2GPCZUX.js +22 -0
- package/dist/chunk-R5MT42JS.js +284 -0
- package/dist/chunk-RMATE45Z.js +197 -0
- package/dist/chunk-RPQOBHVU.js +87 -0
- package/dist/chunk-S3PIAMXV.js +230 -0
- package/dist/chunk-T3LKX23M.js +168 -0
- package/dist/chunk-T6GOWHK6.js +30 -0
- package/dist/chunk-TIA4SPU2.js +10 -0
- package/dist/chunk-TNCZ6444.js +57 -0
- package/dist/chunk-TVL5RTE6.js +269 -0
- package/dist/chunk-TXQ7L33K.js +45 -0
- package/dist/chunk-UPQTAHUK.js +189 -0
- package/dist/chunk-V4NPDK6X.js +14 -0
- package/dist/chunk-VJFEN6DJ.js +38 -0
- package/dist/chunk-VMHUEOT5.js +643 -0
- package/dist/chunk-VRPMYPZU.js +4985 -0
- package/dist/chunk-WIW772I3.js +25 -0
- package/dist/chunk-XELAZAIM.js +136 -0
- package/dist/chunk-XNML2KIC.js +23 -0
- package/dist/chunk-XP2U3LO3.js +30 -0
- package/dist/chunk-YGOWIJPE.js +51 -0
- package/dist/chunk-YIXDHQYE.js +11 -0
- package/dist/chunk-YSAWTGNA.js +117 -0
- package/dist/claude-U2JC2DNQ.js +77 -0
- package/dist/cli-MI4ZCAZ3.js +41 -0
- package/dist/cli-ZN7ZVDEZ.js +46 -0
- package/dist/cli.js +144 -16197
- package/dist/completion-ILSRB3LW.js +142 -0
- package/dist/config-DnpLL2kT.d.ts +46 -0
- package/dist/{service-qpCsOXkQ.d.ts → core-C1LPjxK6.d.ts} +2 -6
- package/dist/diagnostics-XKXVVQWH.js +93 -0
- package/dist/doctor-O2E63YGO.js +538 -0
- package/dist/entry-X6CSYQRQ.js +305 -0
- package/dist/exec-mcp-2PMWBPD7.js +365 -0
- package/dist/harness-L2KSI2ZB.js +177 -0
- package/dist/harness-egress-bridge.js +4 -4
- package/dist/harness-launch-gate.js +47 -940
- package/dist/harness-pane-runner.js +13 -80
- package/dist/harness-worker.js +21 -2703
- package/dist/hook-body.js +5222 -0
- package/dist/hook-spec-C5fWTSCH.d.ts +100 -0
- package/dist/hook.js +26 -0
- package/dist/hooks-BHTA44X7.js +21 -0
- package/dist/host-UIZAXXQH.js +22 -0
- package/dist/host-UWK754BW.js +210 -0
- package/dist/host-run-BI2OTZDZ.js +307 -0
- package/dist/http.d.ts +5 -42
- package/dist/http.js +21 -2234
- package/dist/import-mcp-GPKJI7DI.js +400 -0
- package/dist/index.d.ts +146 -168
- package/dist/index.js +133 -4948
- package/dist/init-3C2Y7BNJ.js +14 -0
- package/dist/install-GG7HHZK2.js +796 -0
- package/dist/invoke-44CJRVMK.js +23 -0
- package/dist/list-MCP2FXUF.js +68 -0
- package/dist/list-WL6L4J5H.js +65 -0
- package/dist/load-BEUBABtB.d.ts +21 -0
- package/dist/logout-F5EJ5MOU.js +44 -0
- package/dist/logs-TBUA4UWU.js +107 -0
- package/dist/mailbox/index.d.ts +10 -5
- package/dist/mailbox/index.js +53 -1572
- package/dist/mailbox-BMTZOSZ7.js +285 -0
- package/dist/mailbox-GDJ7BWQN.js +189 -0
- package/dist/mainline-KAD2ERLP.js +639 -0
- package/dist/marketplace-G4VQET5W.js +191 -0
- package/dist/mcp-235QZN2A.js +15 -0
- package/dist/mcp-FJ2UQ4RH.js +193 -0
- package/dist/models-ISU4DCMA.js +32 -0
- package/dist/opencode-CN7JLQYO.js +60 -0
- package/dist/pause-7LILUVGL.js +18 -0
- package/dist/preview-DT7DWG5F.js +91 -0
- package/dist/project/hook-adapter.d.ts +5 -2
- package/dist/project/hook-adapter.js +41 -27
- package/dist/project-5YV5CUEG.js +70 -0
- package/dist/pty-XTJ4MIWK.js +94 -0
- package/dist/recovery-U6QB3PMT.js +100 -0
- package/dist/reindex-Y27QJFDB.js +22 -0
- package/dist/resume-26VFAAMH.js +18 -0
- package/dist/run-3AXTZSR7.js +126 -0
- package/dist/run-3SOVRQIA.js +19 -0
- package/dist/serve-DQMKTFIV.js +104 -0
- package/dist/session-XM2CR425.js +159 -0
- package/dist/setup-DTKZLZUT.js +18 -0
- package/dist/start-login-YTZV6KMF.js +416 -0
- package/dist/status-A2OUTNGK.js +9 -0
- package/dist/status-H2VAHIDV.js +10 -0
- package/dist/status-MROQ7WR7.js +43 -0
- package/dist/status-RO55QPKV.js +55 -0
- package/dist/status-UME2L33L.js +286 -0
- package/dist/stdio.d.ts +3 -13
- package/dist/stdio.js +16 -3186
- package/dist/sweep-35LGQTTO.js +18 -0
- package/dist/test-AGZOJLRZ.js +561 -0
- package/dist/tools-gpHNq9Dh.d.ts +328 -0
- package/dist/tui-G5LLWCSV.js +153 -0
- package/dist/unbroadcast-5QNGAJR2.js +18 -0
- package/dist/validate-IU52H2IC.js +46 -0
- package/dist/worker-QZ5T6LJD.js +80 -0
- package/dist/worktree-create-PZSRB7PH.js +89 -0
- package/dist/worktree-list-JYB6VXLW.js +51 -0
- package/dist/worktree-sync-UF5CXPWV.js +30 -0
- package/docs/authoring.md +82 -0
- package/docs/browser-and-desktop.md +46 -0
- package/docs/commands.md +325 -0
- package/docs/compare.md +35 -0
- package/docs/compatibility.md +55 -0
- package/docs/embeddings.md +1 -1
- package/docs/getting-started.md +105 -0
- package/docs/git-workflow.md +60 -0
- package/docs/glossary.md +31 -0
- package/docs/hooks/capabilities/antigravity.json +199 -0
- package/docs/hooks/capabilities/claude.json +179 -0
- package/docs/hooks/capabilities/codex.json +179 -0
- package/docs/hooks/capabilities/gemini.json +196 -0
- package/docs/hooks/capabilities/grok.json +192 -0
- package/docs/hooks/capabilities/opencode.json +184 -0
- package/docs/hooks.md +264 -0
- package/docs/install.md +72 -0
- package/docs/library-skills.md +132 -0
- package/docs/mailbox.md +16 -5
- package/docs/project-configuration.md +540 -58
- package/docs/sessions.md +64 -0
- package/docs/skills.md +4 -45
- package/docs/terminal-harness.md +92 -44
- package/docs/terminal-workspace.md +81 -169
- package/gemini-extension.json +2 -2
- package/mcp.json +1 -1
- package/package.json +16 -2
- package/plugin.json +2 -2
- package/plugins/pmcp/.claude-plugin/plugin.json +4 -2
- package/plugins/pmcp/.mcp.json +1 -1
- package/plugins/pmcp/gemini-extension.json +2 -2
- package/plugins/pmcp/mcp.json +1 -1
- package/plugins/pmcp/mod/commands.ts +72 -0
- package/plugins/pmcp/mod/contract.d.ts +39 -0
- package/plugins/pmcp/mod/draw.tsx +216 -0
- package/plugins/pmcp/mod/guard.ts +42 -0
- package/plugins/pmcp/mod/hooks.json +4 -0
- package/plugins/pmcp/mod/host.ts +46 -0
- package/plugins/pmcp/mod/model.ts +144 -0
- package/plugins/pmcp/mod/reader/index.ts +18 -0
- package/plugins/pmcp/mod/reader/read.ts +76 -0
- package/plugins/pmcp/mod/reader/settings.ts +54 -0
- package/plugins/pmcp/mod/reader/types.ts +38 -0
- package/plugins/pmcp/mod/register.tsx +73 -0
- package/plugins/pmcp/mod/sessions/format.ts +91 -0
- package/plugins/pmcp/mod/sessions/types.ts +162 -0
- package/plugins/pmcp/mod/snapshot.ts +75 -0
- package/plugins/pmcp/mod/spinner.tsx +30 -0
- package/plugins/pmcp/mod/state.ts +28 -0
- package/plugins/pmcp/plugin.json +2 -2
- package/plugins/pmcp/skills/agent-assets-migrate/SKILL.md +96 -0
- package/plugins/pmcp/skills/headless-agents-ci-scaffold/SKILL.md +101 -0
- package/plugins/pmcp/skills/marketplace-plugin-scaffold/SKILL.md +87 -0
- package/plugins/pmcp/skills/package-skill-catalog/SKILL.md +51 -15
- package/plugins/pmcp/skills/pmcp-browser/SKILL.md +27 -0
- package/plugins/pmcp/skills/pmcp-desktop/SKILL.md +25 -0
- package/plugins/pmcp/skills/pmcp-project-init/SKILL.md +153 -0
- package/plugins/pmcp/skills/pmcp-sessions-and-git/SKILL.md +96 -0
- package/plugins/pmcp/skills/skill-package-scaffold/SKILL.md +89 -0
- package/schema/catalog-v1.json +187 -0
- package/schema/library.json +196 -0
- package/schema/marketplace-manifest.json +144 -0
- package/schema/plugin-manifest.json +59 -0
- package/schema/skill-frontmatter.json +170 -0
- package/schema/skill-metadata-core.json +131 -0
- package/skills/agent-assets-migrate/SKILL.md +96 -0
- package/skills/headless-agents-ci-scaffold/SKILL.md +101 -0
- package/skills/marketplace-plugin-scaffold/SKILL.md +87 -0
- package/skills/package-skill-catalog/SKILL.md +51 -15
- package/skills/pmcp-browser/SKILL.md +27 -0
- package/skills/pmcp-desktop/SKILL.md +25 -0
- package/skills/pmcp-project-init/SKILL.md +153 -0
- package/skills/pmcp-sessions-and-git/SKILL.md +96 -0
- package/skills/skill-package-scaffold/SKILL.md +89 -0
- package/dist/config-BkSpjUG6.d.ts +0 -50
- package/dist/embed-DRROSD3F.d.ts +0 -53
- package/dist/hook-spec-CSJJySsH.d.ts +0 -11
- package/dist/server-VWSY3Shw.d.ts +0 -543
- package/dist/tui-worker.js +0 -6549
- package/docs/manual-library-skills.md +0 -74
- /package/dist/{tui-worker.d.ts → hook.d.ts} +0 -0
|
@@ -1,21 +1,19 @@
|
|
|
1
1
|
# Terminal workspace
|
|
2
2
|
|
|
3
|
-
Use `pmcp tui` to view
|
|
4
|
-
|
|
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
|
-
|
|
9
|
-
|
|
10
|
-
|
|
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
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
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
|
-
|
|
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
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
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
|
|
98
|
-
|
|
99
|
-
|
|
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.
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
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
|
|
179
|
-
| -------- |
|
|
180
|
-
| m | Return to main
|
|
181
|
-
| w or 1–
|
|
182
|
-
|
|
|
183
|
-
|
|
|
184
|
-
|
|
|
185
|
-
|
|
|
186
|
-
|
|
|
187
|
-
|
|
|
188
|
-
|
|
|
189
|
-
|
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
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
|
|
214
|
-
|
|
215
|
-
|
|
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
|
-
|
|
221
|
-
|
|
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
|
-
|
|
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
|
|
234
|
-
|
|
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
|
-
|
|
265
|
-
|
|
266
|
-
|
|
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.
|
package/gemini-extension.json
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "pmcp",
|
|
3
|
-
"version": "0.
|
|
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.
|
|
8
|
+
"args": ["-y", "@modootoday/pmcp@0.18.2", "serve"]
|
|
9
9
|
}
|
|
10
10
|
}
|
|
11
11
|
}
|
package/mcp.json
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@modootoday/pmcp",
|
|
3
|
-
"version": "0.
|
|
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.
|
|
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.
|
|
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/
|
|
9
|
+
"homepage": "https://pmcp.build/"
|
|
10
10
|
}
|
|
@@ -1,9 +1,11 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "pmcp",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.18.2",
|
|
4
4
|
"description": "Find package skills and use native runtime project configuration.",
|
|
5
5
|
"author": { "name": "modootoday" },
|
|
6
6
|
"license": "Elastic-2.0",
|
|
7
7
|
"repository": "https://github.com/modootoday/pmcp",
|
|
8
|
-
"homepage": "https://pmcp.build/
|
|
8
|
+
"homepage": "https://pmcp.build/",
|
|
9
|
+
"hooks": ["./mod/hooks.json"],
|
|
10
|
+
"types": "./mod/contract.d.ts"
|
|
9
11
|
}
|
package/plugins/pmcp/.mcp.json
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "pmcp",
|
|
3
|
-
"version": "0.
|
|
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.
|
|
8
|
+
"args": ["-y", "@modootoday/pmcp@0.18.2", "serve"]
|
|
9
9
|
}
|
|
10
10
|
}
|
|
11
11
|
}
|
package/plugins/pmcp/mcp.json
CHANGED
|
@@ -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
|
+
}
|