@modootoday/pmcp 0.21.0 → 0.22.1

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 (84) hide show
  1. package/.agents/plugins/marketplace.json +1 -1
  2. package/.claude-plugin/marketplace.json +1 -1
  3. package/.claude-plugin/plugin.json +1 -1
  4. package/.mcp.json +1 -1
  5. package/dist/{apply-6FLMTJDV.js → apply-VMOFDOCN.js} +10 -10
  6. package/dist/{chunk-OFPNCLG7.js → chunk-3TS3CX3R.js} +2 -2
  7. package/dist/{chunk-Z4Q6RYJH.js → chunk-3W2GELNR.js} +2 -2
  8. package/dist/{chunk-VUM6LO77.js → chunk-6HCEEC6V.js} +45 -24
  9. package/dist/chunk-ACHBHIGD.js +7 -0
  10. package/dist/{chunk-KVNNVLJR.js → chunk-ALX7BECI.js} +2 -2
  11. package/dist/{chunk-OS5DF3LL.js → chunk-D5BLJIAA.js} +4 -4
  12. package/dist/{chunk-VBDDFO2V.js → chunk-DPVLHB3K.js} +2 -2
  13. package/dist/{chunk-33KGCJB2.js → chunk-FHK5BE2D.js} +2 -2
  14. package/dist/{chunk-ZIJ5IUXH.js → chunk-GBKRDRMZ.js} +14 -5
  15. package/dist/{chunk-GQP4GWU4.js → chunk-GRRURNVA.js} +5 -5
  16. package/dist/{chunk-POTI2RJ6.js → chunk-M5LC5TKQ.js} +2 -2
  17. package/dist/{chunk-G6JXCUSK.js → chunk-NYA4GX44.js} +2 -2
  18. package/dist/{chunk-UFWQTZDX.js → chunk-OKMWYNZF.js} +5 -5
  19. package/dist/{chunk-R3MVL67T.js → chunk-P2LJADGI.js} +12 -12
  20. package/dist/{chunk-YLITJLTR.js → chunk-SB6X342E.js} +3 -3
  21. package/dist/{chunk-5FW7A6TG.js → chunk-TMXWSGXH.js} +2 -2
  22. package/dist/chunk-UKR64U7J.js +20 -0
  23. package/dist/{chunk-DEY23WTH.js → chunk-UVGW56SY.js} +2 -2
  24. package/dist/{chunk-DJZPPCJP.js → chunk-V6LLHO4S.js} +3 -3
  25. package/dist/{chunk-TBKVC2TA.js → chunk-XWAE3VEQ.js} +2 -2
  26. package/dist/{chunk-3X5JQYKN.js → chunk-XYEI7KRO.js} +3 -3
  27. package/dist/{chunk-UD3BEEBQ.js → chunk-XZ2TDH3J.js} +80 -3
  28. package/dist/{cli-RVPR3MH3.js → cli-BEEDAD4E.js} +5 -5
  29. package/dist/cli.js +3 -3
  30. package/dist/{completion-YTPHEVEW.js → completion-XA7SR2OU.js} +2 -2
  31. package/dist/{diagnostics-IW54MLFK.js → diagnostics-AYSD3454.js} +5 -5
  32. package/dist/{doctor-EN4JPSKV.js → doctor-PDLZL4BR.js} +12 -12
  33. package/dist/{entry-TQWSDTJ4.js → entry-5CKOI3QK.js} +9 -9
  34. package/dist/{exec-mcp-KKQ75N5O.js → exec-mcp-EJZVPVU5.js} +8 -8
  35. package/dist/{harness-EB76F6BG.js → harness-VMQJY3KY.js} +3 -3
  36. package/dist/harness-launch-gate.js +3 -3
  37. package/dist/harness-worker.js +5 -5
  38. package/dist/{hooks-YWSHUNLM.js → hooks-SKD67KMA.js} +3 -3
  39. package/dist/{host-LSVITS6M.js → host-4BA3LM7Z.js} +6 -6
  40. package/dist/{host-OGGADMBT.js → host-GY2LFEZX.js} +10 -10
  41. package/dist/{host-run-XO2TS4JC.js → host-run-X3VDTIQ2.js} +4 -4
  42. package/dist/http.js +1 -1
  43. package/dist/{import-mcp-BJDJTPVS.js → import-mcp-G2VTD5KR.js} +7 -7
  44. package/dist/index.d.ts +1 -1
  45. package/dist/index.js +11 -11
  46. package/dist/{init-773PTQM5.js → init-JEK3QUAK.js} +2 -2
  47. package/dist/{invoke-Y7XH5S2L.js → invoke-7BUFBFJU.js} +7 -7
  48. package/dist/{list-5W65XVES.js → list-D3Y3TIC6.js} +9 -9
  49. package/dist/{logout-XO6ALD45.js → logout-T4JLFE2D.js} +8 -8
  50. package/dist/{mainline-M2NSTAGC.js → mainline-Q42M2GJ2.js} +106 -13
  51. package/dist/{mcp-R62ZNVGJ.js → mcp-GPIHVL65.js} +2 -2
  52. package/dist/{project-W5DQIZA6.js → project-6QRKXOMM.js} +4 -4
  53. package/dist/{run-OZLGSRHF.js → run-MVP22ENA.js} +7 -7
  54. package/dist/{run-WYJMTLX7.js → run-YHOLKUYB.js} +4 -4
  55. package/dist/{serve-DCQGAGB7.js → serve-EAESQK2I.js} +3 -3
  56. package/dist/{setup-D3KEJBGO.js → setup-3GET6K3J.js} +2 -2
  57. package/dist/{start-login-EKXM75XQ.js → start-login-K3TAZ3IH.js} +8 -8
  58. package/dist/{status-EDSEG32U.js → status-25DRPV7U.js} +8 -8
  59. package/dist/{status-23UDIYYP.js → status-DPPNTGHB.js} +9 -9
  60. package/dist/stdio.js +2 -2
  61. package/dist/{test-TM6PIZTV.js → test-I2V5AMQF.js} +8 -8
  62. package/dist/{tui-EQNJIDN5.js → tui-VCEN2L5I.js} +4 -4
  63. package/dist/{worker-7X6WBPEI.js → worker-NPQFYEBU.js} +7 -7
  64. package/dist/{worktree-sync-T6C5YEYS.js → worktree-sync-A277AF4M.js} +3 -5
  65. package/docs/commands.md +1 -1
  66. package/docs/compatibility.md +11 -10
  67. package/docs/git-workflow.md +29 -8
  68. package/docs/project-configuration.md +26 -1
  69. package/docs/upgrading.md +31 -0
  70. package/gemini-extension.json +2 -2
  71. package/mcp.json +1 -1
  72. package/package.json +5 -5
  73. package/plugin.json +1 -1
  74. package/plugins/pmcp/.claude-plugin/plugin.json +1 -1
  75. package/plugins/pmcp/.mcp.json +1 -1
  76. package/plugins/pmcp/gemini-extension.json +2 -2
  77. package/plugins/pmcp/mcp.json +1 -1
  78. package/plugins/pmcp/plugin.json +1 -1
  79. package/plugins/pmcp/skills/agent-assets-migrate/SKILL.md +11 -8
  80. package/plugins/pmcp/skills/pmcp-project-init/SKILL.md +11 -7
  81. package/skills/agent-assets-migrate/SKILL.md +11 -8
  82. package/skills/pmcp-project-init/SKILL.md +11 -7
  83. package/dist/chunk-2MAD4WNZ.js +0 -92
  84. package/dist/chunk-H4ZOKIER.js +0 -7
@@ -1,13 +1,13 @@
1
1
  import {
2
2
  serverFrom
3
- } from "./chunk-OFPNCLG7.js";
3
+ } from "./chunk-3TS3CX3R.js";
4
4
  import {
5
5
  status
6
6
  } from "./chunk-UPQTAHUK.js";
7
7
  import "./chunk-RPCIROW7.js";
8
- import "./chunk-VUM6LO77.js";
9
- import "./chunk-2MAD4WNZ.js";
10
- import "./chunk-UD3BEEBQ.js";
8
+ import "./chunk-6HCEEC6V.js";
9
+ import "./chunk-UKR64U7J.js";
10
+ import "./chunk-XZ2TDH3J.js";
11
11
  import "./chunk-KUBHGVTD.js";
12
12
  import "./chunk-EATCUWGG.js";
13
13
  import "./chunk-OFJIMBTL.js";
@@ -16,7 +16,7 @@ import "./chunk-LFFIQBNY.js";
16
16
  import "./chunk-HQOB7OQS.js";
17
17
  import "./chunk-73AKO4UL.js";
18
18
  import "./chunk-P6LNYYYH.js";
19
- import "./chunk-ZIJ5IUXH.js";
19
+ import "./chunk-GBKRDRMZ.js";
20
20
  import "./chunk-2Q6MNGU5.js";
21
21
  import "./chunk-MR5IBS6L.js";
22
22
  import "./chunk-Z6WRFOFT.js";
@@ -25,10 +25,10 @@ import "./chunk-Q5H3L6Y4.js";
25
25
  import "./chunk-5YCKFU5Q.js";
26
26
  import "./chunk-A4PKLESO.js";
27
27
  import "./chunk-V4NPDK6X.js";
28
- import "./chunk-DEY23WTH.js";
28
+ import "./chunk-UVGW56SY.js";
29
29
  import "./chunk-OEH47H6A.js";
30
30
  import "./chunk-IJBSOWHK.js";
31
- import "./chunk-H4ZOKIER.js";
31
+ import "./chunk-ACHBHIGD.js";
32
32
  import "./chunk-GJXOFDJT.js";
33
33
  import "./chunk-PMJG2CXF.js";
34
34
  import "./chunk-J6KL3COD.js";
@@ -44,4 +44,4 @@ function run(context) {
44
44
  export {
45
45
  run
46
46
  };
47
- //# sourceMappingURL=status-EDSEG32U.js.map
47
+ //# sourceMappingURL=status-25DRPV7U.js.map
@@ -7,20 +7,20 @@ import {
7
7
  } from "./chunk-57Q75MS4.js";
8
8
  import {
9
9
  policyRows
10
- } from "./chunk-5FW7A6TG.js";
10
+ } from "./chunk-TMXWSGXH.js";
11
11
  import "./chunk-7TD53M7L.js";
12
12
  import {
13
13
  configFrom
14
14
  } from "./chunk-RPCIROW7.js";
15
15
  import {
16
16
  checkProject
17
- } from "./chunk-DJZPPCJP.js";
17
+ } from "./chunk-V6LLHO4S.js";
18
18
  import {
19
19
  checkBudget,
20
20
  readSpec
21
- } from "./chunk-VUM6LO77.js";
22
- import "./chunk-2MAD4WNZ.js";
23
- import "./chunk-UD3BEEBQ.js";
21
+ } from "./chunk-6HCEEC6V.js";
22
+ import "./chunk-UKR64U7J.js";
23
+ import "./chunk-XZ2TDH3J.js";
24
24
  import {
25
25
  distance
26
26
  } from "./chunk-KUBHGVTD.js";
@@ -33,7 +33,7 @@ import "./chunk-73AKO4UL.js";
33
33
  import "./chunk-P6LNYYYH.js";
34
34
  import {
35
35
  readGitConfig
36
- } from "./chunk-ZIJ5IUXH.js";
36
+ } from "./chunk-GBKRDRMZ.js";
37
37
  import {
38
38
  defaultMainline,
39
39
  defaultRemote
@@ -54,13 +54,13 @@ import {
54
54
  ArgumentError
55
55
  } from "./chunk-A4PKLESO.js";
56
56
  import "./chunk-V4NPDK6X.js";
57
- import "./chunk-DEY23WTH.js";
57
+ import "./chunk-UVGW56SY.js";
58
58
  import "./chunk-OEH47H6A.js";
59
59
  import {
60
60
  checkoutOf,
61
61
  worktreesOf
62
62
  } from "./chunk-IJBSOWHK.js";
63
- import "./chunk-H4ZOKIER.js";
63
+ import "./chunk-ACHBHIGD.js";
64
64
  import "./chunk-GJXOFDJT.js";
65
65
  import "./chunk-PMJG2CXF.js";
66
66
  import "./chunk-J6KL3COD.js";
@@ -295,4 +295,4 @@ var statusCommand = {
295
295
  export {
296
296
  statusCommand
297
297
  };
298
- //# sourceMappingURL=status-23UDIYYP.js.map
298
+ //# sourceMappingURL=status-DPPNTGHB.js.map
package/dist/stdio.js CHANGED
@@ -4,8 +4,8 @@ import {
4
4
  resolveRoots,
5
5
  serve,
6
6
  serveWithMailbox
7
- } from "./chunk-G6JXCUSK.js";
8
- import "./chunk-Z4Q6RYJH.js";
7
+ } from "./chunk-NYA4GX44.js";
8
+ import "./chunk-3W2GELNR.js";
9
9
  import "./chunk-6WXMJOMI.js";
10
10
  import "./chunk-4CRRLDDS.js";
11
11
  import "./chunk-YSAWTGNA.js";
@@ -1,6 +1,6 @@
1
1
  import {
2
2
  specFrom
3
- } from "./chunk-VBDDFO2V.js";
3
+ } from "./chunk-DPVLHB3K.js";
4
4
  import {
5
5
  sourceFor
6
6
  } from "./chunk-7TD53M7L.js";
@@ -11,9 +11,9 @@ import {
11
11
  commandsOf,
12
12
  customMode,
13
13
  customPolicy
14
- } from "./chunk-VUM6LO77.js";
15
- import "./chunk-2MAD4WNZ.js";
16
- import "./chunk-UD3BEEBQ.js";
14
+ } from "./chunk-6HCEEC6V.js";
15
+ import "./chunk-UKR64U7J.js";
16
+ import "./chunk-XZ2TDH3J.js";
17
17
  import "./chunk-KUBHGVTD.js";
18
18
  import "./chunk-EATCUWGG.js";
19
19
  import "./chunk-OFJIMBTL.js";
@@ -25,7 +25,7 @@ import {
25
25
  } from "./chunk-HQOB7OQS.js";
26
26
  import "./chunk-73AKO4UL.js";
27
27
  import "./chunk-P6LNYYYH.js";
28
- import "./chunk-ZIJ5IUXH.js";
28
+ import "./chunk-GBKRDRMZ.js";
29
29
  import "./chunk-2Q6MNGU5.js";
30
30
  import {
31
31
  SESSION_ID,
@@ -53,7 +53,7 @@ import {
53
53
  one
54
54
  } from "./chunk-A4PKLESO.js";
55
55
  import "./chunk-V4NPDK6X.js";
56
- import "./chunk-DEY23WTH.js";
56
+ import "./chunk-UVGW56SY.js";
57
57
  import {
58
58
  expandPath
59
59
  } from "./chunk-OEH47H6A.js";
@@ -61,7 +61,7 @@ import {
61
61
  checkoutOf,
62
62
  worktreesOf
63
63
  } from "./chunk-IJBSOWHK.js";
64
- import "./chunk-H4ZOKIER.js";
64
+ import "./chunk-ACHBHIGD.js";
65
65
  import "./chunk-GJXOFDJT.js";
66
66
  import "./chunk-PMJG2CXF.js";
67
67
  import "./chunk-J6KL3COD.js";
@@ -607,4 +607,4 @@ async function run(context) {
607
607
  export {
608
608
  run
609
609
  };
610
- //# sourceMappingURL=test-TM6PIZTV.js.map
610
+ //# sourceMappingURL=test-I2V5AMQF.js.map
@@ -112,10 +112,10 @@ var tuiCommand = {
112
112
  try {
113
113
  let receipt;
114
114
  if (invocation.action === "doctor") {
115
- const { inspectTerminalHost } = await import("./diagnostics-IW54MLFK.js");
115
+ const { inspectTerminalHost } = await import("./diagnostics-AYSD3454.js");
116
116
  receipt = inspectTerminalHost();
117
117
  } else if (invocation.action === "start-worker") {
118
- const { startWorkspaceWorker } = await import("./worker-7X6WBPEI.js");
118
+ const { startWorkspaceWorker } = await import("./worker-NPQFYEBU.js");
119
119
  receipt = await startWorkspaceWorker(
120
120
  { config: invocation.startup?.config, cwd: context.cwd },
121
121
  invocation.startup.runtime,
@@ -128,7 +128,7 @@ var tuiCommand = {
128
128
  cwd: context.cwd
129
129
  });
130
130
  } else {
131
- const { launchStartup, planStartup } = await import("./entry-TQWSDTJ4.js");
131
+ const { launchStartup, planStartup } = await import("./entry-5CKOI3QK.js");
132
132
  const request = { ...invocation.startup, cwd: context.cwd };
133
133
  receipt = invocation.action === "plan" ? planStartup(request) : await launchStartup(
134
134
  request,
@@ -150,4 +150,4 @@ var tuiCommand = {
150
150
  export {
151
151
  tuiCommand
152
152
  };
153
- //# sourceMappingURL=tui-EQNJIDN5.js.map
153
+ //# sourceMappingURL=tui-VCEN2L5I.js.map
@@ -5,19 +5,19 @@ import {
5
5
  } from "./chunk-C3G75JH7.js";
6
6
  import {
7
7
  invoke
8
- } from "./chunk-GQP4GWU4.js";
8
+ } from "./chunk-GRRURNVA.js";
9
9
  import "./chunk-DZ2MRTYT.js";
10
- import "./chunk-YLITJLTR.js";
11
- import "./chunk-POTI2RJ6.js";
10
+ import "./chunk-SB6X342E.js";
11
+ import "./chunk-M5LC5TKQ.js";
12
12
  import {
13
13
  locateExecutable
14
14
  } from "./chunk-R2GPCZUX.js";
15
- import "./chunk-33KGCJB2.js";
15
+ import "./chunk-FHK5BE2D.js";
16
16
  import "./chunk-34DECPVC.js";
17
- import "./chunk-DEY23WTH.js";
17
+ import "./chunk-UVGW56SY.js";
18
18
  import "./chunk-OEH47H6A.js";
19
19
  import "./chunk-IJBSOWHK.js";
20
- import "./chunk-H4ZOKIER.js";
20
+ import "./chunk-ACHBHIGD.js";
21
21
  import "./chunk-GJXOFDJT.js";
22
22
  import "./chunk-PMJG2CXF.js";
23
23
  import {
@@ -77,4 +77,4 @@ async function startWorkspaceWorker(request, runtime, memoryMb) {
77
77
  export {
78
78
  startWorkspaceWorker
79
79
  };
80
- //# sourceMappingURL=worker-7X6WBPEI.js.map
80
+ //# sourceMappingURL=worker-NPQFYEBU.js.map
@@ -2,11 +2,9 @@ import {
2
2
  off
3
3
  } from "./chunk-YIXDHQYE.js";
4
4
  import {
5
+ installSpec,
5
6
  syncWorktree
6
- } from "./chunk-2MAD4WNZ.js";
7
- import {
8
- installSpec
9
- } from "./chunk-UD3BEEBQ.js";
7
+ } from "./chunk-XZ2TDH3J.js";
10
8
  import "./chunk-KUBHGVTD.js";
11
9
  import "./chunk-P6LNYYYH.js";
12
10
  import "./chunk-G7JONWL4.js";
@@ -28,4 +26,4 @@ var worktreeSync = (setup, _context, report) => {
28
26
  export {
29
27
  worktreeSync
30
28
  };
31
- //# sourceMappingURL=worktree-sync-T6C5YEYS.js.map
29
+ //# sourceMappingURL=worktree-sync-A277AF4M.js.map
package/docs/commands.md CHANGED
@@ -190,7 +190,7 @@ The git workflow configured by [`[git]`](git-workflow.md). Each subcommand needs
190
190
  - `worktree list` prints alias, branch, behind/ahead and path for the main checkout and each linked worktree.
191
191
  - `worktree sync` moves the current worktree onto the mainline when that loses nothing; exit 1 when it is held back.
192
192
  - `deliver` fetches, replays the named commits (default: the ones the upstream lacks) onto the mainline, runs the gate in its own tree under a lock, and pushes; it replays again if the mainline moved. A delivery that touches a leased path holds that lease until it has pushed and installed, and it refuses during a pause unless `--during-pause` or `during_pause = "allow"`. `--no-push` replays and runs the gate command, then stops: it takes no lease and pushes, syncs and notifies nothing, and it refuses `gate = "pre-push"`, where the push is the gate. Exit 0 delivered, gated with `--no-push`, or nothing to deliver; 1 refused, gate failed or attempts exhausted; 2 fetch failed or `--no-push` with the pre-push gate.
193
- - `sync` moves the main checkout to the mainline, installs when a listed file changed, and follows clean submodule pins. Exit 0 moved or already equal, 1 when local work would be lost, 2 when blocked (undelivered edits) or the fetch failed.
193
+ - `sync` moves the main checkout to the mainline, installs when a listed file changed, and follows clean submodule pins. Exit 0 moved or already equal, 1 when local work would be lost, 2 when blocked (undelivered edits) or the fetch failed. Run in a desk (a linked worktree matching `[git.worktrees] desks`), it brings the desk up to date the same way without rebasing: exit 0 moved or current, 1 held (an unlanded commit, uncommitted tracked edits, a pause, another session's lease, a git operation in progress), with the reason. In any other linked worktree it exits 2.
194
194
 
195
195
  ## completion
196
196
 
@@ -38,16 +38,17 @@ prompts.
38
38
 
39
39
  ## Installation and packaging
40
40
 
41
- | Surface | Current qualification |
42
- | ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
43
- | 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 |
44
- | 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 |
45
- | Public skill installation | npm, Bun and pnpm 10.17.1; confirmation required, scripts disabled |
46
- | Native plugin export | Claude, Codex, Gemini, Grok and agy formats; export does not install or activate a vendor plugin |
47
- | pnpm workspace installation | Selects the member, preserves root dependencies and updates the shared lockfile |
48
- | Yarn skill installation | Refused without changing project files; Yarn PnP is not supported |
49
- | Docker profile for the harness | Codex 0.161.0 login and main/worker responses through the profile's proxy; other vendors and token refresh not measured |
50
- | OpenCode user-only skills | OpenCode 1.18.33: `invocation = "user"` hides the skill from the model and keeps the `/<name>` command, measured with isolated CLI calls and scripted responses, no model call |
41
+ | Surface | Current qualification |
42
+ | ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
43
+ | 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 |
44
+ | 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 |
45
+ | Public skill installation | npm, Bun and pnpm 10.17.1; confirmation required, scripts disabled |
46
+ | Native plugin export | Claude, Codex, Gemini, Grok and agy formats; export does not install or activate a vendor plugin |
47
+ | pnpm workspace installation | Selects the member, preserves root dependencies and updates the shared lockfile |
48
+ | Yarn skill installation | Refused without changing project files; Yarn PnP is not supported |
49
+ | Docker profile for the harness | Codex 0.161.0 login and main/worker responses through the profile's proxy; other vendors and token refresh not measured |
50
+ | OpenCode user-only skills | OpenCode 1.18.33: `invocation = "user"` hides the skill from the model and keeps the `/<name>` command, measured with isolated CLI calls and scripted responses, no model call |
51
+ | Codex project agents | codex-cli 0.163.0: the name a sub-agent is spawned under must be lowercase letters, digits and underscores, so pmcp writes Codex agent names with `_` for `-`. In `codex exec` the model found no way to pick a custom agent role when spawning, with or without `features.multi_agent_v2.hide_spawn_agent_metadata = false`; whether a role named with a hyphen can be picked was not measured |
51
52
 
52
53
  Provider authentication, native children and vendor behavior have separate
53
54
  qualification scopes. An installed executable or exported manifest is not proof
@@ -30,15 +30,34 @@ turn it on.
30
30
  | `alias_pattern` | regex | `"^[a-z][a-z0-9-]{1,30}$"` |
31
31
  | `bootstrap` | argv list | none |
32
32
  | `link_from_main` | list | `[]` |
33
+ | `desks` | glob | `"<root>/*"` |
34
+
35
+ Each checkout is one of three kinds, derived and never declared per checkout:
36
+ **shared** is the main checkout (its `.git` is a directory), a **desk** is a
37
+ linked worktree whose path relative to the main checkout matches `desks` (by
38
+ default, the worktrees `pmcp git worktree create` makes), and every other linked
39
+ worktree is **scratch** (the gate tree, delivery replays, one made by hand).
33
40
 
34
41
  `[git.worktrees.sync]` (opt-in) keeps each linked worktree on the mainline when moving it
35
42
  loses nothing: `on_session_start` (`"fetch_and_move"` default, `"move"`,
36
43
  `"off"`), `between_prompts` (`"move_if_light"` default, `"off"`: move only when
37
44
  no install is needed), `install_after_move` (`"off"` default, `"background"`,
38
- `"foreground"`) and `notice_paths` (paths whose change is announced to the
39
- session). Installs never block a session. A worktree is not moved while the
40
- workspace is paused or while any lease is held (every `[sessions.leases.<name>]`,
41
- or the implicit `lockfile` lease), and the session is told which.
45
+ `"foreground"`), `notice_paths` (paths whose change is announced to the
46
+ session) and `after_deliver` (`"off"` default, or `"desk"`: a delivery run in a
47
+ desk then syncs that desk as `pmcp git sync` does there, holding its leases, and
48
+ the `--json` receipt reports it as `desk_sync`). Installs never block a session.
49
+ A worktree is not moved while the workspace is paused or while any lease is held
50
+ (every `[sessions.leases.<name>]`, or the implicit `lockfile` lease), and the
51
+ session is told which.
52
+
53
+ `pmcp git sync` acts by kind. In the main checkout it is the main checkout sync
54
+ described under `[git.mainline.sync]`. In a desk it brings the desk up to date
55
+ mid-session: it fetches, then fast-forwards, or uses `reset --keep` when every
56
+ commit the desk has beyond the mainline is landed there, follows clean
57
+ submodule pins and runs the install when the lockfile changed. It never rebases:
58
+ an unlanded commit, an uncommitted change to a tracked file, a pause, another
59
+ session's lease, or a git operation in progress holds the desk where it is
60
+ (exit 1, with the reason). In a scratch worktree it moves nothing (exit 2).
42
61
 
43
62
  `[git.mainline.gate]`: `command` (argv; no gate when missing), `tree` (the
44
63
  gate's worktree, default `<state dir>/gate/tree`; a relative path is relative to
@@ -107,15 +126,17 @@ variable reaches the push only if `push_env` names it.
107
126
 
108
127
  `pmcp git deliver --json` prints one receipt on stdout when it ends, progress
109
128
  staying on stderr: `{ok, code, delivered, upstream, attempts, replayed, gate,
110
- leases, sync, reason?}`, where `delivered` is the upstream commit it pushed (or
129
+ leases, sync, desk_sync, reason?}`, where `delivered` is the upstream commit it pushed (or
111
130
  `null`), `replayed` the tip of its last replay onto the upstream (or `null`),
112
131
  `gate` is `{exit, log, by}` for the last gate run (or `null`; `by` is
113
132
  `"command"` or `"pre-push"`), `leases` the leases it took, `sync` the main
114
133
  checkout's sync after the delivery (or `null` when none ran) as
115
134
  `{from, to, code, reason?}`: the main checkout's HEAD before and after, the exit
116
- code `pmcp git sync` would have, and its last warning; and `reason` is the last
117
- refusal or failure. `--no-push` stops after the gate, so its receipt has
118
- `replayed` and `gate` but `delivered` and `sync` are `null`.
135
+ code `pmcp git sync` would have, and its last warning; `desk_sync` the same for the
136
+ delivering desk's own sync (`[git.worktrees.sync] after_deliver = "desk"`); and
137
+ `reason` is the last refusal or failure. `--no-push` stops after the gate, so its
138
+ receipt has `replayed` and `gate` but `delivered`, `sync` and `desk_sync` are
139
+ `null`.
119
140
  Exit codes: `0` delivered or nothing to deliver, even when the sync after it was
120
141
  refused; `1` refused, a lease or the gate lock held too long, a replay
121
142
  conflict, the gate failed, the push failed or it gave up after `attempts`; `2`
@@ -139,11 +139,36 @@ pmcp doctor # ask each installed tool what it loads
139
139
  | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
140
140
  | `[targets]` | `tools`: list of `claude`, `codex`, `gemini`, `grok`, `antigravity`, `opencode`. Missing means nothing is projected. |
141
141
  | `[skills.<name>]` | `invocation`: `"any"` (default) or `"user"`. |
142
- | `[agents.<name>.<tool>]` | Any keys, merged over the agent's frontmatter; Claude keeps `name`, `description`, `tools`, `model`, `effort`, Gemini keeps `name`, `description`. |
142
+ | `[agents.<name>.<tool>]` | Any keys, merged over the agent's frontmatter; Claude keeps `name`, `description`, `tools`, `model`, `effort`, Gemini keeps `name`, `description`. Codex keeps every key: see below. |
143
143
  | `[rules.packages]` | `file` (required): the file name each package keeps its rules in; every tracked `<package>/<file>` is linked as `.claude/rules/<dir>/<name>.md`. `dir` (default `"pkg"`, not `"pmcp"`). `strip` (default `[]`): leading path segments dropped when deriving `<name>`. Written only for Claude. |
144
144
 
145
145
  Rules go to `.claude/rules/<dir>/`, never the top level, because Grok Build
146
146
  loads top-level `.claude/rules/*.md` in every session regardless of `paths:`.
147
+ Grok Build reads `.agents/skills` itself in a trusted folder, so pmcp writes no
148
+ skill links for it; a skill placed by hand under `.grok/skills` would shadow the
149
+ `.agents/skills` one of the same name, and `pmcp project --check` reports it as
150
+ undeclared.
151
+
152
+ Each agent becomes `.codex/agents/<codex name>.toml` for Codex, where the Codex
153
+ name is the agent's name with `-` turned into `_` (Codex refuses a hyphen where it
154
+ uses agent names), or `[agents.<name>.codex] name`, which must be lowercase
155
+ letters, digits and underscores. Two agents with the same Codex name are an error
156
+ naming both. `description` comes from the frontmatter unless the table sets it,
157
+ `developer_instructions` is always the agent's body (setting it in the table is an
158
+ error), and every other key in `[agents.<name>.codex]` is written as it is, plain
159
+ values first and then tables:
160
+
161
+ ```toml
162
+ [agents.test-planner.codex]
163
+ name = "browser_test_planner"
164
+ sandbox_mode = "read-only"
165
+
166
+ [agents.test-planner.codex.mcp_servers.browser]
167
+ command = "npx"
168
+ args = ["@playwright/mcp"]
169
+ enabled_tools = ["browser_navigate", "browser_snapshot"]
170
+ ```
171
+
147
172
  A server that names `${PROJECT_ROOT}` is launched through `sh`, which finds
148
173
  `pmcp.toml` at spawn time, so the generated files hold no machine's path.
149
174
  `pmcp.lock` records what was written; a file pmcp did not write is never
package/docs/upgrading.md CHANGED
@@ -5,6 +5,37 @@
5
5
  What to do when a release changes something you rely on. Each release's notes on GitHub
6
6
  Releases list its breaking changes and link here.
7
7
 
8
+ ## From 0.22.0 to 0.22.1
9
+
10
+ **Codex agent files are named with underscores.** Codex refuses a hyphen in the name it
11
+ spawns a sub-agent under, so an agent `frontend-implementer` is now
12
+ `.codex/agents/frontend_implementer.toml` with `name = "frontend_implementer"`. The next
13
+ `pmcp project` writes the new files and removes the hyphenated ones it wrote before. Anything
14
+ that names a Codex agent by its old hyphenated name, a prompt or a script, should use the
15
+ underscore name; `[agents.<name>.codex] name` sets another one.
16
+
17
+ **`[agents.<name>.codex]` reaches the Codex agent file.** 0.22.0 ignored it. Its keys are now
18
+ written into the file, so a hand-written Codex agent with settings such as `sandbox_mode` or
19
+ an `[mcp_servers.<id>]` table can move to `.agents/agents/<name>/agent.md` plus that table.
20
+ `developer_instructions` in the table is now an error: it is the agent's body. See
21
+ [Native files for each agent tool](project-configuration.md#native-files-for-each-agent-tool).
22
+
23
+ ## From 0.21 to 0.22
24
+
25
+ **pmcp writes no `.grok/skills` links.** Grok Build reads `.agents/skills` itself (measured on
26
+ 1.0.62, in a folder it trusts), so the links were duplicates. The next `pmcp project` removes the
27
+ ones it wrote. A Grok older than 1.0.62 was not measured; check that `grok inspect --json`
28
+ lists your project's skills after upgrading, and keep 0.21 for that project if it does not.
29
+
30
+ **`pmcp git sync` now works in a desk.** In 0.21 it exited 2 in any linked worktree. A
31
+ linked worktree matching `[git.worktrees] desks` (by default every worktree under
32
+ `[git.worktrees] root`) is now brought up to date with the mainline when that loses
33
+ nothing, and held with exit 1 otherwise; any other linked worktree still exits 2. A script
34
+ that relied on exit 2 to skip desks should check the kind first, or set `desks` to a
35
+ pattern that matches none. `[git.worktrees.sync] after_deliver = "desk"` syncs the
36
+ delivering desk after a delivery, and the `--json` receipt gains `desk_sync`. See
37
+ [Git workflow](git-workflow.md).
38
+
8
39
  ## From 0.20 to 0.21
9
40
 
10
41
  **Session records are written to `sessions/` alone.** 0.20 also wrote each record to the
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "name": "pmcp",
3
- "version": "0.21.0",
3
+ "version": "0.22.1",
4
4
  "mcpServers": {
5
5
  "pmcp": {
6
6
  "type": "stdio",
7
7
  "command": "npx",
8
- "args": ["-y", "@modootoday/pmcp@0.21.0", "serve"]
8
+ "args": ["-y", "@modootoday/pmcp@0.22.1", "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.21.0", "serve"]
7
+ "args": ["-y", "@modootoday/pmcp@0.22.1", "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.21.0",
3
+ "version": "0.22.1",
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.",
@@ -136,9 +136,9 @@
136
136
  "bun": ">=1.3.0"
137
137
  },
138
138
  "optionalDependencies": {
139
- "@modootoday/pmcp-linux-x64": "0.21.0",
140
- "@modootoday/pmcp-linux-arm64": "0.21.0",
141
- "@modootoday/pmcp-darwin-x64": "0.21.0",
142
- "@modootoday/pmcp-darwin-arm64": "0.21.0"
139
+ "@modootoday/pmcp-linux-x64": "0.22.1",
140
+ "@modootoday/pmcp-linux-arm64": "0.22.1",
141
+ "@modootoday/pmcp-darwin-x64": "0.22.1",
142
+ "@modootoday/pmcp-darwin-arm64": "0.22.1"
143
143
  }
144
144
  }
package/plugin.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
3
3
  "name": "pmcp",
4
- "version": "0.21.0",
4
+ "version": "0.22.1",
5
5
  "description": "Find package skills and use native runtime project configuration.",
6
6
  "author": { "name": "modootoday" },
7
7
  "license": "Elastic-2.0",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "pmcp",
3
- "version": "0.21.0",
3
+ "version": "0.22.1",
4
4
  "description": "Find package skills and use native runtime project configuration.",
5
5
  "author": { "name": "modootoday" },
6
6
  "license": "Elastic-2.0",
@@ -3,7 +3,7 @@
3
3
  "pmcp": {
4
4
  "type": "stdio",
5
5
  "command": "npx",
6
- "args": ["-y", "@modootoday/pmcp@0.21.0", "serve"]
6
+ "args": ["-y", "@modootoday/pmcp@0.22.1", "serve"]
7
7
  }
8
8
  }
9
9
  }
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "name": "pmcp",
3
- "version": "0.21.0",
3
+ "version": "0.22.1",
4
4
  "mcpServers": {
5
5
  "pmcp": {
6
6
  "type": "stdio",
7
7
  "command": "npx",
8
- "args": ["-y", "@modootoday/pmcp@0.21.0", "serve"]
8
+ "args": ["-y", "@modootoday/pmcp@0.22.1", "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.21.0", "serve"]
7
+ "args": ["-y", "@modootoday/pmcp@0.22.1", "serve"]
8
8
  }
9
9
  }
10
10
  }
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
3
3
  "name": "pmcp",
4
- "version": "0.21.0",
4
+ "version": "0.22.1",
5
5
  "description": "Find package skills and use native runtime project configuration.",
6
6
  "author": { "name": "modootoday" },
7
7
  "license": "Elastic-2.0",
@@ -21,14 +21,14 @@ tool files.
21
21
 
22
22
  List every source with its bytes and line count, and note which are links:
23
23
 
24
- | Found | Goes to |
25
- | --------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
26
- | `CLAUDE.md`, `GEMINI.md`, `.cursorrules`, `.windsurfrules`, `.github/copilot-instructions.md` | merged into `AGENTS.md`; each then becomes a link to it |
27
- | `.claude/skills/<n>/`, `.agent/skills/<n>/` | `.agents/skills/<n>/` (whole folder) |
28
- | `.claude/commands/<n>.md`, `.agent/workflows/<n>.md` | `.agents/skills/<n>/SKILL.md` plus `[skills.<n>] invocation = "user"` |
29
- | `.claude/agents/<n>.md`, `.gemini/agents/<n>.md`, `.agent/agents/<n>.md` | `.agents/agents/<n>/agent.md` |
30
- | `.claude/rules/*.md` with `paths:` | `.agents/rules/<n>.md` with `trigger: glob` and `globs:` |
31
- | MCP entries in `.mcp.json`, `.gemini/settings.json`, `.codex/config.toml` | `[mcp.<alias>]` in `pmcp.toml` |
24
+ | Found | Goes to |
25
+ | --------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
26
+ | `CLAUDE.md`, `GEMINI.md`, `.cursorrules`, `.windsurfrules`, `.github/copilot-instructions.md` | merged into `AGENTS.md`; each then becomes a link to it, except `GEMINI.md` (section 2) |
27
+ | `.claude/skills/<n>/`, `.agent/skills/<n>/` | `.agents/skills/<n>/` (whole folder) |
28
+ | `.claude/commands/<n>.md`, `.agent/workflows/<n>.md` | `.agents/skills/<n>/SKILL.md` plus `[skills.<n>] invocation = "user"` |
29
+ | `.claude/agents/<n>.md`, `.gemini/agents/<n>.md`, `.agent/agents/<n>.md` | `.agents/agents/<n>/agent.md` |
30
+ | `.claude/rules/*.md` with `paths:` | `.agents/rules/<n>.md` with `trigger: glob` and `globs:` |
31
+ | MCP entries in `.mcp.json`, `.gemini/settings.json`, `.codex/config.toml` | `[mcp.<alias>]` in `pmcp.toml` |
32
32
 
33
33
  pmcp has no Copilot or Cursor target. Keep those filenames as links to `AGENTS.md` so they
34
34
  cannot drift.
@@ -38,6 +38,9 @@ cannot drift.
38
38
  Diff each instruction file against the others line by line. Keep the union; where two say
39
39
  different things, settle it from the code or ask, and record the decision. Do not summarise
40
40
  during the move. Then replace each old file with a link (`ln -s AGENTS.md CLAUDE.md`).
41
+ For Gemini CLI, delete every `GEMINI.md` once its text is in the `AGENTS.md` beside it, and
42
+ set `"context": { "fileName": ["AGENTS.md"] }` in `.gemini/settings.json` (adding the key if
43
+ the file exists): Gemini CLI then reads `AGENTS.md` in each directory itself.
41
44
  Use file-to-file links only: a directory symlink at the repository root, such as `.agents`
42
45
  pointing at `.agent`, is rejected by the Codex sandbox.
43
46
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: pmcp-project-init
3
- description: Set up a repository so every coding agent reads the same instructions, skills, subagents, rules and MCP servers - one AGENTS.md with CLAUDE.md and GEMINI.md linked to it, sources under .agents/, a pmcp.toml with [targets] and [mcp.*] entries, then the optional layers chosen from what the repository is (hook guards, sessions, the git workflow when it is a git checkout, logging, shared MCP authentication, marketplaces), then pmcp project and pmcp doctor, plus the one-time trust step each agent CLI needs. Use when starting a new repository the pmcp way, adding pmcp to a repository that has no agent assets yet, enabling hooks, sessions or the git workflow, or when asked to write a pmcp.toml. Not for moving existing scattered agent files (migrate them instead) or for hosting a skills server.
3
+ description: Set up a repository so every coding agent reads the same instructions, skills, subagents, rules and MCP servers - one AGENTS.md with CLAUDE.md linked to it and Gemini CLI set to read it, sources under .agents/, a pmcp.toml with [targets] and [mcp.*] entries, then the optional layers chosen from what the repository is (hook guards, sessions, the git workflow when it is a git checkout, logging, shared MCP authentication, marketplaces), then pmcp project and pmcp doctor, plus the one-time trust step each agent CLI needs. Use when starting a new repository the pmcp way, adding pmcp to a repository that has no agent assets yet, enabling hooks, sessions or the git workflow, or when asked to write a pmcp.toml. Not for moving existing scattered agent files (migrate them instead) or for hosting a skills server.
4
4
  metadata:
5
5
  tier: open
6
6
  level: L2
@@ -22,18 +22,22 @@ Install `@modootoday/pmcp` as a dev dependency. Never run the bare unscoped name
22
22
  through npx: that name is not the package, and whoever publishes it later would run in your
23
23
  repository.
24
24
 
25
- ## 1. Instructions: one file, two links
25
+ ## 1. Instructions: one file, one link, one setting
26
26
 
27
27
  ```sh
28
28
  printf '# <project>\n\n' > AGENTS.md
29
29
  ln -s AGENTS.md CLAUDE.md
30
- ln -s AGENTS.md GEMINI.md
30
+ mkdir -p .gemini
31
+ printf '{\n "context": { "fileName": ["AGENTS.md"] }\n}\n' > .gemini/settings.json
31
32
  ```
32
33
 
33
- `AGENTS.md` is the real file. Claude Code reads `CLAUDE.md` and Gemini CLI `GEMINI.md`, so
34
- the links make them read the same text. pmcp does not create these links. Keep them
35
- file-to-file links; a directory symlink at the repository root (for example `.agents`
36
- pointing at another folder) is rejected by the Codex sandbox.
34
+ `AGENTS.md` is the real file. Claude Code reads `CLAUDE.md`, so the link makes it read the
35
+ same text. Gemini CLI reads every name in `context.fileName`, in each directory, so the
36
+ setting makes it read `AGENTS.md` itself, nested ones included, and no `GEMINI.md` is
37
+ needed. If `.gemini/settings.json` already exists, add the key to it; `pmcp project` keeps
38
+ keys it does not own. pmcp creates neither the link nor the setting. Keep the link
39
+ file-to-file; a directory symlink at the repository root (for example `.agents` pointing at
40
+ another folder) is rejected by the Codex sandbox.
37
41
 
38
42
  ## 2. Sources under .agents/
39
43