fix: update command descriptions and defaults

src/commands/add.ts

@@ -16,18 +16,19 @@ export default defineCommand({
     ...logLevelArgs,
     force: {
       type: 'boolean',
-      description: 'Override existing file',
+      description: 'Force override file if it already exists',
+      default: false,
     },
     template: {
       type: 'positional',
       required: true,
       valueHint: Object.keys(templates).join('|'),
-      description: `Template type to scaffold`,
+      description: `Specify which template to generate`,
     },
     name: {
       type: 'positional',
       required: true,
-      description: 'Generated file name',
+      description: 'Specify name of the generated file',
     },
   },
   async run(ctx) {

src/commands/analyze.ts

@@ -24,10 +24,12 @@ export default defineCommand({
       type: 'string',
       description: 'Name of the analysis',
       default: 'default',
+      valueHint: 'name',
     },
     serve: {
       type: 'boolean',
       description: 'Serve the analysis results',
+      negativeDescription: 'Skip serving the analysis results',
       default: true,
     },
   },

src/commands/build-module.ts

@@ -16,17 +16,25 @@ export default defineCommand({
     ...cwdArgs,
     ...logLevelArgs,
     ...legacyRootDirArgs,
+    build: {
+      type: 'boolean',
+      description: 'Build module for distribution',
+      default: false,
+    },
     stub: {
       type: 'boolean',
       description: 'Stub dist instead of actually building it for development',
+      default: false,
     },
     sourcemap: {
       type: 'boolean',
       description: 'Generate sourcemaps',
+      default: false,
     },
     prepare: {
       type: 'boolean',
       description: 'Prepare module for local development',
+      default: false,
     },
   },
   async run(ctx) {

src/commands/dev.ts

@@ -20,6 +20,7 @@ import type { NuxtDevContext, NuxtDevIPCMessage } from '../utils/dev'
 import { envNameArgs, legacyRootDirArgs, dotEnvArgs, cwdArgs, logLevelArgs } from './_shared'
 
 const forkSupported = !isBun && !isTest
+const listhenArgs = getListhenArgs()
 
 const command = defineCommand({
   meta: {
@@ -29,18 +30,51 @@ const command = defineCommand({
   args: {
     ...cwdArgs,
     ...logLevelArgs,
-    ...envNameArgs,
-    ...legacyRootDirArgs,
-    ...getListhenArgs(),
     ...dotEnvArgs,
+    ...legacyRootDirArgs,
+    ...envNameArgs,
     clear: {
       type: 'boolean',
       description: 'Clear console on restart',
+      negativeDescription: 'Disable clear console on restart',
     },
     fork: {
       type: 'boolean',
       description: forkSupported ? 'Disable forked mode' : 'Enable forked mode',
+      negativeDescription: 'Disable forked mode',
       default: forkSupported,
+      alias: ['f'],
+    },
+    ...{
+      ...listhenArgs,
+      'port': {
+        ...listhenArgs.port,
+        description: 'Port to listen on (default: `NUXT_PORT || NITRO_PORT || PORT || nuxtOptions.devServer.port`)',
+        alias: ['p'],
+      },
+      'open': {
+        ...listhenArgs.open,
+        alias: ['o'],
+        default: false,
+      },
+      'host': {
+        ...listhenArgs.host,
+        alias: ['h'],
+        description: 'Host to listen on (default: `NUXT_HOST || NITRO_HOST || HOST || nuxtOptions._layers?.[0]?.devServer?.host`)',
+      },
+      'clipboard': { ...listhenArgs.clipboard, default: false },
+      'https.domains': {
+        ...listhenArgs['https.domains'],
+        description: 'Comma separated list of domains and IPs, the autogenerated certificate should be valid for (https: true)',
+      },
+    },
+    sslCert: {
+      type: 'string',
+      description: '(DEPRECATED) Use `--https.cert` instead.',
+    },
+    sslKey: {
+      type: 'string',
+      description: '(DEPRECATED) Use `--https.key` instead.',
     },
   },
   async run(ctx) {

src/commands/generate.ts

@@ -11,9 +11,13 @@ export default defineCommand({
   args: {
     ...cwdArgs,
     ...logLevelArgs,
+    preset: {
+      type: 'string',
+      description: 'Nitro server preset',
+    },
+    ...dotEnvArgs,
     ...envNameArgs,
     ...legacyRootDirArgs,
-    ...dotEnvArgs,
   },
   async run(ctx) {
     ctx.args.prerender = true

src/commands/module/search.ts

@@ -28,6 +28,7 @@ export default defineCommand({
       description:
         'Filter by Nuxt version and list compatible modules only (auto detected by default)',
       required: false,
+      valueHint: '2|3',
     },
   },
   async setup(ctx) {

src/commands/upgrade.ts

@@ -92,7 +92,8 @@ export default defineCommand({
       type: 'string',
       alias: 'ch',
       default: 'stable',
-      description: 'Specify a channel to install from (nightly or stable)',
+      description: 'Specify a channel to install from (default: stable)',
+      valueHint: 'stable|nightly',
     },
   },
   async run(ctx) {

src/utils/dev.ts

@@ -31,10 +31,10 @@ export interface NuxtDevContext {
 
 export interface NuxtDevServerOptions {
   cwd: string
-  logLevel: 'silent' | 'info' | 'verbose'
+  logLevel?: 'silent' | 'info' | 'verbose'
   dotenv: boolean
-  envName: string
-  clear: boolean
+  envName?: string
+  clear?: boolean
   overrides: NuxtConfig
   port?: string | number
   loadingTemplate?: ({ loading }: { loading: string }) => string