fix: update command descriptions and defaults

packages/nuxi/src/commands/add.ts

@@ -21,18 +21,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: templateNames.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) {

packages/nuxi/src/commands/analyze.ts

@@ -29,10 +29,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,
     },
   },

packages/nuxi/src/commands/dev.ts

@@ -26,6 +26,7 @@ import { logger } from '../utils/logger'
 import { cwdArgs, dotEnvArgs, envNameArgs, legacyRootDirArgs, logLevelArgs } from './_shared'
 
 const forkSupported = !isTest && (!isBun || isBunForkSupported())
+const listhenArgs = getListhenArgs()
 
 const command = defineCommand({
   meta: {
@@ -35,18 +36,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) {

packages/nuxi/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

packages/nuxi/src/commands/module/search.ts

@@ -29,6 +29,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) {

packages/nuxi/src/commands/upgrade.ts

@@ -89,7 +89,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) {

packages/nuxi/src/utils/dev.ts

@@ -44,10 +44,10 @@ export interface NuxtDevContext {
 
 interface NuxtDevServerOptions {
   cwd: string
-  logLevel: 'silent' | 'info' | 'verbose'
+  logLevel?: 'silent' | 'info' | 'verbose'
   dotenv: boolean
-  envName: string
-  clear: boolean
+  envName?: string
+  clear?: boolean
   defaults: NuxtConfig
   overrides: NuxtConfig
   port?: string | number