argsbarg 6.3.2 → 7.0.0

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 (48) hide show
  1. package/CHANGELOG.md +17 -3
  2. package/README.md +2 -2
  3. package/docs/README.md +2 -2
  4. package/docs/ai-skills.md +7 -7
  5. package/docs/bundled-docs.md +2 -2
  6. package/docs/cli-program.md +4 -4
  7. package/docs/configure.md +57 -85
  8. package/docs/developing.md +3 -3
  9. package/docs/distribution-homebrew.md +22 -23
  10. package/docs/mcp.md +3 -3
  11. package/examples/full-example/Formula/full-example.rb +7 -9
  12. package/examples/full-example/docs/cli-schema.json +48 -60
  13. package/examples/full-example/docs/cli.md +66 -36
  14. package/examples/full-example/docs/mcp.md +2 -2
  15. package/examples/full-example/docs/skill.md +1 -1
  16. package/examples/full-example/justfile +12 -12
  17. package/examples/full-example/scripts/formula-shared.ts +7 -13
  18. package/examples/full-example-json/Formula/full-example-json.rb +7 -9
  19. package/examples/full-example-json/docs/cli-schema.json +216 -270
  20. package/examples/full-example-json/docs/cli.md +297 -162
  21. package/examples/full-example-json/docs/mcp.md +2 -2
  22. package/examples/full-example-json/docs/skill.md +1 -1
  23. package/examples/full-example-json/justfile +12 -13
  24. package/examples/full-example-json/scripts/formula-shared.ts +7 -13
  25. package/index.d.ts +7 -8
  26. package/package.json +1 -1
  27. package/src/builtins/builtins.test.ts +21 -28
  28. package/src/builtins/configure-copy.ts +17 -20
  29. package/src/builtins/configure.ts +45 -74
  30. package/src/builtins/dispatch.ts +1 -8
  31. package/src/builtins/index.ts +1 -1
  32. package/src/cli-tool/create.ts +3 -1
  33. package/src/cli-tool/post-create.ts +5 -1
  34. package/src/config/file.ts +1 -0
  35. package/src/config/resolve.ts +1 -1
  36. package/src/configure/artifacts/mcp-config.ts +18 -12
  37. package/src/configure/artifacts/target-mcp-json.ts +19 -18
  38. package/src/configure/artifacts/target-skill.ts +8 -3
  39. package/src/configure/artifacts/targets/agents-mcp.ts +1 -1
  40. package/src/configure/artifacts/targets/configure.ts +2 -3
  41. package/src/configure/artifacts/uninstall.ts +5 -1
  42. package/src/configure/configure.test.ts +45 -113
  43. package/src/configure/index.ts +64 -354
  44. package/src/core/types.ts +7 -8
  45. package/src/docs/docs.test.ts +2 -2
  46. package/src/docs/mcp-guide.ts +2 -2
  47. package/src/skill/generate.ts +1 -1
  48. package/src/skill/install.ts +2 -1
package/examples/full-example-json/docs/cli-schema.json CHANGED
@@ -21,42 +21,36 @@
21
21
  {
22
22
  "key": "configure",
23
23
  "description": "Set up agent skills and MCP config for this app (binary via Homebrew).",
24
- "notes": "Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).\n\nHomebrew post_install runs:\n full-example-json configure --refresh --yes\n\nInteractive setup (per target):\n full-example-json configure\n\nUpgrade:\n brew upgrade full-example-json\n\nShell completions are installed by Homebrew during brew install.\nSee: https://docs.brew.sh/Shell-Completion\n\nSee what is installed:\n full-example-json configure --status\n\nUninstall:\n brew uninstall <tap>/full-example-json\n\nThe formula uninstall hook runs `configure --remove-all --yes` (skills, MCP, and app config).\n\nUse --dry to preview changes without writing files.\nUse --json for machine-readable output.",
25
- "options": [
24
+ "notes": "Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).\n\nHomebrew installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.\n\nAfter install or upgrade:\n full-example-json configure install\n\nUpgrade:\n brew upgrade full-example-json\n full-example-json configure install\n\nShell completions are installed by Homebrew during brew install.\nSee: https://docs.brew.sh/Shell-Completion\n\nSee what is installed:\n full-example-json configure status\n\nUninstall:\n full-example-json configure uninstall\n brew uninstall <tap>/full-example-json\n\nUse `configure status --json` for machine-readable output.",
25
+ "commands": [
26
26
  {
27
- "name": "refresh",
28
- "description": "Refresh installed skills and MCP. Used by Homebrew post_install.",
29
- "kind": "presence"
27
+ "key": "install",
28
+ "description": "Install agent artifacts and bootstrap app config."
30
29
  },
31
30
  {
32
- "name": "remove-all",
33
- "description": "Remove all detected agent artifacts (skills and MCP).",
34
- "kind": "presence"
31
+ "key": "uninstall",
32
+ "description": "Remove agent artifacts and app config.",
33
+ "options": [
34
+ {
35
+ "name": "yes",
36
+ "description": "Skip uninstall confirmation.",
37
+ "kind": "presence",
38
+ "shortName": "y"
39
+ }
40
+ ]
35
41
  },
36
42
  {
37
- "name": "status",
43
+ "key": "status",
38
44
  "description": "Print what is currently installed (read-only).",
39
- "kind": "presence"
40
- },
41
- {
42
- "name": "yes",
43
- "description": "Skip confirmation (required for --refresh, --remove-all, --remove-config).",
44
- "kind": "presence",
45
- "shortName": "y"
46
- },
47
- {
48
- "name": "dry",
49
- "description": "Show what would change without writing files.",
50
- "kind": "presence"
51
- },
52
- {
53
- "name": "json",
54
- "description": "Print changed paths or status JSON on stdout.",
55
- "kind": "presence"
45
+ "options": [
46
+ {
47
+ "name": "json",
48
+ "description": "Print status JSON on stdout.",
49
+ "kind": "presence"
50
+ }
51
+ ]
56
52
  }
57
- ],
58
- "fallbackCommand": "run",
59
- "fallbackMode": "missingOnly"
53
+ ]
60
54
  },
61
55
  {
62
56
  "key": "docs",
@@ -138,7 +132,7 @@
138
132
  },
139
133
  {
140
134
  "key": "skill",
141
- "description": "Print a reference agent SKILL; run `configure` to install an optimized copy.",
135
+ "description": "Print a reference agent SKILL; run `configure install` to install an optimized copy.",
142
136
  "options": [
143
137
  {
144
138
  "name": "save",
@@ -254,42 +248,36 @@
254
248
  {
255
249
  "key": "configure",
256
250
  "description": "Set up agent skills and MCP config for this app (binary via Homebrew).",
257
- "notes": "Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).\n\nHomebrew post_install runs:\n full-example-json configure --refresh --yes\n\nInteractive setup (per target):\n full-example-json configure\n\nUpgrade:\n brew upgrade full-example-json\n\nShell completions are installed by Homebrew during brew install.\nSee: https://docs.brew.sh/Shell-Completion\n\nSee what is installed:\n full-example-json configure --status\n\nUninstall:\n brew uninstall <tap>/full-example-json\n\nThe formula uninstall hook runs `configure --remove-all --yes` (skills, MCP, and app config).\n\nUse --dry to preview changes without writing files.\nUse --json for machine-readable output.",
258
- "options": [
251
+ "notes": "Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).\n\nHomebrew installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.\n\nAfter install or upgrade:\n full-example-json configure install\n\nUpgrade:\n brew upgrade full-example-json\n full-example-json configure install\n\nShell completions are installed by Homebrew during brew install.\nSee: https://docs.brew.sh/Shell-Completion\n\nSee what is installed:\n full-example-json configure status\n\nUninstall:\n full-example-json configure uninstall\n brew uninstall <tap>/full-example-json\n\nUse `configure status --json` for machine-readable output.",
252
+ "commands": [
259
253
  {
260
- "name": "refresh",
261
- "description": "Refresh installed skills and MCP. Used by Homebrew post_install.",
262
- "kind": "presence"
254
+ "key": "install",
255
+ "description": "Install agent artifacts and bootstrap app config."
263
256
  },
264
257
  {
265
- "name": "remove-all",
266
- "description": "Remove all detected agent artifacts (skills and MCP).",
267
- "kind": "presence"
258
+ "key": "uninstall",
259
+ "description": "Remove agent artifacts and app config.",
260
+ "options": [
261
+ {
262
+ "name": "yes",
263
+ "description": "Skip uninstall confirmation.",
264
+ "kind": "presence",
265
+ "shortName": "y"
266
+ }
267
+ ]
268
268
  },
269
269
  {
270
- "name": "status",
270
+ "key": "status",
271
271
  "description": "Print what is currently installed (read-only).",
272
- "kind": "presence"
273
- },
274
- {
275
- "name": "yes",
276
- "description": "Skip confirmation (required for --refresh, --remove-all, --remove-config).",
277
- "kind": "presence",
278
- "shortName": "y"
279
- },
280
- {
281
- "name": "dry",
282
- "description": "Show what would change without writing files.",
283
- "kind": "presence"
284
- },
285
- {
286
- "name": "json",
287
- "description": "Print changed paths or status JSON on stdout.",
288
- "kind": "presence"
272
+ "options": [
273
+ {
274
+ "name": "json",
275
+ "description": "Print status JSON on stdout.",
276
+ "kind": "presence"
277
+ }
278
+ ]
289
279
  }
290
- ],
291
- "fallbackCommand": "run",
292
- "fallbackMode": "missingOnly"
280
+ ]
293
281
  },
294
282
  {
295
283
  "key": "docs",
@@ -371,7 +359,7 @@
371
359
  },
372
360
  {
373
361
  "key": "skill",
374
- "description": "Print a reference agent SKILL; run `configure` to install an optimized copy.",
362
+ "description": "Print a reference agent SKILL; run `configure install` to install an optimized copy.",
375
363
  "options": [
376
364
  {
377
365
  "name": "save",
@@ -509,42 +497,36 @@
509
497
  {
510
498
  "key": "configure",
511
499
  "description": "Set up agent skills and MCP config for this app (binary via Homebrew).",
512
- "notes": "Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).\n\nHomebrew post_install runs:\n full-example-json configure --refresh --yes\n\nInteractive setup (per target):\n full-example-json configure\n\nUpgrade:\n brew upgrade full-example-json\n\nShell completions are installed by Homebrew during brew install.\nSee: https://docs.brew.sh/Shell-Completion\n\nSee what is installed:\n full-example-json configure --status\n\nUninstall:\n brew uninstall <tap>/full-example-json\n\nThe formula uninstall hook runs `configure --remove-all --yes` (skills, MCP, and app config).\n\nUse --dry to preview changes without writing files.\nUse --json for machine-readable output.",
513
- "options": [
500
+ "notes": "Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).\n\nHomebrew installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.\n\nAfter install or upgrade:\n full-example-json configure install\n\nUpgrade:\n brew upgrade full-example-json\n full-example-json configure install\n\nShell completions are installed by Homebrew during brew install.\nSee: https://docs.brew.sh/Shell-Completion\n\nSee what is installed:\n full-example-json configure status\n\nUninstall:\n full-example-json configure uninstall\n brew uninstall <tap>/full-example-json\n\nUse `configure status --json` for machine-readable output.",
501
+ "commands": [
514
502
  {
515
- "name": "refresh",
516
- "description": "Refresh installed skills and MCP. Used by Homebrew post_install.",
517
- "kind": "presence"
503
+ "key": "install",
504
+ "description": "Install agent artifacts and bootstrap app config."
518
505
  },
519
506
  {
520
- "name": "remove-all",
521
- "description": "Remove all detected agent artifacts (skills and MCP).",
522
- "kind": "presence"
507
+ "key": "uninstall",
508
+ "description": "Remove agent artifacts and app config.",
509
+ "options": [
510
+ {
511
+ "name": "yes",
512
+ "description": "Skip uninstall confirmation.",
513
+ "kind": "presence",
514
+ "shortName": "y"
515
+ }
516
+ ]
523
517
  },
524
518
  {
525
- "name": "status",
519
+ "key": "status",
526
520
  "description": "Print what is currently installed (read-only).",
527
- "kind": "presence"
528
- },
529
- {
530
- "name": "yes",
531
- "description": "Skip confirmation (required for --refresh, --remove-all, --remove-config).",
532
- "kind": "presence",
533
- "shortName": "y"
534
- },
535
- {
536
- "name": "dry",
537
- "description": "Show what would change without writing files.",
538
- "kind": "presence"
539
- },
540
- {
541
- "name": "json",
542
- "description": "Print changed paths or status JSON on stdout.",
543
- "kind": "presence"
521
+ "options": [
522
+ {
523
+ "name": "json",
524
+ "description": "Print status JSON on stdout.",
525
+ "kind": "presence"
526
+ }
527
+ ]
544
528
  }
545
- ],
546
- "fallbackCommand": "run",
547
- "fallbackMode": "missingOnly"
529
+ ]
548
530
  },
549
531
  {
550
532
  "key": "docs",
@@ -626,7 +608,7 @@
626
608
  },
627
609
  {
628
610
  "key": "skill",
629
- "description": "Print a reference agent SKILL; run `configure` to install an optimized copy.",
611
+ "description": "Print a reference agent SKILL; run `configure install` to install an optimized copy.",
630
612
  "options": [
631
613
  {
632
614
  "name": "save",
@@ -746,42 +728,36 @@
746
728
  {
747
729
  "key": "configure",
748
730
  "description": "Set up agent skills and MCP config for this app (binary via Homebrew).",
749
- "notes": "Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).\n\nHomebrew post_install runs:\n full-example-json configure --refresh --yes\n\nInteractive setup (per target):\n full-example-json configure\n\nUpgrade:\n brew upgrade full-example-json\n\nShell completions are installed by Homebrew during brew install.\nSee: https://docs.brew.sh/Shell-Completion\n\nSee what is installed:\n full-example-json configure --status\n\nUninstall:\n brew uninstall <tap>/full-example-json\n\nThe formula uninstall hook runs `configure --remove-all --yes` (skills, MCP, and app config).\n\nUse --dry to preview changes without writing files.\nUse --json for machine-readable output.",
750
- "options": [
731
+ "notes": "Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).\n\nHomebrew installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.\n\nAfter install or upgrade:\n full-example-json configure install\n\nUpgrade:\n brew upgrade full-example-json\n full-example-json configure install\n\nShell completions are installed by Homebrew during brew install.\nSee: https://docs.brew.sh/Shell-Completion\n\nSee what is installed:\n full-example-json configure status\n\nUninstall:\n full-example-json configure uninstall\n brew uninstall <tap>/full-example-json\n\nUse `configure status --json` for machine-readable output.",
732
+ "commands": [
751
733
  {
752
- "name": "refresh",
753
- "description": "Refresh installed skills and MCP. Used by Homebrew post_install.",
754
- "kind": "presence"
734
+ "key": "install",
735
+ "description": "Install agent artifacts and bootstrap app config."
755
736
  },
756
737
  {
757
- "name": "remove-all",
758
- "description": "Remove all detected agent artifacts (skills and MCP).",
759
- "kind": "presence"
738
+ "key": "uninstall",
739
+ "description": "Remove agent artifacts and app config.",
740
+ "options": [
741
+ {
742
+ "name": "yes",
743
+ "description": "Skip uninstall confirmation.",
744
+ "kind": "presence",
745
+ "shortName": "y"
746
+ }
747
+ ]
760
748
  },
761
749
  {
762
- "name": "status",
750
+ "key": "status",
763
751
  "description": "Print what is currently installed (read-only).",
764
- "kind": "presence"
765
- },
766
- {
767
- "name": "yes",
768
- "description": "Skip confirmation (required for --refresh, --remove-all, --remove-config).",
769
- "kind": "presence",
770
- "shortName": "y"
771
- },
772
- {
773
- "name": "dry",
774
- "description": "Show what would change without writing files.",
775
- "kind": "presence"
776
- },
777
- {
778
- "name": "json",
779
- "description": "Print changed paths or status JSON on stdout.",
780
- "kind": "presence"
752
+ "options": [
753
+ {
754
+ "name": "json",
755
+ "description": "Print status JSON on stdout.",
756
+ "kind": "presence"
757
+ }
758
+ ]
781
759
  }
782
- ],
783
- "fallbackCommand": "run",
784
- "fallbackMode": "missingOnly"
760
+ ]
785
761
  },
786
762
  {
787
763
  "key": "docs",
@@ -863,7 +839,7 @@
863
839
  },
864
840
  {
865
841
  "key": "skill",
866
- "description": "Print a reference agent SKILL; run `configure` to install an optimized copy.",
842
+ "description": "Print a reference agent SKILL; run `configure install` to install an optimized copy.",
867
843
  "options": [
868
844
  {
869
845
  "name": "save",
@@ -979,42 +955,36 @@
979
955
  {
980
956
  "key": "configure",
981
957
  "description": "Set up agent skills and MCP config for this app (binary via Homebrew).",
982
- "notes": "Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).\n\nHomebrew post_install runs:\n full-example-json configure --refresh --yes\n\nInteractive setup (per target):\n full-example-json configure\n\nUpgrade:\n brew upgrade full-example-json\n\nShell completions are installed by Homebrew during brew install.\nSee: https://docs.brew.sh/Shell-Completion\n\nSee what is installed:\n full-example-json configure --status\n\nUninstall:\n brew uninstall <tap>/full-example-json\n\nThe formula uninstall hook runs `configure --remove-all --yes` (skills, MCP, and app config).\n\nUse --dry to preview changes without writing files.\nUse --json for machine-readable output.",
983
- "options": [
958
+ "notes": "Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).\n\nHomebrew installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.\n\nAfter install or upgrade:\n full-example-json configure install\n\nUpgrade:\n brew upgrade full-example-json\n full-example-json configure install\n\nShell completions are installed by Homebrew during brew install.\nSee: https://docs.brew.sh/Shell-Completion\n\nSee what is installed:\n full-example-json configure status\n\nUninstall:\n full-example-json configure uninstall\n brew uninstall <tap>/full-example-json\n\nUse `configure status --json` for machine-readable output.",
959
+ "commands": [
984
960
  {
985
- "name": "refresh",
986
- "description": "Refresh installed skills and MCP. Used by Homebrew post_install.",
987
- "kind": "presence"
961
+ "key": "install",
962
+ "description": "Install agent artifacts and bootstrap app config."
988
963
  },
989
964
  {
990
- "name": "remove-all",
991
- "description": "Remove all detected agent artifacts (skills and MCP).",
992
- "kind": "presence"
965
+ "key": "uninstall",
966
+ "description": "Remove agent artifacts and app config.",
967
+ "options": [
968
+ {
969
+ "name": "yes",
970
+ "description": "Skip uninstall confirmation.",
971
+ "kind": "presence",
972
+ "shortName": "y"
973
+ }
974
+ ]
993
975
  },
994
976
  {
995
- "name": "status",
977
+ "key": "status",
996
978
  "description": "Print what is currently installed (read-only).",
997
- "kind": "presence"
998
- },
999
- {
1000
- "name": "yes",
1001
- "description": "Skip confirmation (required for --refresh, --remove-all, --remove-config).",
1002
- "kind": "presence",
1003
- "shortName": "y"
1004
- },
1005
- {
1006
- "name": "dry",
1007
- "description": "Show what would change without writing files.",
1008
- "kind": "presence"
1009
- },
1010
- {
1011
- "name": "json",
1012
- "description": "Print changed paths or status JSON on stdout.",
1013
- "kind": "presence"
979
+ "options": [
980
+ {
981
+ "name": "json",
982
+ "description": "Print status JSON on stdout.",
983
+ "kind": "presence"
984
+ }
985
+ ]
1014
986
  }
1015
- ],
1016
- "fallbackCommand": "run",
1017
- "fallbackMode": "missingOnly"
987
+ ]
1018
988
  },
1019
989
  {
1020
990
  "key": "docs",
@@ -1096,7 +1066,7 @@
1096
1066
  },
1097
1067
  {
1098
1068
  "key": "skill",
1099
- "description": "Print a reference agent SKILL; run `configure` to install an optimized copy.",
1069
+ "description": "Print a reference agent SKILL; run `configure install` to install an optimized copy.",
1100
1070
  "options": [
1101
1071
  {
1102
1072
  "name": "save",
@@ -1216,42 +1186,36 @@
1216
1186
  {
1217
1187
  "key": "configure",
1218
1188
  "description": "Set up agent skills and MCP config for this app (binary via Homebrew).",
1219
- "notes": "Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).\n\nHomebrew post_install runs:\n full-example-json configure --refresh --yes\n\nInteractive setup (per target):\n full-example-json configure\n\nUpgrade:\n brew upgrade full-example-json\n\nShell completions are installed by Homebrew during brew install.\nSee: https://docs.brew.sh/Shell-Completion\n\nSee what is installed:\n full-example-json configure --status\n\nUninstall:\n brew uninstall <tap>/full-example-json\n\nThe formula uninstall hook runs `configure --remove-all --yes` (skills, MCP, and app config).\n\nUse --dry to preview changes without writing files.\nUse --json for machine-readable output.",
1220
- "options": [
1189
+ "notes": "Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).\n\nHomebrew installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.\n\nAfter install or upgrade:\n full-example-json configure install\n\nUpgrade:\n brew upgrade full-example-json\n full-example-json configure install\n\nShell completions are installed by Homebrew during brew install.\nSee: https://docs.brew.sh/Shell-Completion\n\nSee what is installed:\n full-example-json configure status\n\nUninstall:\n full-example-json configure uninstall\n brew uninstall <tap>/full-example-json\n\nUse `configure status --json` for machine-readable output.",
1190
+ "commands": [
1221
1191
  {
1222
- "name": "refresh",
1223
- "description": "Refresh installed skills and MCP. Used by Homebrew post_install.",
1224
- "kind": "presence"
1192
+ "key": "install",
1193
+ "description": "Install agent artifacts and bootstrap app config."
1225
1194
  },
1226
1195
  {
1227
- "name": "remove-all",
1228
- "description": "Remove all detected agent artifacts (skills and MCP).",
1229
- "kind": "presence"
1196
+ "key": "uninstall",
1197
+ "description": "Remove agent artifacts and app config.",
1198
+ "options": [
1199
+ {
1200
+ "name": "yes",
1201
+ "description": "Skip uninstall confirmation.",
1202
+ "kind": "presence",
1203
+ "shortName": "y"
1204
+ }
1205
+ ]
1230
1206
  },
1231
1207
  {
1232
- "name": "status",
1208
+ "key": "status",
1233
1209
  "description": "Print what is currently installed (read-only).",
1234
- "kind": "presence"
1235
- },
1236
- {
1237
- "name": "yes",
1238
- "description": "Skip confirmation (required for --refresh, --remove-all, --remove-config).",
1239
- "kind": "presence",
1240
- "shortName": "y"
1241
- },
1242
- {
1243
- "name": "dry",
1244
- "description": "Show what would change without writing files.",
1245
- "kind": "presence"
1246
- },
1247
- {
1248
- "name": "json",
1249
- "description": "Print changed paths or status JSON on stdout.",
1250
- "kind": "presence"
1210
+ "options": [
1211
+ {
1212
+ "name": "json",
1213
+ "description": "Print status JSON on stdout.",
1214
+ "kind": "presence"
1215
+ }
1216
+ ]
1251
1217
  }
1252
- ],
1253
- "fallbackCommand": "run",
1254
- "fallbackMode": "missingOnly"
1218
+ ]
1255
1219
  },
1256
1220
  {
1257
1221
  "key": "docs",
@@ -1333,7 +1297,7 @@
1333
1297
  },
1334
1298
  {
1335
1299
  "key": "skill",
1336
- "description": "Print a reference agent SKILL; run `configure` to install an optimized copy.",
1300
+ "description": "Print a reference agent SKILL; run `configure install` to install an optimized copy.",
1337
1301
  "options": [
1338
1302
  {
1339
1303
  "name": "save",
@@ -1449,42 +1413,36 @@
1449
1413
  {
1450
1414
  "key": "configure",
1451
1415
  "description": "Set up agent skills and MCP config for this app (binary via Homebrew).",
1452
- "notes": "Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).\n\nHomebrew post_install runs:\n full-example-json configure --refresh --yes\n\nInteractive setup (per target):\n full-example-json configure\n\nUpgrade:\n brew upgrade full-example-json\n\nShell completions are installed by Homebrew during brew install.\nSee: https://docs.brew.sh/Shell-Completion\n\nSee what is installed:\n full-example-json configure --status\n\nUninstall:\n brew uninstall <tap>/full-example-json\n\nThe formula uninstall hook runs `configure --remove-all --yes` (skills, MCP, and app config).\n\nUse --dry to preview changes without writing files.\nUse --json for machine-readable output.",
1453
- "options": [
1416
+ "notes": "Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).\n\nHomebrew installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.\n\nAfter install or upgrade:\n full-example-json configure install\n\nUpgrade:\n brew upgrade full-example-json\n full-example-json configure install\n\nShell completions are installed by Homebrew during brew install.\nSee: https://docs.brew.sh/Shell-Completion\n\nSee what is installed:\n full-example-json configure status\n\nUninstall:\n full-example-json configure uninstall\n brew uninstall <tap>/full-example-json\n\nUse `configure status --json` for machine-readable output.",
1417
+ "commands": [
1454
1418
  {
1455
- "name": "refresh",
1456
- "description": "Refresh installed skills and MCP. Used by Homebrew post_install.",
1457
- "kind": "presence"
1419
+ "key": "install",
1420
+ "description": "Install agent artifacts and bootstrap app config."
1458
1421
  },
1459
1422
  {
1460
- "name": "remove-all",
1461
- "description": "Remove all detected agent artifacts (skills and MCP).",
1462
- "kind": "presence"
1423
+ "key": "uninstall",
1424
+ "description": "Remove agent artifacts and app config.",
1425
+ "options": [
1426
+ {
1427
+ "name": "yes",
1428
+ "description": "Skip uninstall confirmation.",
1429
+ "kind": "presence",
1430
+ "shortName": "y"
1431
+ }
1432
+ ]
1463
1433
  },
1464
1434
  {
1465
- "name": "status",
1435
+ "key": "status",
1466
1436
  "description": "Print what is currently installed (read-only).",
1467
- "kind": "presence"
1468
- },
1469
- {
1470
- "name": "yes",
1471
- "description": "Skip confirmation (required for --refresh, --remove-all, --remove-config).",
1472
- "kind": "presence",
1473
- "shortName": "y"
1474
- },
1475
- {
1476
- "name": "dry",
1477
- "description": "Show what would change without writing files.",
1478
- "kind": "presence"
1479
- },
1480
- {
1481
- "name": "json",
1482
- "description": "Print changed paths or status JSON on stdout.",
1483
- "kind": "presence"
1437
+ "options": [
1438
+ {
1439
+ "name": "json",
1440
+ "description": "Print status JSON on stdout.",
1441
+ "kind": "presence"
1442
+ }
1443
+ ]
1484
1444
  }
1485
- ],
1486
- "fallbackCommand": "run",
1487
- "fallbackMode": "missingOnly"
1445
+ ]
1488
1446
  },
1489
1447
  {
1490
1448
  "key": "docs",
@@ -1566,7 +1524,7 @@
1566
1524
  },
1567
1525
  {
1568
1526
  "key": "skill",
1569
- "description": "Print a reference agent SKILL; run `configure` to install an optimized copy.",
1527
+ "description": "Print a reference agent SKILL; run `configure install` to install an optimized copy.",
1570
1528
  "options": [
1571
1529
  {
1572
1530
  "name": "save",
@@ -1682,42 +1640,36 @@
1682
1640
  {
1683
1641
  "key": "configure",
1684
1642
  "description": "Set up agent skills and MCP config for this app (binary via Homebrew).",
1685
- "notes": "Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).\n\nHomebrew post_install runs:\n full-example-json configure --refresh --yes\n\nInteractive setup (per target):\n full-example-json configure\n\nUpgrade:\n brew upgrade full-example-json\n\nShell completions are installed by Homebrew during brew install.\nSee: https://docs.brew.sh/Shell-Completion\n\nSee what is installed:\n full-example-json configure --status\n\nUninstall:\n brew uninstall <tap>/full-example-json\n\nThe formula uninstall hook runs `configure --remove-all --yes` (skills, MCP, and app config).\n\nUse --dry to preview changes without writing files.\nUse --json for machine-readable output.",
1686
- "options": [
1643
+ "notes": "Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).\n\nHomebrew installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.\n\nAfter install or upgrade:\n full-example-json configure install\n\nUpgrade:\n brew upgrade full-example-json\n full-example-json configure install\n\nShell completions are installed by Homebrew during brew install.\nSee: https://docs.brew.sh/Shell-Completion\n\nSee what is installed:\n full-example-json configure status\n\nUninstall:\n full-example-json configure uninstall\n brew uninstall <tap>/full-example-json\n\nUse `configure status --json` for machine-readable output.",
1644
+ "commands": [
1687
1645
  {
1688
- "name": "refresh",
1689
- "description": "Refresh installed skills and MCP. Used by Homebrew post_install.",
1690
- "kind": "presence"
1646
+ "key": "install",
1647
+ "description": "Install agent artifacts and bootstrap app config."
1691
1648
  },
1692
1649
  {
1693
- "name": "remove-all",
1694
- "description": "Remove all detected agent artifacts (skills and MCP).",
1695
- "kind": "presence"
1650
+ "key": "uninstall",
1651
+ "description": "Remove agent artifacts and app config.",
1652
+ "options": [
1653
+ {
1654
+ "name": "yes",
1655
+ "description": "Skip uninstall confirmation.",
1656
+ "kind": "presence",
1657
+ "shortName": "y"
1658
+ }
1659
+ ]
1696
1660
  },
1697
1661
  {
1698
- "name": "status",
1662
+ "key": "status",
1699
1663
  "description": "Print what is currently installed (read-only).",
1700
- "kind": "presence"
1701
- },
1702
- {
1703
- "name": "yes",
1704
- "description": "Skip confirmation (required for --refresh, --remove-all, --remove-config).",
1705
- "kind": "presence",
1706
- "shortName": "y"
1707
- },
1708
- {
1709
- "name": "dry",
1710
- "description": "Show what would change without writing files.",
1711
- "kind": "presence"
1712
- },
1713
- {
1714
- "name": "json",
1715
- "description": "Print changed paths or status JSON on stdout.",
1716
- "kind": "presence"
1664
+ "options": [
1665
+ {
1666
+ "name": "json",
1667
+ "description": "Print status JSON on stdout.",
1668
+ "kind": "presence"
1669
+ }
1670
+ ]
1717
1671
  }
1718
- ],
1719
- "fallbackCommand": "run",
1720
- "fallbackMode": "missingOnly"
1672
+ ]
1721
1673
  },
1722
1674
  {
1723
1675
  "key": "docs",
@@ -1799,7 +1751,7 @@
1799
1751
  },
1800
1752
  {
1801
1753
  "key": "skill",
1802
- "description": "Print a reference agent SKILL; run `configure` to install an optimized copy.",
1754
+ "description": "Print a reference agent SKILL; run `configure install` to install an optimized copy.",
1803
1755
  "options": [
1804
1756
  {
1805
1757
  "name": "save",
@@ -1915,42 +1867,36 @@
1915
1867
  {
1916
1868
  "key": "configure",
1917
1869
  "description": "Set up agent skills and MCP config for this app (binary via Homebrew).",
1918
- "notes": "Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).\n\nHomebrew post_install runs:\n full-example-json configure --refresh --yes\n\nInteractive setup (per target):\n full-example-json configure\n\nUpgrade:\n brew upgrade full-example-json\n\nShell completions are installed by Homebrew during brew install.\nSee: https://docs.brew.sh/Shell-Completion\n\nSee what is installed:\n full-example-json configure --status\n\nUninstall:\n brew uninstall <tap>/full-example-json\n\nThe formula uninstall hook runs `configure --remove-all --yes` (skills, MCP, and app config).\n\nUse --dry to preview changes without writing files.\nUse --json for machine-readable output.",
1919
- "options": [
1870
+ "notes": "Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).\n\nHomebrew installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.\n\nAfter install or upgrade:\n full-example-json configure install\n\nUpgrade:\n brew upgrade full-example-json\n full-example-json configure install\n\nShell completions are installed by Homebrew during brew install.\nSee: https://docs.brew.sh/Shell-Completion\n\nSee what is installed:\n full-example-json configure status\n\nUninstall:\n full-example-json configure uninstall\n brew uninstall <tap>/full-example-json\n\nUse `configure status --json` for machine-readable output.",
1871
+ "commands": [
1920
1872
  {
1921
- "name": "refresh",
1922
- "description": "Refresh installed skills and MCP. Used by Homebrew post_install.",
1923
- "kind": "presence"
1873
+ "key": "install",
1874
+ "description": "Install agent artifacts and bootstrap app config."
1924
1875
  },
1925
1876
  {
1926
- "name": "remove-all",
1927
- "description": "Remove all detected agent artifacts (skills and MCP).",
1928
- "kind": "presence"
1877
+ "key": "uninstall",
1878
+ "description": "Remove agent artifacts and app config.",
1879
+ "options": [
1880
+ {
1881
+ "name": "yes",
1882
+ "description": "Skip uninstall confirmation.",
1883
+ "kind": "presence",
1884
+ "shortName": "y"
1885
+ }
1886
+ ]
1929
1887
  },
1930
1888
  {
1931
- "name": "status",
1889
+ "key": "status",
1932
1890
  "description": "Print what is currently installed (read-only).",
1933
- "kind": "presence"
1934
- },
1935
- {
1936
- "name": "yes",
1937
- "description": "Skip confirmation (required for --refresh, --remove-all, --remove-config).",
1938
- "kind": "presence",
1939
- "shortName": "y"
1940
- },
1941
- {
1942
- "name": "dry",
1943
- "description": "Show what would change without writing files.",
1944
- "kind": "presence"
1945
- },
1946
- {
1947
- "name": "json",
1948
- "description": "Print changed paths or status JSON on stdout.",
1949
- "kind": "presence"
1891
+ "options": [
1892
+ {
1893
+ "name": "json",
1894
+ "description": "Print status JSON on stdout.",
1895
+ "kind": "presence"
1896
+ }
1897
+ ]
1950
1898
  }
1951
- ],
1952
- "fallbackCommand": "run",
1953
- "fallbackMode": "missingOnly"
1899
+ ]
1954
1900
  },
1955
1901
  {
1956
1902
  "key": "docs",
@@ -2032,7 +1978,7 @@
2032
1978
  },
2033
1979
  {
2034
1980
  "key": "skill",
2035
- "description": "Print a reference agent SKILL; run `configure` to install an optimized copy.",
1981
+ "description": "Print a reference agent SKILL; run `configure install` to install an optimized copy.",
2036
1982
  "options": [
2037
1983
  {
2038
1984
  "name": "save",