oclif 2.0.0 → 2.0.1

package/.oclif.manifest.json

@@ -1 +1 @@
-{"version":"2.0.0","commands":{"base":{"id":"base","pluginName":"oclif","pluginType":"core","hidden":true,"aliases":[],"flags":{"defaults":{"name":"defaults","type":"boolean","description":"use defaults for every setting","allowNo":false},"options":{"name":"options","type":"option","description":"(yarn|typescript|eslint|mocha)"},"force":{"name":"force","type":"boolean","description":"overwrite existing files","allowNo":false}},"args":[{"name":"path","description":"path to project, defaults to current directory","required":false}]},"command":{"id":"command","description":"add a command to an existing CLI or plugin","pluginName":"oclif","pluginType":"core","aliases":[],"flags":{"defaults":{"name":"defaults","type":"boolean","description":"use defaults for every setting","allowNo":false},"force":{"name":"force","type":"boolean","description":"overwrite existing files","allowNo":false}},"args":[{"name":"name","description":"name of command","required":true}]},"hook":{"id":"hook","description":"add a hook to an existing CLI or plugin","pluginName":"oclif","pluginType":"core","aliases":[],"flags":{"defaults":{"name":"defaults","type":"boolean","description":"use defaults for every setting","allowNo":false},"force":{"name":"force","type":"boolean","description":"overwrite existing files","allowNo":false},"event":{"name":"event","type":"option","description":"event to run hook on","default":"init"}},"args":[{"name":"name","description":"name of hook (snake_case)","required":true}]},"manifest":{"id":"manifest","description":"generates plugin manifest json","pluginName":"oclif","pluginType":"core","hidden":true,"aliases":[],"flags":{},"args":[{"name":"path","description":"path to plugin","default":"."}]},"multi":{"id":"multi","description":"generate a new multi-command CLI","pluginName":"oclif","pluginType":"core","aliases":[],"flags":{"defaults":{"name":"defaults","type":"boolean","description":"use defaults for every setting","allowNo":false},"options":{"name":"options","type":"option","description":"(yarn|typescript|eslint|mocha)"},"force":{"name":"force","type":"boolean","description":"overwrite existing files","allowNo":false}},"args":[{"name":"path","description":"path to project, defaults to current directory","required":false}]},"plugin":{"id":"plugin","description":"create a new CLI plugin","pluginName":"oclif","pluginType":"core","aliases":[],"flags":{"defaults":{"name":"defaults","type":"boolean","description":"use defaults for every setting","allowNo":false},"options":{"name":"options","type":"option","description":"(yarn|typescript|eslint|mocha)"},"force":{"name":"force","type":"boolean","description":"overwrite existing files","allowNo":false}},"args":[{"name":"path","description":"path to project, defaults to current directory","required":false}]},"promote":{"id":"promote","description":"promote CLI builds to a S3 release channel","pluginName":"oclif","pluginType":"core","hidden":true,"aliases":[],"flags":{"root":{"name":"root","type":"option","char":"r","description":"path to the oclif CLI project root","required":true,"default":"."},"version":{"name":"version","type":"option","description":"semantic version of the CLI to promote","required":true},"sha":{"name":"sha","type":"option","description":"7-digit short git commit SHA of the CLI to promote","required":true},"channel":{"name":"channel","type":"option","description":"which channel to promote to","required":true,"default":"stable"},"targets":{"name":"targets","type":"option","char":"t","description":"comma-separated targets to promote (e.g.: linux-arm,win32-x64)","default":"linux-x64,linux-arm,win32-x64,win32-x86,darwin-x64"},"deb":{"name":"deb","type":"boolean","char":"d","description":"promote debian artifacts","allowNo":false},"macos":{"name":"macos","type":"boolean","char":"m","description":"promote macOS pkg","allowNo":false},"win":{"name":"win","type":"boolean","char":"w","description":"promote Windows exe","allowNo":false},"max-age":{"name":"max-age","type":"option","char":"a","description":"cache control max-age in seconds","default":"86400"},"xz":{"name":"xz","type":"boolean","description":"also upload xz","allowNo":true},"indexes":{"name":"indexes","type":"boolean","description":"append the promoted urls into the index files","allowNo":false}},"args":[]},"readme":{"id":"readme","description":"adds commands to README.md in current directory\nThe readme must have any of the following tags inside of it for it to be replaced or else it will do nothing:\n# Usage\n<!-- usage -->\n# Commands\n<!-- commands -->\n\nCustomize the code URL prefix by setting oclif.repositoryPrefix in package.json.\n","pluginName":"oclif","pluginType":"core","hidden":true,"aliases":[],"flags":{"dir":{"name":"dir","type":"option","description":"output directory for multi docs","required":true,"default":"docs"},"multi":{"name":"multi","type":"boolean","description":"create a different markdown page for each topic","allowNo":false}},"args":[]},"single":{"id":"single","description":"generate a new single-command CLI","pluginName":"oclif","pluginType":"core","aliases":[],"flags":{"defaults":{"name":"defaults","type":"boolean","description":"use defaults for every setting","allowNo":false},"options":{"name":"options","type":"option","description":"(yarn|typescript|eslint|mocha)"},"force":{"name":"force","type":"boolean","description":"overwrite existing files","allowNo":false}},"args":[{"name":"path","description":"path to project, defaults to current directory","required":false}]},"pack:deb":{"id":"pack:deb","description":"pack CLI into debian package","pluginName":"oclif","pluginType":"core","hidden":true,"aliases":[],"flags":{"root":{"name":"root","type":"option","char":"r","description":"path to oclif CLI root","required":true,"default":"."}},"args":[]},"pack:macos":{"id":"pack:macos","description":"pack CLI into macOS .pkg","pluginName":"oclif","pluginType":"core","hidden":true,"aliases":[],"flags":{"root":{"name":"root","type":"option","char":"r","description":"path to oclif CLI root","required":true,"default":"."}},"args":[]},"pack:tarballs":{"id":"pack:tarballs","description":"packages oclif CLI into tarballs\n\nThis can be used to create oclif CLIs that use the system node or that come preloaded with a node binary.\n","pluginName":"oclif","pluginType":"core","hidden":true,"aliases":[],"flags":{"root":{"name":"root","type":"option","char":"r","description":"path to oclif CLI root","required":true,"default":"."},"targets":{"name":"targets","type":"option","char":"t","description":"comma-separated targets to pack (e.g.: linux-arm,win32-x64)","default":"linux-x64,linux-arm,win32-x64,win32-x86,darwin-x64"},"xz":{"name":"xz","type":"boolean","description":"also build xz","allowNo":true}},"args":[]},"pack:win":{"id":"pack:win","description":"create windows installer from oclif CLI","pluginName":"oclif","pluginType":"core","hidden":true,"aliases":[],"flags":{"root":{"name":"root","type":"option","char":"r","description":"path to oclif CLI root","required":true,"default":"."}},"args":[]},"upload:deb":{"id":"upload:deb","description":"upload deb package built with pack:deb","pluginName":"oclif","pluginType":"core","hidden":true,"aliases":[],"flags":{"root":{"name":"root","type":"option","char":"r","description":"path to oclif CLI root","required":true,"default":"."}},"args":[]},"upload:macos":{"id":"upload:macos","description":"upload macos installers built with pack:macos","pluginName":"oclif","pluginType":"core","hidden":true,"aliases":[],"flags":{"root":{"name":"root","type":"option","char":"r","description":"path to oclif CLI root","required":true,"default":"."}},"args":[]},"upload:tarballs":{"id":"upload:tarballs","description":"upload an oclif CLI to S3\n\n\"aws-sdk\" will need to be installed as a devDependency to upload.\n","pluginName":"oclif","pluginType":"core","hidden":true,"aliases":[],"flags":{"root":{"name":"root","type":"option","char":"r","description":"path to oclif CLI root","required":true,"default":"."},"targets":{"name":"targets","type":"option","char":"t","description":"comma-separated targets to upload (e.g.: linux-arm,win32-x64)","default":"linux-x64,linux-arm,win32-x64,win32-x86,darwin-x64"},"xz":{"name":"xz","type":"boolean","description":"also upload xz","allowNo":true}},"args":[]},"upload:win":{"id":"upload:win","description":"upload windows installers built with pack:win","pluginName":"oclif","pluginType":"core","hidden":true,"aliases":[],"flags":{"root":{"name":"root","type":"option","char":"r","description":"path to oclif CLI root","required":true,"default":"."}},"args":[]}}}
+{"version":"2.0.1","commands":{"generate":{"id":"generate","description":"generate a new CLI\nThis will clone the template repo 'oclif/hello-world' and update package properties","strict":true,"pluginName":"oclif","pluginAlias":"oclif","pluginType":"core","aliases":[],"flags":{},"args":[{"name":"name","description":"directory name of new project","required":true}]},"manifest":{"id":"manifest","description":"generates plugin manifest json","strict":true,"pluginName":"oclif","pluginAlias":"oclif","pluginType":"core","aliases":[],"flags":{},"args":[{"name":"path","description":"path to plugin","default":"."}]},"promote":{"id":"promote","description":"promote CLI builds to a S3 release channel","strict":true,"pluginName":"oclif","pluginAlias":"oclif","pluginType":"core","aliases":[],"flags":{"root":{"name":"root","type":"option","char":"r","description":"path to the oclif CLI project root","required":true,"multiple":false,"default":"."},"version":{"name":"version","type":"option","description":"semantic version of the CLI to promote","required":true,"multiple":false},"sha":{"name":"sha","type":"option","description":"7-digit short git commit SHA of the CLI to promote","required":true,"multiple":false},"channel":{"name":"channel","type":"option","description":"which channel to promote to","required":true,"multiple":false,"default":"stable"},"targets":{"name":"targets","type":"option","char":"t","description":"comma-separated targets to promote (e.g.: linux-arm,win32-x64)","multiple":false,"default":"linux-x64,linux-arm,win32-x64,win32-x86,darwin-x64,darwin-arm64"},"deb":{"name":"deb","type":"boolean","char":"d","description":"promote debian artifacts","allowNo":false},"macos":{"name":"macos","type":"boolean","char":"m","description":"promote macOS pkg","allowNo":false},"win":{"name":"win","type":"boolean","char":"w","description":"promote Windows exe","allowNo":false},"max-age":{"name":"max-age","type":"option","char":"a","description":"cache control max-age in seconds","multiple":false,"default":"86400"},"xz":{"name":"xz","type":"boolean","description":"also upload xz","allowNo":true},"indexes":{"name":"indexes","type":"boolean","description":"append the promoted urls into the index files","allowNo":false}},"args":[]},"readme":{"id":"readme","description":"adds commands to README.md in current directory\nThe readme must have any of the following tags inside of it for it to be replaced or else it will do nothing:\n# Usage\n<!-- usage -->\n# Commands\n<!-- commands -->\n\nCustomize the code URL prefix by setting oclif.repositoryPrefix in package.json.\n","strict":true,"pluginName":"oclif","pluginAlias":"oclif","pluginType":"core","aliases":[],"flags":{"dir":{"name":"dir","type":"option","description":"output directory for multi docs","required":true,"multiple":false,"default":"docs"},"multi":{"name":"multi","type":"boolean","description":"create a different markdown page for each topic","allowNo":false}},"args":[]},"pack:deb":{"id":"pack:deb","description":"pack CLI into debian package","strict":true,"pluginName":"oclif","pluginAlias":"oclif","pluginType":"core","aliases":[],"flags":{"root":{"name":"root","type":"option","char":"r","description":"path to oclif CLI root","required":true,"multiple":false,"default":"."}},"args":[]},"pack:macos":{"id":"pack:macos","description":"pack CLI into macOS .pkg","strict":true,"pluginName":"oclif","pluginAlias":"oclif","pluginType":"core","aliases":[],"flags":{"root":{"name":"root","type":"option","char":"r","description":"path to oclif CLI root","required":true,"multiple":false,"default":"."},"additional-cli":{"name":"additional-cli","type":"option","description":"an Oclif CLI other than the one listed in config.bin that should be made available to the user\nthe CLI should already exist in a directory named after the CLI that is the root of the tarball produced by \"oclif pack:tarballs\"","hidden":true,"multiple":false}},"args":[]},"pack:tarballs":{"id":"pack:tarballs","description":"packages oclif CLI into tarballs\n\nThis can be used to create oclif CLIs that use the system node or that come preloaded with a node binary.\n","strict":true,"pluginName":"oclif","pluginAlias":"oclif","pluginType":"core","aliases":[],"flags":{"root":{"name":"root","type":"option","char":"r","description":"path to oclif CLI root","required":true,"multiple":false,"default":"."},"targets":{"name":"targets","type":"option","char":"t","description":"comma-separated targets to pack (e.g.: linux-arm,win32-x64)","multiple":false,"default":"linux-x64,linux-arm,win32-x64,win32-x86,darwin-x64,darwin-arm64"},"xz":{"name":"xz","type":"boolean","description":"also build xz","allowNo":true}},"args":[]},"pack:win":{"id":"pack:win","description":"create windows installer from oclif CLI\n\n  This command requires WINDOWS_SIGNING (prefixed with the name of your executable, e.g. OCLIF_WINDOWS_SIGNING_PASS) to be set in the environment","strict":true,"pluginName":"oclif","pluginAlias":"oclif","pluginType":"core","aliases":[],"flags":{"root":{"name":"root","type":"option","char":"r","description":"path to oclif CLI root","required":true,"multiple":false,"default":"."},"additional-cli":{"name":"additional-cli","type":"option","description":"an Oclif CLI other than the one listed in config.bin that should be made available to the user\nthe CLI should already exist in a directory named after the CLI that is the root of the tarball produced by \"oclif pack:tarballs\"","hidden":true,"multiple":false}},"args":[]},"upload:deb":{"id":"upload:deb","description":"upload deb package built with pack:deb","strict":true,"pluginName":"oclif","pluginAlias":"oclif","pluginType":"core","aliases":[],"flags":{"root":{"name":"root","type":"option","char":"r","description":"path to oclif CLI root","required":true,"multiple":false,"default":"."}},"args":[]},"upload:macos":{"id":"upload:macos","description":"upload macos installers built with pack:macos","strict":true,"pluginName":"oclif","pluginAlias":"oclif","pluginType":"core","aliases":[],"flags":{"root":{"name":"root","type":"option","char":"r","description":"path to oclif CLI root","required":true,"multiple":false,"default":"."}},"args":[]},"upload:tarballs":{"id":"upload:tarballs","description":"upload an oclif CLI to S3\n\n\"aws-sdk\" will need to be installed as a devDependency to upload.\n","strict":true,"pluginName":"oclif","pluginAlias":"oclif","pluginType":"core","aliases":[],"flags":{"root":{"name":"root","type":"option","char":"r","description":"path to oclif CLI root","required":true,"multiple":false,"default":"."},"targets":{"name":"targets","type":"option","char":"t","description":"comma-separated targets to upload (e.g.: linux-arm,win32-x64)","multiple":false,"default":"linux-x64,linux-arm,win32-x64,win32-x86,darwin-x64,darwin-arm64"},"xz":{"name":"xz","type":"boolean","description":"also upload xz","allowNo":true}},"args":[]},"upload:win":{"id":"upload:win","description":"upload windows installers built with pack:win","strict":true,"pluginName":"oclif","pluginAlias":"oclif","pluginType":"core","aliases":[],"flags":{"root":{"name":"root","type":"option","char":"r","description":"path to oclif CLI root","required":true,"multiple":false,"default":"."}},"args":[]}}}

package/CHANGELOG.md

@@ -2,37 +2,126 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
-## [2.0.0](https://github.com/oclif/oclif/compare/v1.18.1...v2.0.0) (2021-12-01)
+### [2.0.1](https://github.com/oclif/oclif/compare/v2.0.0-main.19...v2.0.1) (2021-12-08)
 
+## [2.0.0-main.19](https://github.com/oclif/oclif/compare/v2.0.0-main.18...v2.0.0-main.19) (2021-12-08)
 
-### ⚠ BREAKING CHANGES
 
-* require node 12+ (#676)
+### Bug Fixes
+
+* bump deps ([#750](https://github.com/oclif/oclif/issues/750)) ([ffb9b99](https://github.com/oclif/oclif/commit/ffb9b99ba2f53a9049f04d0dfea1a4b4b427dfe0))
+
+## [2.0.0-main.18](https://github.com/oclif/oclif/compare/v2.0.0-main.17...v2.0.0-main.18) (2021-12-08)
+
+## [2.0.0-main.17](https://github.com/oclif/oclif/compare/v2.0.0-main.16...v2.0.0-main.17) (2021-12-08)
+
+## [2.0.0-main.16](https://github.com/oclif/oclif/compare/v2.0.0-main.15...v2.0.0-main.16) (2021-12-08)
+
+## [2.0.0-main.15](https://github.com/oclif/oclif/compare/v2.0.0-main.14...v2.0.0-main.15) (2021-12-08)
+
+## [2.0.0-main.14](https://github.com/oclif/oclif/compare/v2.0.0-main.13...v2.0.0-main.14) (2021-12-07)
+
 
 ### Bug Fixes
 
-* bump deps ([#723](https://github.com/oclif/oclif/issues/723)) ([78640ad](https://github.com/oclif/oclif/commit/78640adb106350e1abe747559dc0ae65c853d7c8))
+* bump deps ([#748](https://github.com/oclif/oclif/issues/748)) ([18a42ba](https://github.com/oclif/oclif/commit/18a42ba62dbd165d4ea10f04b755afcf23260b54))
 
+## [2.0.0-main.13](https://github.com/oclif/oclif/compare/v2.0.0-main.12...v2.0.0-main.13) (2021-12-07)
 
-### build
 
-* require node 12+ ([#676](https://github.com/oclif/oclif/issues/676)) ([f4b648c](https://github.com/oclif/oclif/commit/f4b648c244c8806c999ad2e636c446414b14c5a5))
+### Bug Fixes
 
-## [2.0.0-master.0](https://github.com/oclif/oclif/compare/v1.18.1...v2.0.0-master.0) (2021-12-01)
+* bump deps ([#747](https://github.com/oclif/oclif/issues/747)) ([6f61f96](https://github.com/oclif/oclif/commit/6f61f96f123159cb0a9023063c8a949b3fd85a7f))
 
+## [2.0.0-main.12](https://github.com/oclif/oclif/compare/v2.0.0-main.11...v2.0.0-main.12) (2021-12-06)
 
-### ⚠ BREAKING CHANGES
 
-* require node 12+ (#676)
+### Bug Fixes
+
+* bump deps ([#735](https://github.com/oclif/oclif/issues/735)) ([e01c9a7](https://github.com/oclif/oclif/commit/e01c9a7ecf5635309eeca694532b9fa6c9b8bb0d))
+
+## [2.0.0-main.11](https://github.com/oclif/oclif/compare/v2.0.0-main.10...v2.0.0-main.11) (2021-12-01)
+
 
 ### Bug Fixes
 
-* bump deps ([#723](https://github.com/oclif/oclif/issues/723)) ([78640ad](https://github.com/oclif/oclif/commit/78640adb106350e1abe747559dc0ae65c853d7c8))
+* force main build to fix v1 tag/version ([140b581](https://github.com/oclif/oclif/commit/140b5811f018f56e3e26037402887415801f682a))
+
+## [2.0.0-main.10](https://github.com/oclif/oclif/compare/v2.0.0-main.9...v2.0.0-main.10) (2021-11-17)
+
+
+### Features
+
+* support darwin-arm tarballs ([#711](https://github.com/oclif/oclif/issues/711)) ([61cb766](https://github.com/oclif/oclif/commit/61cb7664ce38f1b7827ff652f063c3be7adeb1af))
+
+## [2.0.0-main.9](https://github.com/oclif/oclif/compare/v2.0.0-main.8...v2.0.0-main.9) (2021-11-04)
+
+## [2.0.0-main.8](https://github.com/oclif/oclif/compare/v2.0.0-main.7...v2.0.0-main.8) (2021-10-08)
+
+## [2.0.0-main.7](https://github.com/oclif/oclif/compare/v2.0.0-main.6...v2.0.0-main.7) (2021-10-08)
+
+## [2.0.0-main.6](https://github.com/oclif/oclif/compare/v2.0.0-main.5...v2.0.0-main.6) (2021-10-05)
+
+
+### Features
+
+* add generate cmd ([#665](https://github.com/oclif/oclif/issues/665)) ([731ed49](https://github.com/oclif/oclif/commit/731ed490bc3bc1857d414dfd56d0d8dfd7b6be2b))
+* unhide releasing related cmds ([#670](https://github.com/oclif/oclif/issues/670)) ([25ace5f](https://github.com/oclif/oclif/commit/25ace5f0641cbda3bf8ee0c204be8e6a47f187c6))
+
+
+### Bug Fixes
 
+* bump oclif/core to 1.0.0 ([#687](https://github.com/oclif/oclif/issues/687)) [skip-validate-pr] ([430bb19](https://github.com/oclif/oclif/commit/430bb19068133f3622f660f614e3fa69009cb73c))
+
+## [2.0.0-main.5](https://github.com/oclif/oclif/compare/v2.0.0-main.4...v2.0.0-main.5) (2021-09-20)
+
+
+### ⚠ BREAKING CHANGES
+
+* require node 12+ (#668)
 
 ### build
 
-* require node 12+ ([#676](https://github.com/oclif/oclif/issues/676)) ([f4b648c](https://github.com/oclif/oclif/commit/f4b648c244c8806c999ad2e636c446414b14c5a5))
+* require node 12+ ([#668](https://github.com/oclif/oclif/issues/668)) ([99ceef1](https://github.com/oclif/oclif/commit/99ceef1e761a5f53f25435c8d733cb7a6fb01ba1))
+
+## [2.0.0-main.4](https://github.com/oclif/oclif/compare/v2.0.0-main.3...v2.0.0-main.4) (2021-09-20)
+
+## [2.0.0-main.3](https://github.com/oclif/oclif/compare/v2.0.0-main.2...v2.0.0-main.3) (2021-09-16)
+
+
+### Bug Fixes
+
+* use summary field if available ([#667](https://github.com/oclif/oclif/issues/667)) ([60db19f](https://github.com/oclif/oclif/commit/60db19f89b44d451cfd6579f982b6545dec49ee6))
+
+## [2.0.0-main.2](https://github.com/oclif/oclif/compare/v2.0.0-main.1...v2.0.0-main.2) (2021-08-30)
+
+
+### Bug Fixes
+
+* force build to pickup latest oclif/core ([#648](https://github.com/oclif/oclif/issues/648)) ([4ed1e9a](https://github.com/oclif/oclif/commit/4ed1e9a568a88ef37b51b95f66419cf52e16a3b7))
+* remove context var ([#652](https://github.com/oclif/oclif/issues/652)) ([d8f12fa](https://github.com/oclif/oclif/commit/d8f12faa82566b562cd2c658013a6722e38872fc))
+
+## [2.0.0-main.1](https://github.com/oclif/oclif/compare/v2.0.0-main.0...v2.0.0-main.1) (2021-07-08)
+
+
+### Bug Fixes
+
+* throw error if WINDOWS_SIGNING_PASS is not set ([0dc68b0](https://github.com/oclif/oclif/commit/0dc68b09fd7f52719d45440e4faf85782ced9680))
+
+## [2.0.0-main.0](https://github.com/oclif/oclif/compare/v2.0.0-v2.0...v2.0.0-main.0) (2021-07-08)
+
+
+### Bug Fixes
+
+* change npm tag ([9d07724](https://github.com/oclif/oclif/commit/9d07724cd8b4a200bb6212425311cca2029fa752))
+* prerelease name ([084e890](https://github.com/oclif/oclif/commit/084e8909ea93300a86bf6ddf6319b87a0d3ee5b1))
+
+## [2.0.0-v2.0](https://github.com/oclif/oclif/compare/v1.18.1...v2.0.0-v2.0) (2021-07-08)
+
+
+### Bug Fixes
+
+* use @oclif/core for readme/manifest ([#607](https://github.com/oclif/oclif/issues/607)) ([15ade45](https://github.com/oclif/oclif/commit/15ade4596e4888c2e343d81331132e4ded494338))
 
 ### [1.18.1](https://github.com/oclif/oclif/compare/v1.18.0...v1.18.1) (2021-07-01)
 

package/README.md

@@ -1,5 +1,5 @@
 
-<img src="https://user-images.githubusercontent.com/449385/38243295-e0a47d58-372e-11e8-9bc0-8c02a6f4d2ac.png" width="260" height="73">  
+<img src="https://user-images.githubusercontent.com/449385/38243295-e0a47d58-372e-11e8-9bc0-8c02a6f4d2ac.png" width="260" height="73">
 
 
 oclif: Node.JS Open CLI Framework
@@ -7,22 +7,21 @@ oclif: Node.JS Open CLI Framework
 
 [![Join the community on Spectrum](https://withspectrum.github.io/badge/badge.svg)](https://spectrum.chat/oclif)
 [![Version](https://img.shields.io/npm/v/oclif.svg)](https://npmjs.org/package/oclif)
-[![CircleCI](https://circleci.com/gh/oclif/oclif/tree/master.svg?style=shield)](https://circleci.com/gh/oclif/oclif/tree/master)
-[![Appveyor CI](https://ci.appveyor.com/api/projects/status/github/oclif/oclif?branch=master&svg=true)](https://ci.appveyor.com/project/heroku/oclif/branch/master)
-[![Downloads/week](https://img.shields.io/npm/dw/@oclif/command.svg)](https://npmjs.org/package/@oclif/command)
-[![License](https://img.shields.io/npm/l/oclif.svg)](https://github.com/oclif/oclif/blob/master/package.json)
+[![CircleCI](https://circleci.com/gh/oclif/oclif/tree/main.svg?style=shield)](https://circleci.com/gh/oclif/oclif/tree/main)
+[![Appveyor CI](https://ci.appveyor.com/api/projects/status/github/oclif/oclif?branch=main&svg=true)](https://ci.appveyor.com/project/heroku/oclif/branch/main)
+[![Downloads/week](https://img.shields.io/npm/dw/@oclif/command.svg)](https://npmjs.org/package/@oclif/core)
+[![License](https://img.shields.io/npm/l/oclif.svg)](https://github.com/oclif/oclif/blob/main/package.json)
 
 <!-- toc -->
 * [🗒 Description](#-description)
 * [🚀 Getting Started Tutorial](#-getting-started-tutorial)
 * [✨ Features](#-features)
 * [📌 Requirements](#-requirements)
-* [🌈 CLI Types](#-cli-types)
 * [🏗 Usage](#-usage)
 * [📚 Examples](#-examples)
 * [🔨 Commands](#-commands)
 * [🏭 Related Repositories](#-related-repositories)
-* [🦔 Learn More](#🦔-learn-more)
+* [🦔 Learn More](#-learn-more)
 * [📣 Feedback](#-feedback)
 <!-- tocstop -->
 
@@ -59,40 +58,12 @@ $ heroku info --app=<tab><tab> # will complete with all the Heroku apps a user h
 
 Currently, Node 8+ is supported. We support the [LTS versions](https://nodejs.org/en/about/releases) of Node. You can add the [node](https://www.npmjs.com/package/node) package to your CLI to ensure users are running a specific version of Node.
 
-# 🌈 CLI Types
-
-With oclif you can create 2 different CLI types, single and multi.
-
-Single CLIs are like `ls` or `cat`. They can accept arguments and flags. Single CLIs can [optionally be a single file](https://github.com/oclif/command).
-
-Multi CLIs are like `git` or `heroku`. They have subcommands that are themselves single CLIs. In the `package.json` there is a field `oclif.commands` that points to a directory. This directory contains all the subcommands for the CLI. For example, if you had a CLI called `mycli` with the commands `mycli create` and `mycli destroy`, you would have a project like the following:
-
-```
-package.json
-src/
-└── commands/
-    ├── create.ts
-    └── destroy.ts
-```
-
-Multi-command CLIs may also include [plugins](https://oclif.io/docs/plugins).
-
 # 🏗 Usage
 
-Creating a single-command CLI:
+Creating a CLI:
 
 ```sh-session
-$ npx oclif single mynewcli
-? npm package name (mynewcli): mynewcli
-$ cd mynewcli
-$ ./bin/run
-hello world from ./src/index.js!
-```
-
-Creating a multi-command CLI:
-
-```sh-session
-$ npx oclif multi mynewcli
+$ npx oclif generate mynewcli
 ? npm package name (mynewcli): mynewcli
 $ cd mynewcli
 $ ./bin/run --version
@@ -115,131 +86,287 @@ hello world from ./src/hello.js!
   * [Multi-command CLI](https://github.com/oclif/example-multi-ts)
   * [Single-command CLI](https://github.com/oclif/example-single-ts)
   * [Multi-command CLI Plugin](https://github.com/oclif/example-plugin-ts)
-* JavaScript
-  * [Multi-command CLI](https://github.com/oclif/example-multi-js)
-  * [Single-command CLI](https://github.com/oclif/example-single-js)
-  * [Multi-command CLI Plugin](https://github.com/oclif/example-plugin-js)
 
 # 🔨 Commands
 
 <!-- commands -->
-* [`oclif command NAME`](#oclif-command-name)
+* [`oclif generate NAME`](#oclif-generate-name)
 * [`oclif help [COMMAND]`](#oclif-help-command)
-* [`oclif hook NAME`](#oclif-hook-name)
-* [`oclif multi [PATH]`](#oclif-multi-path)
-* [`oclif plugin [PATH]`](#oclif-plugin-path)
-* [`oclif single [PATH]`](#oclif-single-path)
-
-## `oclif command NAME`
-
-add a command to an existing CLI or plugin
+* [`oclif manifest [PATH]`](#oclif-manifest-path)
+* [`oclif pack:deb`](#oclif-packdeb)
+* [`oclif pack:macos`](#oclif-packmacos)
+* [`oclif pack:tarballs`](#oclif-packtarballs)
+* [`oclif pack:win`](#oclif-packwin)
+* [`oclif promote`](#oclif-promote)
+* [`oclif readme`](#oclif-readme)
+* [`oclif upload:deb`](#oclif-uploaddeb)
+* [`oclif upload:macos`](#oclif-uploadmacos)
+* [`oclif upload:tarballs`](#oclif-uploadtarballs)
+* [`oclif upload:win`](#oclif-uploadwin)
+
+## `oclif generate NAME`
+
+generate a new CLI
 
 ```
 USAGE
-  $ oclif command NAME
+  $ oclif generate [NAME]
 
 ARGUMENTS
-  NAME  name of command
+  NAME  directory name of new project
+
+DESCRIPTION
+  generate a new CLI
 
-OPTIONS
-  --defaults  use defaults for every setting
-  --force     overwrite existing files
+  This will clone the template repo 'oclif/hello-world' and update package properties
 ```
 
-_See code: [src/commands/command.ts](https://github.com/oclif/oclif/blob/v1.8.2/src/commands/command.ts)_
+_See code: [src/commands/generate.ts](https://github.com/oclif/oclif/blob/v2.0.1/src/commands/generate.ts)_
 
 ## `oclif help [COMMAND]`
 
-display help for oclif
+Display help for oclif.
 
 ```
 USAGE
-  $ oclif help [COMMAND]
+  $ oclif help [COMMAND] [-n]
 
 ARGUMENTS
-  COMMAND  command to show help for
+  COMMAND  Command to show help for.
+
+FLAGS
+  -n, --nested-commands  Include all nested commands in the output.
 
-OPTIONS
-  --all  see all commands in CLI
+DESCRIPTION
+  Display help for oclif.
 ```
 
-_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v3.2.9/src/commands/help.ts)_
+_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v5.1.9/src/commands/help.ts)_
 
-## `oclif hook NAME`
+## `oclif manifest [PATH]`
 
-add a hook to an existing CLI or plugin
+generates plugin manifest json
 
 ```
 USAGE
-  $ oclif hook NAME
+  $ oclif manifest [PATH]
 
 ARGUMENTS
-  NAME  name of hook (snake_case)
+  PATH  [default: .] path to plugin
 
-OPTIONS
-  --defaults     use defaults for every setting
-  --event=event  [default: init] event to run hook on
-  --force        overwrite existing files
+DESCRIPTION
+  generates plugin manifest json
 ```
 
-_See code: [src/commands/hook.ts](https://github.com/oclif/oclif/blob/v1.8.2/src/commands/hook.ts)_
+_See code: [src/commands/manifest.ts](https://github.com/oclif/oclif/blob/v2.0.1/src/commands/manifest.ts)_
 
-## `oclif multi [PATH]`
+## `oclif pack:deb`
 
-generate a new multi-command CLI
+pack CLI into debian package
 
 ```
 USAGE
-  $ oclif multi [PATH]
+  $ oclif pack:deb -r <value>
 
-ARGUMENTS
-  PATH  path to project, defaults to current directory
+FLAGS
+  -r, --root=<value>  (required) [default: .] path to oclif CLI root
 
-OPTIONS
-  --defaults         use defaults for every setting
-  --force            overwrite existing files
-  --options=options  (yarn|typescript|eslint|mocha)
+DESCRIPTION
+  pack CLI into debian package
 ```
 
-_See code: [src/commands/multi.ts](https://github.com/oclif/oclif/blob/v1.8.2/src/commands/multi.ts)_
+_See code: [src/commands/pack/deb.ts](https://github.com/oclif/oclif/blob/v2.0.1/src/commands/pack/deb.ts)_
 
-## `oclif plugin [PATH]`
+## `oclif pack:macos`
 
-create a new CLI plugin
+pack CLI into macOS .pkg
 
 ```
 USAGE
-  $ oclif plugin [PATH]
+  $ oclif pack:macos -r <value>
 
-ARGUMENTS
-  PATH  path to project, defaults to current directory
+FLAGS
+  -r, --root=<value>  (required) [default: .] path to oclif CLI root
 
-OPTIONS
-  --defaults         use defaults for every setting
-  --force            overwrite existing files
-  --options=options  (yarn|typescript|eslint|mocha)
+DESCRIPTION
+  pack CLI into macOS .pkg
 ```
 
-_See code: [src/commands/plugin.ts](https://github.com/oclif/oclif/blob/v1.8.2/src/commands/plugin.ts)_
+_See code: [src/commands/pack/macos.ts](https://github.com/oclif/oclif/blob/v2.0.1/src/commands/pack/macos.ts)_
 
-## `oclif single [PATH]`
+## `oclif pack:tarballs`
 
-generate a new single-command CLI
+packages oclif CLI into tarballs
 
 ```
 USAGE
-  $ oclif single [PATH]
+  $ oclif pack:tarballs -r <value> [-t <value>] [--xz]
 
-ARGUMENTS
-  PATH  path to project, defaults to current directory
+FLAGS
+  -r, --root=<value>     (required) [default: .] path to oclif CLI root
+  -t, --targets=<value>  [default: linux-x64,linux-arm,win32-x64,win32-x86,darwin-x64,darwin-arm64] comma-separated
+                         targets to pack (e.g.: linux-arm,win32-x64)
+  --[no-]xz              also build xz
+
+DESCRIPTION
+  packages oclif CLI into tarballs
+
+  This can be used to create oclif CLIs that use the system node or that come preloaded with a node binary.
+```
+
+_See code: [src/commands/pack/tarballs.ts](https://github.com/oclif/oclif/blob/v2.0.1/src/commands/pack/tarballs.ts)_
+
+## `oclif pack:win`
+
+create windows installer from oclif CLI
+
+```
+USAGE
+  $ oclif pack:win -r <value>
+
+FLAGS
+  -r, --root=<value>  (required) [default: .] path to oclif CLI root
+
+DESCRIPTION
+  create windows installer from oclif CLI
+
+  This command requires WINDOWS_SIGNING (prefixed with the name of your executable, e.g. OCLIF_WINDOWS_SIGNING_PASS) to
+  be set in the environment
+```
+
+_See code: [src/commands/pack/win.ts](https://github.com/oclif/oclif/blob/v2.0.1/src/commands/pack/win.ts)_
+
+## `oclif promote`
+
+promote CLI builds to a S3 release channel
+
+```
+USAGE
+  $ oclif promote -r <value> --version <value> --sha <value> --channel <value> [-t <value>] [-d] [-m] [-w]
+    [-a <value>] [--xz] [--indexes]
+
+FLAGS
+  -a, --max-age=<value>  [default: 86400] cache control max-age in seconds
+  -d, --deb              promote debian artifacts
+  -m, --macos            promote macOS pkg
+  -r, --root=<value>     (required) [default: .] path to the oclif CLI project root
+  -t, --targets=<value>  [default: linux-x64,linux-arm,win32-x64,win32-x86,darwin-x64,darwin-arm64] comma-separated
+                         targets to promote (e.g.: linux-arm,win32-x64)
+  -w, --win              promote Windows exe
+  --channel=<value>      (required) [default: stable] which channel to promote to
+  --indexes              append the promoted urls into the index files
+  --sha=<value>          (required) 7-digit short git commit SHA of the CLI to promote
+  --version=<value>      (required) semantic version of the CLI to promote
+  --[no-]xz              also upload xz
+
+DESCRIPTION
+  promote CLI builds to a S3 release channel
+```
+
+_See code: [src/commands/promote.ts](https://github.com/oclif/oclif/blob/v2.0.1/src/commands/promote.ts)_
+
+## `oclif readme`
+
+adds commands to README.md in current directory
+
+```
+USAGE
+  $ oclif readme --dir <value> [--multi]
+
+FLAGS
+  --dir=<value>  (required) [default: docs] output directory for multi docs
+  --multi        create a different markdown page for each topic
+
+DESCRIPTION
+  adds commands to README.md in current directory
+
+  The readme must have any of the following tags inside of it for it to be replaced or else it will do nothing:
+
+  # Usage
+
+  <!-- usage -->
+
+  # Commands
+
+  <!-- commands -->
+
+  Customize the code URL prefix by setting oclif.repositoryPrefix in package.json.
+```
+
+_See code: [src/commands/readme.ts](https://github.com/oclif/oclif/blob/v2.0.1/src/commands/readme.ts)_
+
+## `oclif upload:deb`
+
+upload deb package built with pack:deb
+
+```
+USAGE
+  $ oclif upload:deb -r <value>
+
+FLAGS
+  -r, --root=<value>  (required) [default: .] path to oclif CLI root
+
+DESCRIPTION
+  upload deb package built with pack:deb
+```
+
+_See code: [src/commands/upload/deb.ts](https://github.com/oclif/oclif/blob/v2.0.1/src/commands/upload/deb.ts)_
+
+## `oclif upload:macos`
+
+upload macos installers built with pack:macos
+
+```
+USAGE
+  $ oclif upload:macos -r <value>
+
+FLAGS
+  -r, --root=<value>  (required) [default: .] path to oclif CLI root
+
+DESCRIPTION
+  upload macos installers built with pack:macos
+```
+
+_See code: [src/commands/upload/macos.ts](https://github.com/oclif/oclif/blob/v2.0.1/src/commands/upload/macos.ts)_
+
+## `oclif upload:tarballs`
+
+upload an oclif CLI to S3
+
+```
+USAGE
+  $ oclif upload:tarballs -r <value> [-t <value>] [--xz]
+
+FLAGS
+  -r, --root=<value>     (required) [default: .] path to oclif CLI root
+  -t, --targets=<value>  [default: linux-x64,linux-arm,win32-x64,win32-x86,darwin-x64,darwin-arm64] comma-separated
+                         targets to upload (e.g.: linux-arm,win32-x64)
+  --[no-]xz              also upload xz
+
+DESCRIPTION
+  upload an oclif CLI to S3
+
+  "aws-sdk" will need to be installed as a devDependency to upload.
+```
+
+_See code: [src/commands/upload/tarballs.ts](https://github.com/oclif/oclif/blob/v2.0.1/src/commands/upload/tarballs.ts)_
+
+## `oclif upload:win`
+
+upload windows installers built with pack:win
+
+```
+USAGE
+  $ oclif upload:win -r <value>
+
+FLAGS
+  -r, --root=<value>  (required) [default: .] path to oclif CLI root
 
-OPTIONS
-  --defaults         use defaults for every setting
-  --force            overwrite existing files
-  --options=options  (yarn|typescript|eslint|mocha)
+DESCRIPTION
+  upload windows installers built with pack:win
 ```
 
-_See code: [src/commands/single.ts](https://github.com/oclif/oclif/blob/v1.8.2/src/commands/single.ts)_
+_See code: [src/commands/upload/win.ts](https://github.com/oclif/oclif/blob/v2.0.1/src/commands/upload/win.ts)_
 <!-- commandsstop -->
 
 # 🏭 Related Repositories

package/bin/dev

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+
+const oclif = require('@oclif/core')
+
+const path = require('path')
+const project = path.join(__dirname, '..', 'tsconfig.json')
+
+// In dev mode -> use ts-node and dev plugins
+process.env.NODE_ENV = 'development'
+
+require('ts-node').register({project})
+
+// In dev mode, always show stack traces
+// Waiting for https://github.com/oclif/core/pull/147
+// oclif.settings.debug = true;
+oclif.settings.disableJsonFlag = true
+
+// Start the CLI
+oclif.run().then(oclif.flush).catch(oclif.Errors.handle)

package/bin/dev.cmd

@@ -0,0 +1,3 @@
+@echo off
+
+node "%~dp0\dev" %*