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.md CHANGED
@@ -45,41 +45,56 @@ Set up agent skills and MCP config for this app (binary via Homebrew).
45
45
 
46
46
  > Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).
47
47
  >
48
- > Homebrew post_install runs:
49
- > full-example-json configure --refresh --yes
48
+ > Homebrew installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.
50
49
  >
51
- > Interactive setup (per target):
52
- > full-example-json configure
50
+ > After install or upgrade:
51
+ > full-example-json configure install
53
52
  >
54
53
  > Upgrade:
55
54
  > brew upgrade full-example-json
55
+ > full-example-json configure install
56
56
  >
57
57
  > Shell completions are installed by Homebrew during brew install.
58
58
  > See: https://docs.brew.sh/Shell-Completion
59
59
  >
60
60
  > See what is installed:
61
- > full-example-json configure --status
61
+ > full-example-json configure status
62
62
  >
63
63
  > Uninstall:
64
+ > full-example-json configure uninstall
64
65
  > brew uninstall <tap>/full-example-json
65
66
  >
66
- > The formula uninstall hook runs `configure --remove-all --yes` (skills, MCP, and app config).
67
- >
68
- > Use --dry to preview changes without writing files.
69
- > Use --json for machine-readable output.
67
+ > Use `configure status --json` for machine-readable output.
68
+
69
+ #### Subcommands
70
+
71
+ - `install` — Install agent artifacts and bootstrap app config.
72
+ - `uninstall` — Remove agent artifacts and app config.
73
+ - `status` — Print what is currently installed (read-only).
70
74
 
71
- **Default subcommand:** `run` (`missingOnly`)
75
+ ##### `full-example-json echo configure install`
76
+
77
+ Install agent artifacts and bootstrap app config.
78
+
79
+ ##### `full-example-json echo configure uninstall`
80
+
81
+ Remove agent artifacts and app config.
72
82
 
73
83
  #### Options
74
84
 
75
85
  | Option | Type | Required | Format / default | Description |
76
86
  | --- | --- | --- | --- | --- |
77
- | `--refresh` | flag | optional | — | Refresh installed skills and MCP. Used by Homebrew post_install. |
78
- | `--remove-all` | flag | optional | — | Remove all detected agent artifacts (skills and MCP). |
79
- | `--status` | flag | optional | — | Print what is currently installed (read-only). |
80
- | `--yes` (`-y`) | flag | optional | — | Skip confirmation (required for --refresh, --remove-all, --remove-config). |
81
- | `--dry` | flag | optional | — | Show what would change without writing files. |
82
- | `--json` | flag | optional | — | Print changed paths or status JSON on stdout. |
87
+ | `--yes` (`-y`) | flag | optional | — | Skip uninstall confirmation. |
88
+
89
+ ##### `full-example-json echo configure status`
90
+
91
+ Print what is currently installed (read-only).
92
+
93
+ #### Options
94
+
95
+ | Option | Type | Required | Format / default | Description |
96
+ | --- | --- | --- | --- | --- |
97
+ | `--json` | flag | optional | — | Print status JSON on stdout. |
83
98
 
84
99
  #### `full-example-json echo docs`
85
100
 
@@ -101,7 +116,7 @@ Print bundled CLI documentation.
101
116
  - `openapi` — Print the HTTP OpenAPI 3.1 document as JSON.
102
117
  - `cli-schema` — Print the full CLI command tree as JSON.
103
118
  - `cli` — Print the full command reference as markdown.
104
- - `skill` — Print a reference agent SKILL; run `configure` to install an optimized copy.
119
+ - `skill` — Print a reference agent SKILL; run `configure install` to install an optimized copy.
105
120
 
106
121
  ##### `full-example-json echo docs readme`
107
122
 
@@ -165,7 +180,7 @@ Print the full command reference as markdown.
165
180
 
166
181
  ##### `full-example-json echo docs skill`
167
182
 
168
- Print a reference agent SKILL; run `configure` to install an optimized copy.
183
+ Print a reference agent SKILL; run `configure install` to install an optimized copy.
169
184
 
170
185
  #### Options
171
186
 
@@ -258,41 +273,56 @@ Set up agent skills and MCP config for this app (binary via Homebrew).
258
273
 
259
274
  > Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).
260
275
  >
261
- > Homebrew post_install runs:
262
- > full-example-json configure --refresh --yes
276
+ > Homebrew installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.
263
277
  >
264
- > Interactive setup (per target):
265
- > full-example-json configure
278
+ > After install or upgrade:
279
+ > full-example-json configure install
266
280
  >
267
281
  > Upgrade:
268
282
  > brew upgrade full-example-json
283
+ > full-example-json configure install
269
284
  >
270
285
  > Shell completions are installed by Homebrew during brew install.
271
286
  > See: https://docs.brew.sh/Shell-Completion
272
287
  >
273
288
  > See what is installed:
274
- > full-example-json configure --status
289
+ > full-example-json configure status
275
290
  >
276
291
  > Uninstall:
292
+ > full-example-json configure uninstall
277
293
  > brew uninstall <tap>/full-example-json
278
294
  >
279
- > The formula uninstall hook runs `configure --remove-all --yes` (skills, MCP, and app config).
280
- >
281
- > Use --dry to preview changes without writing files.
282
- > Use --json for machine-readable output.
295
+ > Use `configure status --json` for machine-readable output.
283
296
 
284
- **Default subcommand:** `run` (`missingOnly`)
297
+ #### Subcommands
298
+
299
+ - `install` — Install agent artifacts and bootstrap app config.
300
+ - `uninstall` — Remove agent artifacts and app config.
301
+ - `status` — Print what is currently installed (read-only).
302
+
303
+ ##### `full-example-json render-json configure install`
304
+
305
+ Install agent artifacts and bootstrap app config.
306
+
307
+ ##### `full-example-json render-json configure uninstall`
308
+
309
+ Remove agent artifacts and app config.
285
310
 
286
311
  #### Options
287
312
 
288
313
  | Option | Type | Required | Format / default | Description |
289
314
  | --- | --- | --- | --- | --- |
290
- | `--refresh` | flag | optional | — | Refresh installed skills and MCP. Used by Homebrew post_install. |
291
- | `--remove-all` | flag | optional | — | Remove all detected agent artifacts (skills and MCP). |
292
- | `--status` | flag | optional | — | Print what is currently installed (read-only). |
293
- | `--yes` (`-y`) | flag | optional | — | Skip confirmation (required for --refresh, --remove-all, --remove-config). |
294
- | `--dry` | flag | optional | — | Show what would change without writing files. |
295
- | `--json` | flag | optional | — | Print changed paths or status JSON on stdout. |
315
+ | `--yes` (`-y`) | flag | optional | — | Skip uninstall confirmation. |
316
+
317
+ ##### `full-example-json render-json configure status`
318
+
319
+ Print what is currently installed (read-only).
320
+
321
+ #### Options
322
+
323
+ | Option | Type | Required | Format / default | Description |
324
+ | --- | --- | --- | --- | --- |
325
+ | `--json` | flag | optional | — | Print status JSON on stdout. |
296
326
 
297
327
  #### `full-example-json render-json docs`
298
328
 
@@ -314,7 +344,7 @@ Print bundled CLI documentation.
314
344
  - `openapi` — Print the HTTP OpenAPI 3.1 document as JSON.
315
345
  - `cli-schema` — Print the full CLI command tree as JSON.
316
346
  - `cli` — Print the full command reference as markdown.
317
- - `skill` — Print a reference agent SKILL; run `configure` to install an optimized copy.
347
+ - `skill` — Print a reference agent SKILL; run `configure install` to install an optimized copy.
318
348
 
319
349
  ##### `full-example-json render-json docs readme`
320
350
 
@@ -378,7 +408,7 @@ Print the full command reference as markdown.
378
408
 
379
409
  ##### `full-example-json render-json docs skill`
380
410
 
381
- Print a reference agent SKILL; run `configure` to install an optimized copy.
411
+ Print a reference agent SKILL; run `configure install` to install an optimized copy.
382
412
 
383
413
  #### Options
384
414
 
@@ -499,41 +529,56 @@ Set up agent skills and MCP config for this app (binary via Homebrew).
499
529
 
500
530
  > Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).
501
531
  >
502
- > Homebrew post_install runs:
503
- > full-example-json configure --refresh --yes
532
+ > Homebrew installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.
504
533
  >
505
- > Interactive setup (per target):
506
- > full-example-json configure
534
+ > After install or upgrade:
535
+ > full-example-json configure install
507
536
  >
508
537
  > Upgrade:
509
538
  > brew upgrade full-example-json
539
+ > full-example-json configure install
510
540
  >
511
541
  > Shell completions are installed by Homebrew during brew install.
512
542
  > See: https://docs.brew.sh/Shell-Completion
513
543
  >
514
544
  > See what is installed:
515
- > full-example-json configure --status
545
+ > full-example-json configure status
516
546
  >
517
547
  > Uninstall:
548
+ > full-example-json configure uninstall
518
549
  > brew uninstall <tap>/full-example-json
519
550
  >
520
- > The formula uninstall hook runs `configure --remove-all --yes` (skills, MCP, and app config).
521
- >
522
- > Use --dry to preview changes without writing files.
523
- > Use --json for machine-readable output.
551
+ > Use `configure status --json` for machine-readable output.
552
+
553
+ #### Subcommands
524
554
 
525
- **Default subcommand:** `run` (`missingOnly`)
555
+ - `install` — Install agent artifacts and bootstrap app config.
556
+ - `uninstall` — Remove agent artifacts and app config.
557
+ - `status` — Print what is currently installed (read-only).
558
+
559
+ ##### `full-example-json status configure install`
560
+
561
+ Install agent artifacts and bootstrap app config.
562
+
563
+ ##### `full-example-json status configure uninstall`
564
+
565
+ Remove agent artifacts and app config.
526
566
 
527
567
  #### Options
528
568
 
529
569
  | Option | Type | Required | Format / default | Description |
530
570
  | --- | --- | --- | --- | --- |
531
- | `--refresh` | flag | optional | — | Refresh installed skills and MCP. Used by Homebrew post_install. |
532
- | `--remove-all` | flag | optional | — | Remove all detected agent artifacts (skills and MCP). |
533
- | `--status` | flag | optional | — | Print what is currently installed (read-only). |
534
- | `--yes` (`-y`) | flag | optional | — | Skip confirmation (required for --refresh, --remove-all, --remove-config). |
535
- | `--dry` | flag | optional | — | Show what would change without writing files. |
536
- | `--json` | flag | optional | — | Print changed paths or status JSON on stdout. |
571
+ | `--yes` (`-y`) | flag | optional | — | Skip uninstall confirmation. |
572
+
573
+ ##### `full-example-json status configure status`
574
+
575
+ Print what is currently installed (read-only).
576
+
577
+ #### Options
578
+
579
+ | Option | Type | Required | Format / default | Description |
580
+ | --- | --- | --- | --- | --- |
581
+ | `--json` | flag | optional | — | Print status JSON on stdout. |
537
582
 
538
583
  #### `full-example-json status docs`
539
584
 
@@ -555,7 +600,7 @@ Print bundled CLI documentation.
555
600
  - `openapi` — Print the HTTP OpenAPI 3.1 document as JSON.
556
601
  - `cli-schema` — Print the full CLI command tree as JSON.
557
602
  - `cli` — Print the full command reference as markdown.
558
- - `skill` — Print a reference agent SKILL; run `configure` to install an optimized copy.
603
+ - `skill` — Print a reference agent SKILL; run `configure install` to install an optimized copy.
559
604
 
560
605
  ##### `full-example-json status docs readme`
561
606
 
@@ -619,7 +664,7 @@ Print the full command reference as markdown.
619
664
 
620
665
  ##### `full-example-json status docs skill`
621
666
 
622
- Print a reference agent SKILL; run `configure` to install an optimized copy.
667
+ Print a reference agent SKILL; run `configure install` to install an optimized copy.
623
668
 
624
669
  #### Options
625
670
 
@@ -722,41 +767,56 @@ Set up agent skills and MCP config for this app (binary via Homebrew).
722
767
 
723
768
  > Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).
724
769
  >
725
- > Homebrew post_install runs:
726
- > full-example-json configure --refresh --yes
770
+ > Homebrew installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.
727
771
  >
728
- > Interactive setup (per target):
729
- > full-example-json configure
772
+ > After install or upgrade:
773
+ > full-example-json configure install
730
774
  >
731
775
  > Upgrade:
732
776
  > brew upgrade full-example-json
777
+ > full-example-json configure install
733
778
  >
734
779
  > Shell completions are installed by Homebrew during brew install.
735
780
  > See: https://docs.brew.sh/Shell-Completion
736
781
  >
737
782
  > See what is installed:
738
- > full-example-json configure --status
783
+ > full-example-json configure status
739
784
  >
740
785
  > Uninstall:
786
+ > full-example-json configure uninstall
741
787
  > brew uninstall <tap>/full-example-json
742
788
  >
743
- > The formula uninstall hook runs `configure --remove-all --yes` (skills, MCP, and app config).
744
- >
745
- > Use --dry to preview changes without writing files.
746
- > Use --json for machine-readable output.
789
+ > Use `configure status --json` for machine-readable output.
790
+
791
+ #### Subcommands
792
+
793
+ - `install` — Install agent artifacts and bootstrap app config.
794
+ - `uninstall` — Remove agent artifacts and app config.
795
+ - `status` — Print what is currently installed (read-only).
796
+
797
+ ###### `full-example-json workspaces get configure install`
747
798
 
748
- **Default subcommand:** `run` (`missingOnly`)
799
+ Install agent artifacts and bootstrap app config.
800
+
801
+ ###### `full-example-json workspaces get configure uninstall`
802
+
803
+ Remove agent artifacts and app config.
804
+
805
+ #### Options
806
+
807
+ | Option | Type | Required | Format / default | Description |
808
+ | --- | --- | --- | --- | --- |
809
+ | `--yes` (`-y`) | flag | optional | — | Skip uninstall confirmation. |
810
+
811
+ ###### `full-example-json workspaces get configure status`
812
+
813
+ Print what is currently installed (read-only).
749
814
 
750
815
  #### Options
751
816
 
752
817
  | Option | Type | Required | Format / default | Description |
753
818
  | --- | --- | --- | --- | --- |
754
- | `--refresh` | flag | optional | — | Refresh installed skills and MCP. Used by Homebrew post_install. |
755
- | `--remove-all` | flag | optional | — | Remove all detected agent artifacts (skills and MCP). |
756
- | `--status` | flag | optional | — | Print what is currently installed (read-only). |
757
- | `--yes` (`-y`) | flag | optional | — | Skip confirmation (required for --refresh, --remove-all, --remove-config). |
758
- | `--dry` | flag | optional | — | Show what would change without writing files. |
759
- | `--json` | flag | optional | — | Print changed paths or status JSON on stdout. |
819
+ | `--json` | flag | optional | — | Print status JSON on stdout. |
760
820
 
761
821
  ##### `full-example-json workspaces get docs`
762
822
 
@@ -778,7 +838,7 @@ Print bundled CLI documentation.
778
838
  - `openapi` — Print the HTTP OpenAPI 3.1 document as JSON.
779
839
  - `cli-schema` — Print the full CLI command tree as JSON.
780
840
  - `cli` — Print the full command reference as markdown.
781
- - `skill` — Print a reference agent SKILL; run `configure` to install an optimized copy.
841
+ - `skill` — Print a reference agent SKILL; run `configure install` to install an optimized copy.
782
842
 
783
843
  ###### `full-example-json workspaces get docs readme`
784
844
 
@@ -842,7 +902,7 @@ Print the full command reference as markdown.
842
902
 
843
903
  ###### `full-example-json workspaces get docs skill`
844
904
 
845
- Print a reference agent SKILL; run `configure` to install an optimized copy.
905
+ Print a reference agent SKILL; run `configure install` to install an optimized copy.
846
906
 
847
907
  #### Options
848
908
 
@@ -935,41 +995,56 @@ Set up agent skills and MCP config for this app (binary via Homebrew).
935
995
 
936
996
  > Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).
937
997
  >
938
- > Homebrew post_install runs:
939
- > full-example-json configure --refresh --yes
998
+ > Homebrew installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.
940
999
  >
941
- > Interactive setup (per target):
942
- > full-example-json configure
1000
+ > After install or upgrade:
1001
+ > full-example-json configure install
943
1002
  >
944
1003
  > Upgrade:
945
1004
  > brew upgrade full-example-json
1005
+ > full-example-json configure install
946
1006
  >
947
1007
  > Shell completions are installed by Homebrew during brew install.
948
1008
  > See: https://docs.brew.sh/Shell-Completion
949
1009
  >
950
1010
  > See what is installed:
951
- > full-example-json configure --status
1011
+ > full-example-json configure status
952
1012
  >
953
1013
  > Uninstall:
1014
+ > full-example-json configure uninstall
954
1015
  > brew uninstall <tap>/full-example-json
955
1016
  >
956
- > The formula uninstall hook runs `configure --remove-all --yes` (skills, MCP, and app config).
957
- >
958
- > Use --dry to preview changes without writing files.
959
- > Use --json for machine-readable output.
1017
+ > Use `configure status --json` for machine-readable output.
1018
+
1019
+ #### Subcommands
1020
+
1021
+ - `install` — Install agent artifacts and bootstrap app config.
1022
+ - `uninstall` — Remove agent artifacts and app config.
1023
+ - `status` — Print what is currently installed (read-only).
1024
+
1025
+ ###### `full-example-json workspaces post configure install`
1026
+
1027
+ Install agent artifacts and bootstrap app config.
1028
+
1029
+ ###### `full-example-json workspaces post configure uninstall`
960
1030
 
961
- **Default subcommand:** `run` (`missingOnly`)
1031
+ Remove agent artifacts and app config.
962
1032
 
963
1033
  #### Options
964
1034
 
965
1035
  | Option | Type | Required | Format / default | Description |
966
1036
  | --- | --- | --- | --- | --- |
967
- | `--refresh` | flag | optional | — | Refresh installed skills and MCP. Used by Homebrew post_install. |
968
- | `--remove-all` | flag | optional | — | Remove all detected agent artifacts (skills and MCP). |
969
- | `--status` | flag | optional | — | Print what is currently installed (read-only). |
970
- | `--yes` (`-y`) | flag | optional | — | Skip confirmation (required for --refresh, --remove-all, --remove-config). |
971
- | `--dry` | flag | optional | — | Show what would change without writing files. |
972
- | `--json` | flag | optional | — | Print changed paths or status JSON on stdout. |
1037
+ | `--yes` (`-y`) | flag | optional | — | Skip uninstall confirmation. |
1038
+
1039
+ ###### `full-example-json workspaces post configure status`
1040
+
1041
+ Print what is currently installed (read-only).
1042
+
1043
+ #### Options
1044
+
1045
+ | Option | Type | Required | Format / default | Description |
1046
+ | --- | --- | --- | --- | --- |
1047
+ | `--json` | flag | optional | — | Print status JSON on stdout. |
973
1048
 
974
1049
  ##### `full-example-json workspaces post docs`
975
1050
 
@@ -991,7 +1066,7 @@ Print bundled CLI documentation.
991
1066
  - `openapi` — Print the HTTP OpenAPI 3.1 document as JSON.
992
1067
  - `cli-schema` — Print the full CLI command tree as JSON.
993
1068
  - `cli` — Print the full command reference as markdown.
994
- - `skill` — Print a reference agent SKILL; run `configure` to install an optimized copy.
1069
+ - `skill` — Print a reference agent SKILL; run `configure install` to install an optimized copy.
995
1070
 
996
1071
  ###### `full-example-json workspaces post docs readme`
997
1072
 
@@ -1055,7 +1130,7 @@ Print the full command reference as markdown.
1055
1130
 
1056
1131
  ###### `full-example-json workspaces post docs skill`
1057
1132
 
1058
- Print a reference agent SKILL; run `configure` to install an optimized copy.
1133
+ Print a reference agent SKILL; run `configure install` to install an optimized copy.
1059
1134
 
1060
1135
  #### Options
1061
1136
 
@@ -1159,41 +1234,56 @@ Set up agent skills and MCP config for this app (binary via Homebrew).
1159
1234
 
1160
1235
  > Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).
1161
1236
  >
1162
- > Homebrew post_install runs:
1163
- > full-example-json configure --refresh --yes
1237
+ > Homebrew installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.
1164
1238
  >
1165
- > Interactive setup (per target):
1166
- > full-example-json configure
1239
+ > After install or upgrade:
1240
+ > full-example-json configure install
1167
1241
  >
1168
1242
  > Upgrade:
1169
1243
  > brew upgrade full-example-json
1244
+ > full-example-json configure install
1170
1245
  >
1171
1246
  > Shell completions are installed by Homebrew during brew install.
1172
1247
  > See: https://docs.brew.sh/Shell-Completion
1173
1248
  >
1174
1249
  > See what is installed:
1175
- > full-example-json configure --status
1250
+ > full-example-json configure status
1176
1251
  >
1177
1252
  > Uninstall:
1253
+ > full-example-json configure uninstall
1178
1254
  > brew uninstall <tap>/full-example-json
1179
1255
  >
1180
- > The formula uninstall hook runs `configure --remove-all --yes` (skills, MCP, and app config).
1181
- >
1182
- > Use --dry to preview changes without writing files.
1183
- > Use --json for machine-readable output.
1256
+ > Use `configure status --json` for machine-readable output.
1257
+
1258
+ #### Subcommands
1259
+
1260
+ - `install` — Install agent artifacts and bootstrap app config.
1261
+ - `uninstall` — Remove agent artifacts and app config.
1262
+ - `status` — Print what is currently installed (read-only).
1263
+
1264
+ ###### `full-example-json workspaces :id get configure install`
1265
+
1266
+ Install agent artifacts and bootstrap app config.
1267
+
1268
+ ###### `full-example-json workspaces :id get configure uninstall`
1269
+
1270
+ Remove agent artifacts and app config.
1271
+
1272
+ #### Options
1273
+
1274
+ | Option | Type | Required | Format / default | Description |
1275
+ | --- | --- | --- | --- | --- |
1276
+ | `--yes` (`-y`) | flag | optional | — | Skip uninstall confirmation. |
1277
+
1278
+ ###### `full-example-json workspaces :id get configure status`
1184
1279
 
1185
- **Default subcommand:** `run` (`missingOnly`)
1280
+ Print what is currently installed (read-only).
1186
1281
 
1187
1282
  #### Options
1188
1283
 
1189
1284
  | Option | Type | Required | Format / default | Description |
1190
1285
  | --- | --- | --- | --- | --- |
1191
- | `--refresh` | flag | optional | — | Refresh installed skills and MCP. Used by Homebrew post_install. |
1192
- | `--remove-all` | flag | optional | — | Remove all detected agent artifacts (skills and MCP). |
1193
- | `--status` | flag | optional | — | Print what is currently installed (read-only). |
1194
- | `--yes` (`-y`) | flag | optional | — | Skip confirmation (required for --refresh, --remove-all, --remove-config). |
1195
- | `--dry` | flag | optional | — | Show what would change without writing files. |
1196
- | `--json` | flag | optional | — | Print changed paths or status JSON on stdout. |
1286
+ | `--json` | flag | optional | — | Print status JSON on stdout. |
1197
1287
 
1198
1288
  ###### `full-example-json workspaces :id get docs`
1199
1289
 
@@ -1215,7 +1305,7 @@ Print bundled CLI documentation.
1215
1305
  - `openapi` — Print the HTTP OpenAPI 3.1 document as JSON.
1216
1306
  - `cli-schema` — Print the full CLI command tree as JSON.
1217
1307
  - `cli` — Print the full command reference as markdown.
1218
- - `skill` — Print a reference agent SKILL; run `configure` to install an optimized copy.
1308
+ - `skill` — Print a reference agent SKILL; run `configure install` to install an optimized copy.
1219
1309
 
1220
1310
  ###### `full-example-json workspaces :id get docs readme`
1221
1311
 
@@ -1279,7 +1369,7 @@ Print the full command reference as markdown.
1279
1369
 
1280
1370
  ###### `full-example-json workspaces :id get docs skill`
1281
1371
 
1282
- Print a reference agent SKILL; run `configure` to install an optimized copy.
1372
+ Print a reference agent SKILL; run `configure install` to install an optimized copy.
1283
1373
 
1284
1374
  #### Options
1285
1375
 
@@ -1372,41 +1462,56 @@ Set up agent skills and MCP config for this app (binary via Homebrew).
1372
1462
 
1373
1463
  > Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).
1374
1464
  >
1375
- > Homebrew post_install runs:
1376
- > full-example-json configure --refresh --yes
1465
+ > Homebrew installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.
1377
1466
  >
1378
- > Interactive setup (per target):
1379
- > full-example-json configure
1467
+ > After install or upgrade:
1468
+ > full-example-json configure install
1380
1469
  >
1381
1470
  > Upgrade:
1382
1471
  > brew upgrade full-example-json
1472
+ > full-example-json configure install
1383
1473
  >
1384
1474
  > Shell completions are installed by Homebrew during brew install.
1385
1475
  > See: https://docs.brew.sh/Shell-Completion
1386
1476
  >
1387
1477
  > See what is installed:
1388
- > full-example-json configure --status
1478
+ > full-example-json configure status
1389
1479
  >
1390
1480
  > Uninstall:
1481
+ > full-example-json configure uninstall
1391
1482
  > brew uninstall <tap>/full-example-json
1392
1483
  >
1393
- > The formula uninstall hook runs `configure --remove-all --yes` (skills, MCP, and app config).
1394
- >
1395
- > Use --dry to preview changes without writing files.
1396
- > Use --json for machine-readable output.
1484
+ > Use `configure status --json` for machine-readable output.
1485
+
1486
+ #### Subcommands
1397
1487
 
1398
- **Default subcommand:** `run` (`missingOnly`)
1488
+ - `install` — Install agent artifacts and bootstrap app config.
1489
+ - `uninstall` — Remove agent artifacts and app config.
1490
+ - `status` — Print what is currently installed (read-only).
1491
+
1492
+ ###### `full-example-json workspaces :id put configure install`
1493
+
1494
+ Install agent artifacts and bootstrap app config.
1495
+
1496
+ ###### `full-example-json workspaces :id put configure uninstall`
1497
+
1498
+ Remove agent artifacts and app config.
1399
1499
 
1400
1500
  #### Options
1401
1501
 
1402
1502
  | Option | Type | Required | Format / default | Description |
1403
1503
  | --- | --- | --- | --- | --- |
1404
- | `--refresh` | flag | optional | — | Refresh installed skills and MCP. Used by Homebrew post_install. |
1405
- | `--remove-all` | flag | optional | — | Remove all detected agent artifacts (skills and MCP). |
1406
- | `--status` | flag | optional | — | Print what is currently installed (read-only). |
1407
- | `--yes` (`-y`) | flag | optional | — | Skip confirmation (required for --refresh, --remove-all, --remove-config). |
1408
- | `--dry` | flag | optional | — | Show what would change without writing files. |
1409
- | `--json` | flag | optional | — | Print changed paths or status JSON on stdout. |
1504
+ | `--yes` (`-y`) | flag | optional | — | Skip uninstall confirmation. |
1505
+
1506
+ ###### `full-example-json workspaces :id put configure status`
1507
+
1508
+ Print what is currently installed (read-only).
1509
+
1510
+ #### Options
1511
+
1512
+ | Option | Type | Required | Format / default | Description |
1513
+ | --- | --- | --- | --- | --- |
1514
+ | `--json` | flag | optional | — | Print status JSON on stdout. |
1410
1515
 
1411
1516
  ###### `full-example-json workspaces :id put docs`
1412
1517
 
@@ -1428,7 +1533,7 @@ Print bundled CLI documentation.
1428
1533
  - `openapi` — Print the HTTP OpenAPI 3.1 document as JSON.
1429
1534
  - `cli-schema` — Print the full CLI command tree as JSON.
1430
1535
  - `cli` — Print the full command reference as markdown.
1431
- - `skill` — Print a reference agent SKILL; run `configure` to install an optimized copy.
1536
+ - `skill` — Print a reference agent SKILL; run `configure install` to install an optimized copy.
1432
1537
 
1433
1538
  ###### `full-example-json workspaces :id put docs readme`
1434
1539
 
@@ -1492,7 +1597,7 @@ Print the full command reference as markdown.
1492
1597
 
1493
1598
  ###### `full-example-json workspaces :id put docs skill`
1494
1599
 
1495
- Print a reference agent SKILL; run `configure` to install an optimized copy.
1600
+ Print a reference agent SKILL; run `configure install` to install an optimized copy.
1496
1601
 
1497
1602
  #### Options
1498
1603
 
@@ -1585,41 +1690,56 @@ Set up agent skills and MCP config for this app (binary via Homebrew).
1585
1690
 
1586
1691
  > Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).
1587
1692
  >
1588
- > Homebrew post_install runs:
1589
- > full-example-json configure --refresh --yes
1693
+ > Homebrew installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.
1590
1694
  >
1591
- > Interactive setup (per target):
1592
- > full-example-json configure
1695
+ > After install or upgrade:
1696
+ > full-example-json configure install
1593
1697
  >
1594
1698
  > Upgrade:
1595
1699
  > brew upgrade full-example-json
1700
+ > full-example-json configure install
1596
1701
  >
1597
1702
  > Shell completions are installed by Homebrew during brew install.
1598
1703
  > See: https://docs.brew.sh/Shell-Completion
1599
1704
  >
1600
1705
  > See what is installed:
1601
- > full-example-json configure --status
1706
+ > full-example-json configure status
1602
1707
  >
1603
1708
  > Uninstall:
1709
+ > full-example-json configure uninstall
1604
1710
  > brew uninstall <tap>/full-example-json
1605
1711
  >
1606
- > The formula uninstall hook runs `configure --remove-all --yes` (skills, MCP, and app config).
1607
- >
1608
- > Use --dry to preview changes without writing files.
1609
- > Use --json for machine-readable output.
1712
+ > Use `configure status --json` for machine-readable output.
1713
+
1714
+ #### Subcommands
1715
+
1716
+ - `install` — Install agent artifacts and bootstrap app config.
1717
+ - `uninstall` — Remove agent artifacts and app config.
1718
+ - `status` — Print what is currently installed (read-only).
1719
+
1720
+ ###### `full-example-json workspaces :id patch configure install`
1610
1721
 
1611
- **Default subcommand:** `run` (`missingOnly`)
1722
+ Install agent artifacts and bootstrap app config.
1723
+
1724
+ ###### `full-example-json workspaces :id patch configure uninstall`
1725
+
1726
+ Remove agent artifacts and app config.
1612
1727
 
1613
1728
  #### Options
1614
1729
 
1615
1730
  | Option | Type | Required | Format / default | Description |
1616
1731
  | --- | --- | --- | --- | --- |
1617
- | `--refresh` | flag | optional | — | Refresh installed skills and MCP. Used by Homebrew post_install. |
1618
- | `--remove-all` | flag | optional | — | Remove all detected agent artifacts (skills and MCP). |
1619
- | `--status` | flag | optional | — | Print what is currently installed (read-only). |
1620
- | `--yes` (`-y`) | flag | optional | — | Skip confirmation (required for --refresh, --remove-all, --remove-config). |
1621
- | `--dry` | flag | optional | — | Show what would change without writing files. |
1622
- | `--json` | flag | optional | — | Print changed paths or status JSON on stdout. |
1732
+ | `--yes` (`-y`) | flag | optional | — | Skip uninstall confirmation. |
1733
+
1734
+ ###### `full-example-json workspaces :id patch configure status`
1735
+
1736
+ Print what is currently installed (read-only).
1737
+
1738
+ #### Options
1739
+
1740
+ | Option | Type | Required | Format / default | Description |
1741
+ | --- | --- | --- | --- | --- |
1742
+ | `--json` | flag | optional | — | Print status JSON on stdout. |
1623
1743
 
1624
1744
  ###### `full-example-json workspaces :id patch docs`
1625
1745
 
@@ -1641,7 +1761,7 @@ Print bundled CLI documentation.
1641
1761
  - `openapi` — Print the HTTP OpenAPI 3.1 document as JSON.
1642
1762
  - `cli-schema` — Print the full CLI command tree as JSON.
1643
1763
  - `cli` — Print the full command reference as markdown.
1644
- - `skill` — Print a reference agent SKILL; run `configure` to install an optimized copy.
1764
+ - `skill` — Print a reference agent SKILL; run `configure install` to install an optimized copy.
1645
1765
 
1646
1766
  ###### `full-example-json workspaces :id patch docs readme`
1647
1767
 
@@ -1705,7 +1825,7 @@ Print the full command reference as markdown.
1705
1825
 
1706
1826
  ###### `full-example-json workspaces :id patch docs skill`
1707
1827
 
1708
- Print a reference agent SKILL; run `configure` to install an optimized copy.
1828
+ Print a reference agent SKILL; run `configure install` to install an optimized copy.
1709
1829
 
1710
1830
  #### Options
1711
1831
 
@@ -1798,41 +1918,56 @@ Set up agent skills and MCP config for this app (binary via Homebrew).
1798
1918
 
1799
1919
  > Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).
1800
1920
  >
1801
- > Homebrew post_install runs:
1802
- > full-example-json configure --refresh --yes
1921
+ > Homebrew installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.
1803
1922
  >
1804
- > Interactive setup (per target):
1805
- > full-example-json configure
1923
+ > After install or upgrade:
1924
+ > full-example-json configure install
1806
1925
  >
1807
1926
  > Upgrade:
1808
1927
  > brew upgrade full-example-json
1928
+ > full-example-json configure install
1809
1929
  >
1810
1930
  > Shell completions are installed by Homebrew during brew install.
1811
1931
  > See: https://docs.brew.sh/Shell-Completion
1812
1932
  >
1813
1933
  > See what is installed:
1814
- > full-example-json configure --status
1934
+ > full-example-json configure status
1815
1935
  >
1816
1936
  > Uninstall:
1937
+ > full-example-json configure uninstall
1817
1938
  > brew uninstall <tap>/full-example-json
1818
1939
  >
1819
- > The formula uninstall hook runs `configure --remove-all --yes` (skills, MCP, and app config).
1820
- >
1821
- > Use --dry to preview changes without writing files.
1822
- > Use --json for machine-readable output.
1940
+ > Use `configure status --json` for machine-readable output.
1941
+
1942
+ #### Subcommands
1943
+
1944
+ - `install` — Install agent artifacts and bootstrap app config.
1945
+ - `uninstall` — Remove agent artifacts and app config.
1946
+ - `status` — Print what is currently installed (read-only).
1947
+
1948
+ ###### `full-example-json workspaces :id delete configure install`
1949
+
1950
+ Install agent artifacts and bootstrap app config.
1951
+
1952
+ ###### `full-example-json workspaces :id delete configure uninstall`
1953
+
1954
+ Remove agent artifacts and app config.
1955
+
1956
+ #### Options
1957
+
1958
+ | Option | Type | Required | Format / default | Description |
1959
+ | --- | --- | --- | --- | --- |
1960
+ | `--yes` (`-y`) | flag | optional | — | Skip uninstall confirmation. |
1961
+
1962
+ ###### `full-example-json workspaces :id delete configure status`
1823
1963
 
1824
- **Default subcommand:** `run` (`missingOnly`)
1964
+ Print what is currently installed (read-only).
1825
1965
 
1826
1966
  #### Options
1827
1967
 
1828
1968
  | Option | Type | Required | Format / default | Description |
1829
1969
  | --- | --- | --- | --- | --- |
1830
- | `--refresh` | flag | optional | — | Refresh installed skills and MCP. Used by Homebrew post_install. |
1831
- | `--remove-all` | flag | optional | — | Remove all detected agent artifacts (skills and MCP). |
1832
- | `--status` | flag | optional | — | Print what is currently installed (read-only). |
1833
- | `--yes` (`-y`) | flag | optional | — | Skip confirmation (required for --refresh, --remove-all, --remove-config). |
1834
- | `--dry` | flag | optional | — | Show what would change without writing files. |
1835
- | `--json` | flag | optional | — | Print changed paths or status JSON on stdout. |
1970
+ | `--json` | flag | optional | — | Print status JSON on stdout. |
1836
1971
 
1837
1972
  ###### `full-example-json workspaces :id delete docs`
1838
1973
 
@@ -1854,7 +1989,7 @@ Print bundled CLI documentation.
1854
1989
  - `openapi` — Print the HTTP OpenAPI 3.1 document as JSON.
1855
1990
  - `cli-schema` — Print the full CLI command tree as JSON.
1856
1991
  - `cli` — Print the full command reference as markdown.
1857
- - `skill` — Print a reference agent SKILL; run `configure` to install an optimized copy.
1992
+ - `skill` — Print a reference agent SKILL; run `configure install` to install an optimized copy.
1858
1993
 
1859
1994
  ###### `full-example-json workspaces :id delete docs readme`
1860
1995
 
@@ -1918,7 +2053,7 @@ Print the full command reference as markdown.
1918
2053
 
1919
2054
  ###### `full-example-json workspaces :id delete docs skill`
1920
2055
 
1921
- Print a reference agent SKILL; run `configure` to install an optimized copy.
2056
+ Print a reference agent SKILL; run `configure install` to install an optimized copy.
1922
2057
 
1923
2058
  #### Options
1924
2059