oclif 2.0.0-main.9 → 2.0.0-master.0

package/.oclif.manifest.json

@@ -1 +1 @@
-{"version":"2.0.0-main.9","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"},"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"},"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"},"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":[]}}}
+{"version":"2.0.0-master.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":[]}}}

package/CHANGELOG.md

@@ -2,74 +2,21 @@
 
 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-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)
+## [2.0.0-master.0](https://github.com/oclif/oclif/compare/v1.18.1...v2.0.0-master.0) (2021-12-01)
 
 
 ### ⚠ BREAKING CHANGES
 
-* require node 12+ (#668)
-
-### build
-
-* 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)
-
+* require node 12+ (#676)
 
 ### Bug Fixes
 
-* use summary field if available ([#667](https://github.com/oclif/oclif/issues/667)) ([60db19f](https://github.com/oclif/oclif/commit/60db19f89b44d451cfd6579f982b6545dec49ee6))
+* bump deps ([#723](https://github.com/oclif/oclif/issues/723)) ([78640ad](https://github.com/oclif/oclif/commit/78640adb106350e1abe747559dc0ae65c853d7c8))
 
-## [2.0.0-main.2](https://github.com/oclif/oclif/compare/v2.0.0-main.1...v2.0.0-main.2) (2021-08-30)
 
+### build
 
-### 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))
+* require node 12+ ([#676](https://github.com/oclif/oclif/issues/676)) ([f4b648c](https://github.com/oclif/oclif/commit/f4b648c244c8806c999ad2e636c446414b14c5a5))
 
 ### [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,16 +7,17 @@ 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/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)
+[![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)
 
 <!-- toc -->
 * [🗒 Description](#-description)
 * [🚀 Getting Started Tutorial](#-getting-started-tutorial)
 * [✨ Features](#-features)
 * [📌 Requirements](#-requirements)
+* [🌈 CLI Types](#-cli-types)
 * [🏗 Usage](#-usage)
 * [📚 Examples](#-examples)
 * [🔨 Commands](#-commands)
@@ -58,12 +59,40 @@ $ 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 CLI:
+Creating a single-command CLI:
 
 ```sh-session
-$ npx oclif generate mynewcli
+$ 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
 ? npm package name (mynewcli): mynewcli
 $ cd mynewcli
 $ ./bin/run --version
@@ -86,42 +115,38 @@ 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 generate NAME`](#oclif-generate-name)
+* [`oclif command NAME`](#oclif-command-name)
 * [`oclif help [COMMAND]`](#oclif-help-command)
-* [`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
+* [`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
 
 ```
 USAGE
-  $ oclif generate [NAME]
+  $ oclif command NAME
 
 ARGUMENTS
-  NAME  directory name of new project
-
-DESCRIPTION
-  generate a new CLI
+  NAME  name of command
 
-  This will clone the template repo 'oclif/hello-world' and update package properties
+OPTIONS
+  --defaults  use defaults for every setting
+  --force     overwrite existing files
 ```
 
-_See code: [src/commands/generate.ts](https://github.com/oclif/oclif/blob/v2.0.0-main.9/src/commands/generate.ts)_
+_See code: [src/commands/command.ts](https://github.com/oclif/oclif/blob/v1.18.1/src/commands/command.ts)_
 
 ## `oclif help [COMMAND]`
 
@@ -129,244 +154,92 @@ display help for oclif
 
 ```
 USAGE
-  $ oclif help [COMMAND] [--all]
+  $ oclif help [COMMAND]
 
 ARGUMENTS
   COMMAND  command to show help for
 
-FLAGS
+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.2/src/commands/help.ts)_
+_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v3.2.9/src/commands/help.ts)_
 
-## `oclif manifest [PATH]`
+## `oclif hook NAME`
 
-generates plugin manifest json
+add a hook to an existing CLI or plugin
 
 ```
 USAGE
-  $ oclif manifest [PATH]
+  $ oclif hook NAME
 
 ARGUMENTS
-  PATH  [default: .] path to plugin
-
-DESCRIPTION
-  generates plugin manifest json
-```
-
-_See code: [src/commands/manifest.ts](https://github.com/oclif/oclif/blob/v2.0.0-main.9/src/commands/manifest.ts)_
-
-## `oclif pack:deb`
-
-pack CLI into debian package
-
-```
-USAGE
-  $ oclif pack:deb -r <value>
-
-FLAGS
-  -r, --root=<value>  (required) [default: .] path to oclif CLI root
-
-DESCRIPTION
-  pack CLI into debian package
-```
-
-_See code: [src/commands/pack/deb.ts](https://github.com/oclif/oclif/blob/v2.0.0-main.9/src/commands/pack/deb.ts)_
-
-## `oclif pack:macos`
-
-pack CLI into macOS .pkg
-
-```
-USAGE
-  $ oclif pack:macos -r <value>
-
-FLAGS
-  -r, --root=<value>  (required) [default: .] path to oclif CLI root
-
-DESCRIPTION
-  pack CLI into macOS .pkg
-```
-
-_See code: [src/commands/pack/macos.ts](https://github.com/oclif/oclif/blob/v2.0.0-main.9/src/commands/pack/macos.ts)_
-
-## `oclif pack:tarballs`
-
-packages oclif CLI into tarballs
-
-```
-USAGE
-  $ oclif pack: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] comma-separated targets to pack
-                         (e.g.: linux-arm,win32-x64)
-  --[no-]xz              also build xz
-
-DESCRIPTION
-  packages oclif CLI into tarballs
+  NAME  name of hook (snake_case)
 
-  This can be used to create oclif CLIs that use the system node or that come preloaded with a node binary.
+OPTIONS
+  --defaults     use defaults for every setting
+  --event=event  [default: init] event to run hook on
+  --force        overwrite existing files
 ```
 
-_See code: [src/commands/pack/tarballs.ts](https://github.com/oclif/oclif/blob/v2.0.0-main.9/src/commands/pack/tarballs.ts)_
+_See code: [src/commands/hook.ts](https://github.com/oclif/oclif/blob/v1.18.1/src/commands/hook.ts)_
 
-## `oclif pack:win`
+## `oclif multi [PATH]`
 
-create windows installer from oclif CLI
+generate a new multi-command CLI
 
 ```
 USAGE
-  $ oclif pack:win -r <value>
+  $ oclif multi [PATH]
 
-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.0-main.9/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] 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.0-main.9/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.0-main.9/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.0-main.9/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
+ARGUMENTS
+  PATH  path to project, defaults to current directory
 
-DESCRIPTION
-  upload macos installers built with pack:macos
+OPTIONS
+  --defaults         use defaults for every setting
+  --force            overwrite existing files
+  --options=options  (yarn|typescript|eslint|mocha)
 ```
 
-_See code: [src/commands/upload/macos.ts](https://github.com/oclif/oclif/blob/v2.0.0-main.9/src/commands/upload/macos.ts)_
+_See code: [src/commands/multi.ts](https://github.com/oclif/oclif/blob/v1.18.1/src/commands/multi.ts)_
 
-## `oclif upload:tarballs`
+## `oclif plugin [PATH]`
 
-upload an oclif CLI to S3
+create a new CLI plugin
 
 ```
 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] comma-separated targets to upload
-                         (e.g.: linux-arm,win32-x64)
-  --[no-]xz              also upload xz
+  $ oclif plugin [PATH]
 
-DESCRIPTION
-  upload an oclif CLI to S3
+ARGUMENTS
+  PATH  path to project, defaults to current directory
 
-  "aws-sdk" will need to be installed as a devDependency to upload.
+OPTIONS
+  --defaults         use defaults for every setting
+  --force            overwrite existing files
+  --options=options  (yarn|typescript|eslint|mocha)
 ```
 
-_See code: [src/commands/upload/tarballs.ts](https://github.com/oclif/oclif/blob/v2.0.0-main.9/src/commands/upload/tarballs.ts)_
+_See code: [src/commands/plugin.ts](https://github.com/oclif/oclif/blob/v1.18.1/src/commands/plugin.ts)_
 
-## `oclif upload:win`
+## `oclif single [PATH]`
 
-upload windows installers built with pack:win
+generate a new single-command CLI
 
 ```
 USAGE
-  $ oclif upload:win -r <value>
+  $ oclif single [PATH]
 
-FLAGS
-  -r, --root=<value>  (required) [default: .] path to oclif CLI root
+ARGUMENTS
+  PATH  path to project, defaults to current directory
 
-DESCRIPTION
-  upload windows installers built with pack:win
+OPTIONS
+  --defaults         use defaults for every setting
+  --force            overwrite existing files
+  --options=options  (yarn|typescript|eslint|mocha)
 ```
 
-_See code: [src/commands/upload/win.ts](https://github.com/oclif/oclif/blob/v2.0.0-main.9/src/commands/upload/win.ts)_
+_See code: [src/commands/single.ts](https://github.com/oclif/oclif/blob/v1.18.1/src/commands/single.ts)_
 <!-- commandsstop -->
 
 # 🏭 Related Repositories

package/bin/run

@@ -1,7 +1,4 @@
 #!/usr/bin/env node
 
-const oclif = require('@oclif/core')
-
-oclif.settings.disableJsonFlag = true
-
-oclif.run().then(require('@oclif/core/flush')).catch(require('@oclif/core/handle'))
+require('..').run()
+.catch(require('@oclif/errors/handle'))

package/lib/app-command.d.ts

@@ -0,0 +1,12 @@
+import { flags } from '@oclif/command';
+import Base from './command-base';
+export default abstract class AppCommand extends Base {
+    static flags: flags.Input<any>;
+    static args: {
+        name: string;
+        required: boolean;
+        description: string;
+    }[];
+    abstract type: string;
+    run(): Promise<void>;
+}

package/lib/app-command.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const command_1 = require("@oclif/command");
+const command_base_1 = require("./command-base");
+class AppCommand extends command_base_1.default {
+    async run() {
+        const { flags, args } = this.parse(AppCommand);
+        const options = flags.options ? flags.options.split(',') : [];
+        await super.generate('app', {
+            type: this.type,
+            path: args.path,
+            options,
+            defaults: flags.defaults,
+            force: flags.force,
+        });
+    }
+}
+exports.default = AppCommand;
+AppCommand.flags = {
+    defaults: command_1.flags.boolean({ description: 'use defaults for every setting' }),
+    options: command_1.flags.string({ description: '(yarn|typescript|eslint|mocha)' }),
+    force: command_1.flags.boolean({ description: 'overwrite existing files' }),
+};
+AppCommand.args = [
+    { name: 'path', required: false, description: 'path to project, defaults to current directory' },
+];

package/lib/aws.d.ts

@@ -11,13 +11,13 @@ export declare namespace upload {
 }
 declare const _default: {
     readonly cloudfront: {
-        createCloudfrontInvalidation: (options: CloudFront.Types.CreateInvalidationRequest) => Promise<unknown>;
+        createCloudfrontInvalidation: (options: CloudFront.CreateInvalidationRequest) => Promise<unknown>;
     };
     readonly s3: {
-        uploadFile: (local: string, options: S3.Types.PutObjectRequest) => Promise<unknown>;
-        headObject: (options: S3.Types.HeadObjectRequest) => Promise<S3.HeadObjectOutput>;
-        copyObject: (options: S3.Types.CopyObjectRequest) => Promise<unknown>;
-        getObject: (options: S3.Types.GetObjectRequest) => Promise<S3.GetObjectOutput>;
+        uploadFile: (local: string, options: S3.PutObjectRequest) => Promise<unknown>;
+        headObject: (options: S3.HeadObjectRequest) => Promise<S3.HeadObjectOutput>;
+        copyObject: (options: S3.CopyObjectRequest) => Promise<unknown>;
+        getObject: (options: S3.GetObjectRequest) => Promise<S3.GetObjectOutput>;
     };
 };
 export default _default;