oclif 4.9.2 → 4.10.0

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',
@@ -137,41 +127,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 +168,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 +231,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

@@ -1074,5 +1074,5 @@
       ]
     }
   },
-  "version": "4.9.2"
+  "version": "4.10.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "oclif",
   "description": "oclif: create your own CLI",
-  "version": "4.9.2",
+  "version": "4.10.0",
   "author": "Salesforce",
   "bin": {
     "oclif": "bin/run.js"
@@ -12,7 +12,7 @@
     "@aws-sdk/client-s3": "^3.565.0",
     "@inquirer/confirm": "^3.1.6",
     "@inquirer/input": "^2.1.1",
-    "@inquirer/select": "^2.2.1",
+    "@inquirer/select": "^2.3.2",
     "@oclif/core": "^3.26.4",
     "@oclif/plugin-help": "^6.0.21",
     "@oclif/plugin-not-found": "^3.0.14",
@@ -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": ".."}
+  ]
+}