oclif 4.9.3 → 4.10.1

package/lib/commands/generate.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 /* eslint-disable unicorn/no-await-expression-member */
 const core_1 = require("@oclif/core");
 const chalk_1 = __importDefault(require("chalk"));
+const node_fs_1 = require("node:fs");
 const promises_1 = require("node:fs/promises");
 const node_path_1 = require("node:path");
 const validate_npm_package_name_1 = __importDefault(require("validate-npm-package-name"));
@@ -46,17 +47,6 @@ function determineDefaultAuthor(user, defaultValue) {
         return `@${login}`;
     return defaultValue;
 }
-async function clone(repo, location) {
-    try {
-        await (0, generator_1.exec)(`git clone https://github.com/oclif/${repo}.git "${location}" --depth=1`);
-    }
-    catch (error) {
-        const err = error instanceof Error
-            ? new core_1.Errors.CLIError(error)
-            : new core_1.Errors.CLIError('An error occurred while cloning the template repo');
-        throw err;
-    }
-}
 const FLAGGABLE_PROMPTS = {
     author: {
         message: 'Author',
@@ -101,7 +91,9 @@ class Generate extends generator_1.GeneratorCommand {
     static args = {
         name: core_1.Args.string({ description: 'Directory name of new project.', required: true }),
     };
-    static description = `This will clone the template repo and update package properties. For CommonJS, the 'oclif/hello-world' template will be used and for ESM, the 'oclif/hello-world-esm' template will be used.`;
+    static description = `This will generate a fully functional oclif CLI that you can build on. It will prompt you for all the necessary information to get started. If you want to skip the prompts, you can pass the --yes flag to accept the defaults for all prompts. You can also pass individual flags to set specific values for prompts.
+
+Head to oclif.io/docs/introduction to learn more about building CLIs with oclif.`;
     static examples = [
         {
             command: '<%= config.bin %> <%= command.id %> my-cli',
@@ -137,41 +129,39 @@ class Generate extends generator_1.GeneratorCommand {
     async run() {
         const location = this.flags['output-dir'] ? (0, node_path_1.join)(this.flags['output-dir'], this.args.name) : (0, node_path_1.resolve)(this.args.name);
         this.log(`Generating ${this.args.name} in ${chalk_1.default.green(location)}`);
+        if ((0, node_fs_1.existsSync)(location)) {
+            throw new core_1.Errors.CLIError(`The directory ${location} already exists.`);
+        }
         const moduleType = await this.getFlagOrPrompt({
             defaultValue: 'ESM',
             name: 'module-type',
             type: 'select',
         });
-        const template = moduleType === 'ESM' ? 'hello-world-esm' : 'hello-world';
-        await clone(template, location);
-        await (0, promises_1.rm)((0, node_path_1.join)(location, '.git'), { force: true, recursive: true });
-        // We just cloned the template repo so we're sure it has a package.json
-        const packageJSON = (await (0, generator_1.readPJSON)(location));
         const githubUser = await fetchGithubUser();
         const name = await this.getFlagOrPrompt({ defaultValue: this.args.name, name: 'name', type: 'input' });
         const bin = await this.getFlagOrPrompt({ defaultValue: name, name: 'bin', type: 'input' });
         const description = await this.getFlagOrPrompt({
-            defaultValue: packageJSON.description,
+            defaultValue: 'A new CLI generated with oclif',
             name: 'description',
             type: 'input',
         });
         const author = await this.getFlagOrPrompt({
-            defaultValue: determineDefaultAuthor(githubUser, packageJSON.author),
+            defaultValue: determineDefaultAuthor(githubUser, 'Your Name Here'),
             name: 'author',
             type: 'input',
         });
         const license = await this.getFlagOrPrompt({
-            defaultValue: packageJSON.license,
+            defaultValue: 'MIT',
             name: 'license',
             type: 'input',
         });
         const owner = await this.getFlagOrPrompt({
-            defaultValue: githubUser?.login ?? location.split(node_path_1.sep).at(-2) ?? packageJSON.author,
+            defaultValue: githubUser?.login ?? location.split(node_path_1.sep).at(-2) ?? 'Your Name Here',
             name: 'owner',
             type: 'input',
         });
         const repository = await this.getFlagOrPrompt({
-            defaultValue: (name ?? packageJSON.repository ?? packageJSON.name).split('/').at(-1) ?? name,
+            defaultValue: name.split('/').at(-1) ?? name,
             name: 'repository',
             type: 'input',
         });
@@ -180,58 +170,53 @@ class Generate extends generator_1.GeneratorCommand {
             name: 'package-manager',
             type: 'select',
         });
-        const updatedPackageJSON = {
-            ...packageJSON,
-            author,
-            bin: { [bin]: './bin/run.js' },
-            bugs: `https://github.com/${owner}/${repository}/issues`,
-            description,
-            homepage: `https://github.com/${owner}/${repository}`,
-            license,
-            name,
-            oclif: {
-                ...packageJSON.oclif,
-                bin,
-                dirname: bin,
-            },
-            repository: `${owner}/${repository}`,
-            version: '0.0.0',
-        };
-        if (packageManager !== 'yarn') {
-            const scripts = (updatedPackageJSON.scripts || {});
-            updatedPackageJSON.scripts = Object.fromEntries(Object.entries(scripts).map(([k, v]) => [k, v.replace('yarn', `${packageManager} run`)]));
-        }
-        const { default: sortPackageJson } = await import('sort-package-json');
-        await (0, promises_1.writeFile)((0, node_path_1.join)(location, 'package.json'), JSON.stringify(sortPackageJson(updatedPackageJSON), null, 2));
-        await (0, promises_1.rm)((0, node_path_1.join)(location, 'LICENSE'));
-        await (0, promises_1.rm)((0, node_path_1.join)(location, '.github', 'workflows', 'automerge.yml'));
-        const existing = (await (0, promises_1.readFile)((0, node_path_1.join)(location, '.gitignore'), 'utf8')).split('\n');
-        const updated = (0, util_1.uniq)((0, util_1.compact)([
-            '*-debug.log',
-            '*-error.log',
-            'node_modules',
-            '/tmp',
-            '/dist',
-            '/lib',
-            ...(packageManager === 'yarn'
-                ? [
-                    '/package-lock.json',
-                    '.pnp.*',
-                    '.yarn/*',
-                    '!.yarn/patches',
-                    '!.yarn/plugins',
-                    '!.yarn/releases',
-                    '!.yarn/sdks',
-                    '!.yarn/versions',
-                ]
-                : ['/yarn.lock']),
-            ...existing,
-        ]))
-            .sort()
-            .join('\n') + '\n';
-        await (0, promises_1.writeFile)((0, node_path_1.join)(location, '.gitignore'), updated);
-        if (packageManager !== 'yarn') {
-            await (0, promises_1.rm)((0, node_path_1.join)(location, 'yarn.lock'));
+        const [sharedFiles, moduleSpecificFiles] = await Promise.all(['shared', moduleType.toLowerCase()].map((f) => (0, node_path_1.join)(this.templatesDir, 'cli', f)).map(findEjsFiles(location)));
+        await Promise.all([...sharedFiles, ...moduleSpecificFiles].map(async (file) => {
+            switch (file.name) {
+                case 'package.json.ejs': {
+                    const data = {
+                        author,
+                        bin,
+                        description,
+                        license,
+                        moduleType,
+                        name,
+                        owner,
+                        pkgManagerScript: packageManager === 'yarn' ? 'yarn' : `${packageManager} run`,
+                        repository,
+                    };
+                    await this.template(file.src, file.destination, data);
+                    break;
+                }
+                case '.gitignore.ejs': {
+                    await this.template(file.src, file.destination, { packageManager });
+                    break;
+                }
+                case 'README.md.ejs': {
+                    await this.template(file.src, file.destination, { description, name, repository });
+                    break;
+                }
+                case 'onPushToMain.yml.ejs':
+                case 'onRelease.yml.ejs':
+                case 'test.yml.ejs': {
+                    await this.template(file.src, file.destination, {
+                        exec: packageManager === 'yarn' ? packageManager : `${packageManager} exec`,
+                        install: packageManager === 'yarn' ? packageManager : `${packageManager} install`,
+                        packageManager,
+                        run: packageManager === 'yarn' ? packageManager : `${packageManager} run`,
+                    });
+                    break;
+                }
+                default: {
+                    await this.template(file.src, file.destination);
+                }
+            }
+        }));
+        if (process.platform !== 'win32') {
+            await Promise.all([
+                (0, generator_1.exec)(`chmod +x ${(0, node_path_1.join)(location, 'bin', 'run.js')}`),
+                (0, generator_1.exec)(`chmod +x ${(0, node_path_1.join)(location, 'bin', 'dev.js')}`),
+            ]);
         }
         await (0, generator_1.exec)(`${packageManager} install`, { cwd: location, silent: false });
         await (0, generator_1.exec)(`${packageManager} run build`, { cwd: location, silent: false });
@@ -248,3 +233,10 @@ class Generate extends generator_1.GeneratorCommand {
     }
 }
 exports.default = Generate;
+const findEjsFiles = (location) => async (dir) => (await (0, promises_1.readdir)(dir, { recursive: true, withFileTypes: true }))
+    .filter((f) => f.isFile() && f.name.endsWith('.ejs'))
+    .map((f) => ({
+    destination: (0, node_path_1.join)(f.path.replace(dir, location), f.name.replace('.ejs', '')),
+    name: f.name,
+    src: (0, node_path_1.join)(f.path, f.name),
+}));

package/lib/commands/init.js

@@ -114,12 +114,12 @@ class Generate extends generator_1.GeneratorCommand {
         });
         this.log(`Using module type ${chalk_1.default.green(moduleType)}`);
         this.log(`Using package manager ${chalk_1.default.green(packageManager)}`);
-        const templateOptions = { moduleType };
         const projectBinPath = (0, node_path_1.join)(location, 'bin');
-        await this.template((0, node_path_1.join)(this.templatesDir, 'src', 'init', 'dev.cmd.ejs'), (0, node_path_1.join)(projectBinPath, 'dev.cmd'), templateOptions);
-        await this.template((0, node_path_1.join)(this.templatesDir, 'src', 'init', 'dev.js.ejs'), (0, node_path_1.join)(projectBinPath, 'dev.js'), templateOptions);
-        await this.template((0, node_path_1.join)(this.templatesDir, 'src', 'init', 'run.cmd.ejs'), (0, node_path_1.join)(projectBinPath, 'run.cmd'), templateOptions);
-        await this.template((0, node_path_1.join)(this.templatesDir, 'src', 'init', 'run.js.ejs'), (0, node_path_1.join)(projectBinPath, 'run.js'), templateOptions);
+        const templateBinPath = (0, node_path_1.join)(this.templatesDir, 'cli', moduleType.toLowerCase(), 'bin');
+        await this.template((0, node_path_1.join)(templateBinPath, 'dev.cmd.ejs'), (0, node_path_1.join)(projectBinPath, 'dev.cmd'));
+        await this.template((0, node_path_1.join)(templateBinPath, 'dev.js.ejs'), (0, node_path_1.join)(projectBinPath, 'dev.js'));
+        await this.template((0, node_path_1.join)(templateBinPath, 'run.cmd.ejs'), (0, node_path_1.join)(projectBinPath, 'run.cmd'));
+        await this.template((0, node_path_1.join)(templateBinPath, 'run.js.ejs'), (0, node_path_1.join)(projectBinPath, 'run.js'));
         if (process.platform !== 'win32') {
             await (0, generator_1.exec)(`chmod +x "${(0, node_path_1.join)(projectBinPath, 'run.js')}"`);
             await (0, generator_1.exec)(`chmod +x "${(0, node_path_1.join)(projectBinPath, 'dev.js')}"`);

package/oclif.manifest.json

@@ -9,7 +9,7 @@
           "required": true
         }
       },
-      "description": "This will clone the template repo and update package properties. For CommonJS, the 'oclif/hello-world' template will be used and for ESM, the 'oclif/hello-world-esm' template will be used.",
+      "description": "This will generate a fully functional oclif CLI that you can build on. It will prompt you for all the necessary information to get started. If you want to skip the prompts, you can pass the --yes flag to accept the defaults for all prompts. You can also pass individual flags to set specific values for prompts.\n\nHead to oclif.io/docs/introduction to learn more about building CLIs with oclif.",
       "examples": [
         {
           "command": "<%= config.bin %> <%= command.id %> my-cli",
@@ -1074,5 +1074,5 @@
       ]
     }
   },
-  "version": "4.9.3"
+  "version": "4.10.1"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "oclif",
   "description": "oclif: create your own CLI",
-  "version": "4.9.3",
+  "version": "4.10.1",
   "author": "Salesforce",
   "bin": {
     "oclif": "bin/run.js"
@@ -55,7 +55,7 @@
     "eslint-config-oclif": "^5.1.1",
     "eslint-config-oclif-typescript": "^3.1.5",
     "eslint-config-prettier": "^9.0.0",
-    "eslint-plugin-perfectionist": "^2.6.0",
+    "eslint-plugin-perfectionist": "^2.10.0",
     "husky": "^9",
     "lint-staged": "^15",
     "lodash.clonedeep": "^4.5.0",

package/templates/cli/commonjs/.mocharc.json.ejs

@@ -0,0 +1,11 @@
+{
+  "require": [
+    "ts-node/register"
+  ],
+  "watch-extensions": [
+    "ts"
+  ],
+  "recursive": true,
+  "reporter": "spec",
+  "timeout": 60000
+}

package/templates/cli/commonjs/bin/dev.cmd.ejs

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

package/templates/cli/commonjs/bin/dev.js.ejs

@@ -0,0 +1,6 @@
+#!/usr/bin/env node_modules/.bin/ts-node
+// eslint-disable-next-line node/shebang, unicorn/prefer-top-level-await
+;(async () => {
+  const oclif = await import('@oclif/core')
+  await oclif.execute({development: true, dir: __dirname})
+})()

package/templates/cli/commonjs/bin/run.cmd.ejs

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

package/templates/cli/commonjs/bin/run.js.ejs

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+
+// eslint-disable-next-line unicorn/prefer-top-level-await
+(async () => {
+  const oclif = await import('@oclif/core')
+  await oclif.execute({dir: __dirname})
+})()

package/templates/cli/commonjs/tsconfig.json.ejs

@@ -0,0 +1,11 @@
+{
+  "compilerOptions": {
+    "declaration": true,
+    "module": "commonjs",
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "target": "es2022"
+  },
+  "include": ["src/**/*"]
+}

package/templates/cli/esm/.mocharc.json.ejs

@@ -0,0 +1,15 @@
+{
+  "require": [
+    "ts-node/register"
+  ],
+  "watch-extensions": [
+    "ts"
+  ],
+  "recursive": true,
+  "reporter": "spec",
+  "timeout": 60000,
+  "node-option": [
+    "loader=ts-node/esm",
+    "experimental-specifier-resolution=node"
+  ]
+}

package/templates/cli/esm/bin/dev.cmd.ejs

@@ -0,0 +1,3 @@
+@echo off
+
+node --loader ts-node/esm --no-warnings=ExperimentalWarning "%~dp0\dev" %*

package/templates/cli/esm/bin/dev.js.ejs

@@ -0,0 +1,6 @@
+#!/usr/bin/env -S node --loader ts-node/esm --no-warnings=ExperimentalWarning
+
+// eslint-disable-next-line n/shebang
+import {execute} from '@oclif/core'
+
+await execute({development: true, dir: import.meta.url})

package/templates/cli/esm/bin/run.cmd.ejs

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

package/templates/cli/esm/bin/run.js.ejs

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import {execute} from '@oclif/core'
+
+await execute({dir: import.meta.url})

package/templates/cli/esm/tsconfig.json.ejs

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "declaration": true,
+    "module": "Node16",
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "target": "es2022",
+    "moduleResolution": "node16"
+  },
+  "include": ["./src/**/*"],
+  "ts-node": {
+    "esm": true
+  }
+}

package/templates/cli/shared/.eslintignore.ejs

@@ -0,0 +1 @@
+/dist

package/templates/cli/shared/.eslintrc.json.ejs

@@ -0,0 +1,3 @@
+{
+  "extends": ["oclif", "oclif-typescript", "prettier"]
+}

package/templates/cli/shared/.github/workflows/onPushToMain.yml.ejs

@@ -0,0 +1,56 @@
+# test
+name: version, tag and github release
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+      - name: Check if version already exists
+        id: version-check
+        run: |
+          package_version=$(node -p "require('./package.json').version")
+          exists=$(gh api repos/${{ github.repository }}/releases/tags/v$package_version >/dev/null 2>&1 && echo "true" || echo "")
+
+          if [ -n "$exists" ];
+          then
+            echo "Version v$package_version already exists"
+            echo "::warning file=package.json,line=1::Version v$package_version already exists - no release will be created. If you want to create a new release, please update the version in package.json and push again."
+            echo "skipped=true" >> $GITHUB_OUTPUT
+          else
+            echo "Version v$package_version does not exist. Creating release..."
+            echo "skipped=false" >> $GITHUB_OUTPUT
+            echo "tag=v$package_version" >> $GITHUB_OUTPUT
+          fi
+        env:
+          GH_TOKEN: ${{ secrets.GH_TOKEN }}
+      - name: Setup git
+        if: ${{ steps.version-check.outputs.skipped == 'false' }}
+        run: |
+          git config --global user.email ${{ secrets.GH_EMAIL }}
+          git config --global user.name ${{ secrets.GH_USERNAME }}
+      - name: Generate oclif README
+        if: ${{ steps.version-check.outputs.skipped == 'false' }}
+        id: oclif-readme
+        run: |
+          <%- install %>
+          <%- exec %> oclif readme
+          if [ -n "$(git status --porcelain)" ]; then
+            git add .
+            git commit -am "chore: update README.md"
+            git push -u origin ${{ github.ref_name }}
+          fi
+      - name: Create Github Release
+        uses: ncipollo/release-action@2c591bcc8ecdcd2db72b97d6147f871fcd833ba5
+        if: ${{ steps.version-check.outputs.skipped == 'false' }}
+        with:
+          name: ${{ steps.version-check.outputs.tag }}
+          tag: ${{ steps.version-check.outputs.tag }}
+          commit: ${{ github.ref_name }}
+          token: ${{ secrets.GH_TOKEN }}
+          skipIfReleaseExists: true

package/templates/cli/shared/.github/workflows/onRelease.yml.ejs

@@ -0,0 +1,18 @@
+name: publish
+
+on:
+  release:
+    types: [released]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: latest
+      - run: <%- install %>
+      - uses: JS-DevTools/npm-publish@19c28f1ef146469e409470805ea4279d47c3d35c
+        with:
+          token: ${{ secrets.NPM_TOKEN }}

package/templates/cli/shared/.github/workflows/test.yml.ejs

@@ -0,0 +1,23 @@
+name: tests
+on:
+  push:
+    branches-ignore: [main]
+  workflow_dispatch:
+
+jobs:
+  unit-tests:
+    strategy:
+      matrix:
+        os: ['ubuntu-latest', 'windows-latest']
+        node_version: [lts/-1, lts/*, latest]
+      fail-fast: false
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node_version }}
+          cache: <%- packageManager %>
+      - run: <%- install %>
+      - run: <%- run %> build
+      - run: <%- run %> test

package/templates/cli/shared/.gitignore.ejs

@@ -0,0 +1,27 @@
+*-debug.log
+*-error.log
+**/.DS_Store
+/.idea
+/dist
+/tmp
+/node_modules
+oclif.manifest.json
+<% if (packageManager === 'yarn') { %>
+package-lock.json
+pnpm-lock.yaml
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/sdks
+!.yarn/versions
+<% } %>
+<% if (packageManager === 'pnpm') { %>
+yarn.lock
+package-lock.json
+<% } %>
+<% if (packageManager === 'npm') { %>
+yarn.lock
+pnpm-lock.yaml
+<% } %>

package/templates/cli/shared/.prettierrc.json.ejs

@@ -0,0 +1 @@
+"@oclif/prettier-config"

package/templates/cli/shared/.vscode/launch.json.ejs

@@ -0,0 +1,20 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "type": "node",
+      "request": "attach",
+      "name": "Attach",
+      "port": 9229,
+      "skipFiles": ["<node_internals>/**"]
+    },
+    {
+      "type": "node",
+      "request": "launch",
+      "name": "Execute Command",
+      "skipFiles": ["<node_internals>/**"],
+      "program": "${workspaceFolder}/bin/dev",
+      "args": ["hello", "world"]
+    }
+  ]
+}

package/templates/cli/shared/README.md.ejs

@@ -0,0 +1,396 @@
+<%- name %>
+=================
+
+<%- description %>
+
+
+[![oclif](https://img.shields.io/badge/cli-oclif-brightgreen.svg)](https://oclif.io)
+[![Version](https://img.shields.io/npm/v/<%- name %>.svg)](https://npmjs.org/package/<%- name %>)
+[![Downloads/week](https://img.shields.io/npm/dw/<%- name %>.svg)](https://npmjs.org/package/<%- name %>)
+
+
+<!-- toc -->
+* [Usage](#usage)
+* [Commands](#commands)
+<!-- tocstop -->
+# Usage
+<!-- usage -->
+```sh-session
+$ npm install -g mycli123
+$ mycli123 COMMAND
+running command...
+$ mycli123 (--version)
+mycli123/0.0.0 darwin-arm64 node-v20.12.2
+$ mycli123 --help [COMMAND]
+USAGE
+  $ mycli123 COMMAND
+...
+```
+<!-- usagestop -->
+# Commands
+<!-- commands -->
+* [`mycli123 hello PERSON`](#mycli123-hello-person)
+* [`mycli123 hello world`](#mycli123-hello-world)
+* [`mycli123 help [COMMAND]`](#mycli123-help-command)
+* [`mycli123 plugins`](#mycli123-plugins)
+* [`mycli123 plugins add PLUGIN`](#mycli123-plugins-add-plugin)
+* [`mycli123 plugins:inspect PLUGIN...`](#mycli123-pluginsinspect-plugin)
+* [`mycli123 plugins install PLUGIN`](#mycli123-plugins-install-plugin)
+* [`mycli123 plugins link PATH`](#mycli123-plugins-link-path)
+* [`mycli123 plugins remove [PLUGIN]`](#mycli123-plugins-remove-plugin)
+* [`mycli123 plugins reset`](#mycli123-plugins-reset)
+* [`mycli123 plugins uninstall [PLUGIN]`](#mycli123-plugins-uninstall-plugin)
+* [`mycli123 plugins unlink [PLUGIN]`](#mycli123-plugins-unlink-plugin)
+* [`mycli123 plugins update`](#mycli123-plugins-update)
+
+## `mycli123 hello PERSON`
+
+Say hello
+
+```
+USAGE
+  $ mycli123 hello PERSON -f <value>
+
+ARGUMENTS
+  PERSON  Person to say hello to
+
+FLAGS
+  -f, --from=<value>  (required) Who is saying hello
+
+DESCRIPTION
+  Say hello
+
+EXAMPLES
+  $ mycli123 hello friend --from oclif
+  hello friend from oclif! (./src/commands/hello/index.ts)
+```
+
+_See code: [src/commands/hello/index.ts](https://github.com/mdonnalley/mycli123/blob/v0.0.0/src/commands/hello/index.ts)_
+
+## `mycli123 hello world`
+
+Say hello world
+
+```
+USAGE
+  $ mycli123 hello world
+
+DESCRIPTION
+  Say hello world
+
+EXAMPLES
+  $ mycli123 hello world
+  hello world! (./src/commands/hello/world.ts)
+```
+
+_See code: [src/commands/hello/world.ts](https://github.com/mdonnalley/mycli123/blob/v0.0.0/src/commands/hello/world.ts)_
+
+## `mycli123 help [COMMAND]`
+
+Display help for mycli123.
+
+```
+USAGE
+  $ mycli123 help [COMMAND...] [-n]
+
+ARGUMENTS
+  COMMAND...  Command to show help for.
+
+FLAGS
+  -n, --nested-commands  Include all nested commands in the output.
+
+DESCRIPTION
+  Display help for mycli123.
+```
+
+_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v6.0.21/src/commands/help.ts)_
+
+## `mycli123 plugins`
+
+List installed plugins.
+
+```
+USAGE
+  $ mycli123 plugins [--json] [--core]
+
+FLAGS
+  --core  Show core plugins.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  List installed plugins.
+
+EXAMPLES
+  $ mycli123 plugins
+```
+
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.0.16/src/commands/plugins/index.ts)_
+
+## `mycli123 plugins add PLUGIN`
+
+Installs a plugin into mycli123.
+
+```
+USAGE
+  $ mycli123 plugins add PLUGIN... [--json] [-f] [-h] [-s | -v]
+
+ARGUMENTS
+  PLUGIN...  Plugin to install.
+
+FLAGS
+  -f, --force    Force npm to fetch remote resources even if a local copy exists on disk.
+  -h, --help     Show CLI help.
+  -s, --silent   Silences npm output.
+  -v, --verbose  Show verbose npm output.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Installs a plugin into mycli123.
+
+  Uses bundled npm executable to install plugins into /Users/mdonnalley/.local/share/mycli123
+
+  Installation of a user-installed plugin will override a core plugin.
+
+  Use the MYCLI123_NPM_LOG_LEVEL environment variable to set the npm loglevel.
+  Use the MYCLI123_NPM_REGISTRY environment variable to set the npm registry.
+
+ALIASES
+  $ mycli123 plugins add
+
+EXAMPLES
+  Install a plugin from npm registry.
+
+    $ mycli123 plugins add myplugin
+
+  Install a plugin from a github url.
+
+    $ mycli123 plugins add https://github.com/someuser/someplugin
+
+  Install a plugin from a github slug.
+
+    $ mycli123 plugins add someuser/someplugin
+```
+
+## `mycli123 plugins:inspect PLUGIN...`
+
+Displays installation properties of a plugin.
+
+```
+USAGE
+  $ mycli123 plugins inspect PLUGIN...
+
+ARGUMENTS
+  PLUGIN...  [default: .] Plugin to inspect.
+
+FLAGS
+  -h, --help     Show CLI help.
+  -v, --verbose
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Displays installation properties of a plugin.
+
+EXAMPLES
+  $ mycli123 plugins inspect myplugin
+```
+
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.0.16/src/commands/plugins/inspect.ts)_
+
+## `mycli123 plugins install PLUGIN`
+
+Installs a plugin into mycli123.
+
+```
+USAGE
+  $ mycli123 plugins install PLUGIN... [--json] [-f] [-h] [-s | -v]
+
+ARGUMENTS
+  PLUGIN...  Plugin to install.
+
+FLAGS
+  -f, --force    Force npm to fetch remote resources even if a local copy exists on disk.
+  -h, --help     Show CLI help.
+  -s, --silent   Silences npm output.
+  -v, --verbose  Show verbose npm output.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Installs a plugin into mycli123.
+
+  Uses bundled npm executable to install plugins into /Users/mdonnalley/.local/share/mycli123
+
+  Installation of a user-installed plugin will override a core plugin.
+
+  Use the MYCLI123_NPM_LOG_LEVEL environment variable to set the npm loglevel.
+  Use the MYCLI123_NPM_REGISTRY environment variable to set the npm registry.
+
+ALIASES
+  $ mycli123 plugins add
+
+EXAMPLES
+  Install a plugin from npm registry.
+
+    $ mycli123 plugins install myplugin
+
+  Install a plugin from a github url.
+
+    $ mycli123 plugins install https://github.com/someuser/someplugin
+
+  Install a plugin from a github slug.
+
+    $ mycli123 plugins install someuser/someplugin
+```
+
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.0.16/src/commands/plugins/install.ts)_
+
+## `mycli123 plugins link PATH`
+
+Links a plugin into the CLI for development.
+
+```
+USAGE
+  $ mycli123 plugins link PATH [-h] [--install] [-v]
+
+ARGUMENTS
+  PATH  [default: .] path to plugin
+
+FLAGS
+  -h, --help          Show CLI help.
+  -v, --verbose
+      --[no-]install  Install dependencies after linking the plugin.
+
+DESCRIPTION
+  Links a plugin into the CLI for development.
+  Installation of a linked plugin will override a user-installed or core plugin.
+
+  e.g. If you have a user-installed or core plugin that has a 'hello' command, installing a linked plugin with a 'hello'
+  command will override the user-installed or core plugin implementation. This is useful for development work.
+
+
+EXAMPLES
+  $ mycli123 plugins link myplugin
+```
+
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.0.16/src/commands/plugins/link.ts)_
+
+## `mycli123 plugins remove [PLUGIN]`
+
+Removes a plugin from the CLI.
+
+```
+USAGE
+  $ mycli123 plugins remove [PLUGIN...] [-h] [-v]
+
+ARGUMENTS
+  PLUGIN...  plugin to uninstall
+
+FLAGS
+  -h, --help     Show CLI help.
+  -v, --verbose
+
+DESCRIPTION
+  Removes a plugin from the CLI.
+
+ALIASES
+  $ mycli123 plugins unlink
+  $ mycli123 plugins remove
+
+EXAMPLES
+  $ mycli123 plugins remove myplugin
+```
+
+## `mycli123 plugins reset`
+
+Remove all user-installed and linked plugins.
+
+```
+USAGE
+  $ mycli123 plugins reset [--hard] [--reinstall]
+
+FLAGS
+  --hard       Delete node_modules and package manager related files in addition to uninstalling plugins.
+  --reinstall  Reinstall all plugins after uninstalling.
+```
+
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.0.16/src/commands/plugins/reset.ts)_
+
+## `mycli123 plugins uninstall [PLUGIN]`
+
+Removes a plugin from the CLI.
+
+```
+USAGE
+  $ mycli123 plugins uninstall [PLUGIN...] [-h] [-v]
+
+ARGUMENTS
+  PLUGIN...  plugin to uninstall
+
+FLAGS
+  -h, --help     Show CLI help.
+  -v, --verbose
+
+DESCRIPTION
+  Removes a plugin from the CLI.
+
+ALIASES
+  $ mycli123 plugins unlink
+  $ mycli123 plugins remove
+
+EXAMPLES
+  $ mycli123 plugins uninstall myplugin
+```
+
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.0.16/src/commands/plugins/uninstall.ts)_
+
+## `mycli123 plugins unlink [PLUGIN]`
+
+Removes a plugin from the CLI.
+
+```
+USAGE
+  $ mycli123 plugins unlink [PLUGIN...] [-h] [-v]
+
+ARGUMENTS
+  PLUGIN...  plugin to uninstall
+
+FLAGS
+  -h, --help     Show CLI help.
+  -v, --verbose
+
+DESCRIPTION
+  Removes a plugin from the CLI.
+
+ALIASES
+  $ mycli123 plugins unlink
+  $ mycli123 plugins remove
+
+EXAMPLES
+  $ mycli123 plugins unlink myplugin
+```
+
+## `mycli123 plugins update`
+
+Update installed plugins.
+
+```
+USAGE
+  $ mycli123 plugins update [-h] [-v]
+
+FLAGS
+  -h, --help     Show CLI help.
+  -v, --verbose
+
+DESCRIPTION
+  Update installed plugins.
+```
+
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.0.16/src/commands/plugins/update.ts)_
+<!-- commandsstop -->

package/templates/cli/shared/package.json.ejs

@@ -0,0 +1,73 @@
+{
+  "name": "<%- name %>",
+  "description": "<%- description %>",
+  "version": "0.0.0",
+  "author": "<%- author %>",
+  "bin": {
+    "<%- bin %>": "./bin/run.js"
+  },
+  "bugs": "https://github.com/<%- owner %>/<%- repository %>/issues",
+  "dependencies": {
+    "@oclif/core": "^3",
+    "@oclif/plugin-help": "^6",
+    "@oclif/plugin-plugins": "^5"
+  },
+  "devDependencies": {
+    "@oclif/prettier-config": "^0.2.1",
+    "@oclif/test": "^3",
+    "@types/chai": "^4",
+    "@types/mocha": "^10",
+    "@types/node": "^18",
+    "chai": "^4",
+    "eslint": "^8",
+    "eslint-config-oclif": "^5",
+    "eslint-config-oclif-typescript": "^3",
+    "eslint-config-prettier": "^9",
+    "mocha": "^10",
+    "oclif": "^4",
+    "shx": "^0.3.3",
+    "ts-node": "^10",
+    "typescript": "^5"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "/bin",
+    "/dist",
+    "/oclif.manifest.json"
+  ],
+  "homepage": "https://github.com/<%- owner %>/<%- repository %>",
+  "keywords": [
+    "oclif"
+  ],
+  "license": "<%- license %>",
+  "main": "dist/index.js",
+  <% if (moduleType == 'ESM') { %>"type": "module",<% } %>
+  "oclif": {
+    "bin": "<%- bin %>",
+    "dirname": "<%- bin %>",
+    "commands": "./dist/commands",
+    "plugins": [
+      "@oclif/plugin-help",
+      "@oclif/plugin-plugins"
+    ],
+    "topicSeparator": " ",
+    "topics": {
+      "hello": {
+        "description": "Say hello to the world and others"
+      }
+    }
+  },
+  "repository": "<%- owner %>/<%- repository %>",
+  "scripts": {
+    "build": "shx rm -rf dist && tsc -b",
+    "lint": "eslint . --ext .ts",
+    "postpack": "shx rm -f oclif.manifest.json",
+    "posttest": "<%- pkgManagerScript %> lint",
+    "prepack": "oclif manifest && oclif readme",
+    "test": "mocha --forbid-only \"test/**/*.test.ts\"",
+    "version": "oclif readme && git add README.md"
+  },
+  "types": "dist/index.d.ts"
+}

package/templates/cli/shared/src/commands/hello/index.ts.ejs

@@ -0,0 +1,25 @@
+import {Args, Command, Flags} from '@oclif/core'
+
+export default class Hello extends Command {
+  static args = {
+    person: Args.string({description: 'Person to say hello to', required: true}),
+  }
+
+  static description = 'Say hello'
+
+  static examples = [
+    `<%%= config.bin %> <%%= command.id %> friend --from oclif
+hello friend from oclif! (./src/commands/hello/index.ts)
+`,
+  ]
+
+  static flags = {
+    from: Flags.string({char: 'f', description: 'Who is saying hello', required: true}),
+  }
+
+  async run(): Promise<void> {
+    const {args, flags} = await this.parse(Hello)
+
+    this.log(`hello ${args.person} from ${flags.from}! (./src/commands/hello/index.ts)`)
+  }
+}

package/templates/cli/shared/src/commands/hello/world.ts.ejs

@@ -0,0 +1,19 @@
+import {Command} from '@oclif/core'
+
+export default class World extends Command {
+  static args = {}
+
+  static description = 'Say hello world'
+
+  static examples = [
+    `<%%= config.bin %> <%%= command.id %>
+hello world! (./src/commands/hello/world.ts)
+`,
+  ]
+
+  static flags = {}
+
+  async run(): Promise<void> {
+    this.log('hello world! (./src/commands/hello/world.ts)')
+  }
+}

package/templates/cli/shared/src/index.ts.ejs

@@ -0,0 +1 @@
+export {run} from '@oclif/core'

package/templates/cli/shared/test/commands/hello/index.test.ts.ejs

@@ -0,0 +1,10 @@
+import {expect, test} from '@oclif/test'
+
+describe('hello', () => {
+  test
+  .stdout()
+  .command(['hello', 'friend', '--from=oclif'])
+  .it('runs hello cmd', ctx => {
+    expect(ctx.stdout).to.contain('hello friend from oclif!')
+  })
+})

package/templates/cli/shared/test/commands/hello/world.test.ts.ejs

@@ -0,0 +1,10 @@
+import {expect, test} from '@oclif/test'
+
+describe('hello world', () => {
+  test
+  .stdout()
+  .command(['hello:world'])
+  .it('runs hello world cmd', ctx => {
+    expect(ctx.stdout).to.contain('hello world!')
+  })
+})

package/templates/cli/shared/test/tsconfig.json.ejs

@@ -0,0 +1,9 @@
+{
+  "extends": "../tsconfig",
+  "compilerOptions": {
+    "noEmit": true
+  },
+  "references": [
+    {"path": ".."}
+  ]
+}