@kubb/cli 5.8.0 → 5.8.2

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["command","defineWithTypes","dryRunId","command","defineWithTypes","dryRunId","command","define","command","define","command","define","connectCommand","command","define","command","define","command","define","connectCommand","command","define","command","define","connectCommand","startCommand","loginCommand","logoutCommand","statusCommand","snapshotCommand","define","styleText","isTelemetryDisabled","styleText","cli","generateCommand","initCommand","validateCommand","mcpCommand","studioCommand","dryrun"],"sources":["../src/commands/shared.ts","../src/commands/generate.ts","../src/commands/init.ts","../src/commands/mcp.ts","../src/commands/studio/connect.ts","../src/commands/studio/login.ts","../src/commands/studio/logout.ts","../src/commands/studio/snapshot.ts","../src/commands/studio/background.ts","../src/commands/studio/status.ts","../src/commands/studio/index.ts","../src/commands/validate.ts","../src/deprecatedFlags.ts","../src/index.ts"],"sourcesContent":["import { pluginId as dryRunId } from '@gunshi/plugin-dryrun'\nimport type { DryRunExtension } from '@gunshi/plugin-dryrun'\n\nexport { dryRunId }\n\n/** Extension shape gunshi's command context carries with `@gunshi/plugin-dryrun`; the `extensions` type parameter of `defineWithTypes`. */\nexport type DryRunExtensions = {\n  [dryRunId]: DryRunExtension\n}\n\nexport const configArg = {\n  config: {\n    type: 'string',\n    description: 'Path to the Kubb config',\n    short: 'c',\n  },\n} as const\n\nexport const logLevelArg = {\n  logLevel: {\n    type: 'enum',\n    choices: ['silent', 'info', 'verbose'] as const,\n    description: 'Info, silent or verbose',\n    short: 'l',\n    default: 'info',\n    toKebab: true,\n  },\n} as const\n\nexport const studioConnectionArgs = {\n  url: {\n    type: 'string',\n    description: 'Base URL of the Kubb Studio instance',\n  },\n  token: {\n    type: 'string',\n    description: 'Organization CI API key for `snapshot`. Defaults to KUBB_TOKEN',\n  },\n} as const\n\nexport const studioPermissionArgs = {\n  allowRead: {\n    type: 'boolean',\n    description: 'Read the source of files a generation produced. Asked for once per project when omitted',\n    default: false,\n    toKebab: true,\n  },\n  allowWrite: {\n    type: 'boolean',\n    description: 'Write generated files to disk. Asked for once per project when omitted',\n    default: false,\n    toKebab: true,\n  },\n  allowConfigEdit: {\n    type: 'boolean',\n    description: 'Let Studio change plugin options in kubb.config.ts. Asked for once per project when omitted',\n    default: false,\n    toKebab: true,\n  },\n  allowExec: {\n    type: 'boolean',\n    description: 'Run the formatter, the linter, and output.postGenerate after a generation',\n    default: false,\n    toKebab: true,\n  },\n} as const\n","import { defineWithTypes } from 'gunshi'\nimport type { ReporterName } from '@kubb/core'\nimport { configArg, dryRunId, type DryRunExtensions, logLevelArg } from './shared.ts'\n\nconst REPORTER_NAMES: Array<ReporterName> = ['cli', 'json', 'file', 'html']\n\n/**\n * Splits and validates the comma-separated `--reporter` value against the known reporter names.\n */\nfunction parseReporters(value: string): Array<ReporterName> {\n  const names = value\n    .split(',')\n    .map((name) => name.trim())\n    .filter(Boolean)\n\n  for (const name of names) {\n    if (!REPORTER_NAMES.includes(name as ReporterName)) {\n      throw new Error(`must be one of cli, json, file, html (got \"${name}\")`)\n    }\n  }\n\n  return names as Array<ReporterName>\n}\n\n/**\n * Resolves the effective log level, letting the `--verbose` and `--silent` flags win over `--log-level`.\n */\nfunction resolveLogLevel({ verbose, silent, logLevel }: { verbose: boolean; silent: boolean; logLevel: string }): string {\n  if (verbose) return 'verbose'\n  if (silent) return 'silent'\n  return logLevel\n}\n\nexport const command = defineWithTypes<{ extensions: DryRunExtensions }>()({\n  name: 'generate',\n  description:\n    'Generate TypeScript types, API clients, React Query hooks, Zod schemas, and more from an OpenAPI specification. Reads kubb.config.ts by default. Pass an OpenAPI file path as the first argument to override the input without editing the config.',\n  examples: [\n    'kubb generate                     # generate from kubb.config.ts',\n    'kubb generate ./openapi.yaml      # generate from this spec instead of the config input',\n    'kubb generate --config kubb.config.ts',\n    'kubb generate --watch             # regenerate whenever the spec changes',\n    'kubb generate --dry-run           # preview the run without writing files',\n    'kubb generate --reporter html     # write an HTML run report',\n    'kubb studio                       # connect this project to Kubb Studio and generate from the browser',\n    'kubb studio --allow-write         # let Studio write the generated files to disk',\n    'kubb studio login                 # pair this machine with Studio without connecting',\n  ].join('\\n'),\n  toKebab: true,\n  args: {\n    input: {\n      type: 'positional',\n      required: false,\n      description: 'Path to the OpenAPI specification, overriding the config',\n    },\n    ...configArg,\n    ...logLevelArg,\n    watch: {\n      type: 'boolean',\n      description: 'Watch mode: watches an input file for changes, or polls an input URL',\n      short: 'w',\n      default: false,\n    },\n    verbose: {\n      type: 'boolean',\n      description: 'Override logLevel to verbose',\n      default: false,\n    },\n    silent: {\n      type: 'boolean',\n      description: 'Override logLevel to silent',\n      short: 's',\n      default: false,\n    },\n    reporter: {\n      type: 'custom',\n      description: 'Reporters that render the run: cli, json, file, html. Comma-separated. Overrides config.reporters',\n      metavar: 'cli|json|file|html',\n      parse: parseReporters,\n    },\n  },\n  async run(ctx) {\n    const { values } = ctx\n    const logLevel = resolveLogLevel(values)\n    const { run } = await import('../runners/generate/run.ts')\n\n    await run({\n      input: values.input,\n      configPath: values.config,\n      logLevel,\n      watch: values.watch,\n      reporters: values.reporter,\n      dryRun: ctx.extensions[dryRunId].enabled,\n    })\n  },\n})\n","import { defineWithTypes } from 'gunshi'\nimport { dryRunId, type DryRunExtensions } from './shared.ts'\nimport { version } from '../../package.json'\n\nexport const command = defineWithTypes<{ extensions: DryRunExtensions }>()({\n  name: 'init',\n  description:\n    'Scaffold a kubb.config.ts and install plugins for code generation from an OpenAPI spec. Run without flags for interactive setup, or pass --input, --output, and --plugins to skip the prompts.',\n  examples: [\n    'kubb init',\n    'kubb init --yes',\n    'kubb init --input ./openapi.yaml --output ./src/gen --plugins plugin-ts,plugin-zod',\n    'kubb init --plugins plugin-ts,plugin-axios,plugin-react-query',\n    'kubb init --yes --dry-run',\n  ].join('\\n'),\n  toKebab: true,\n  args: {\n    yes: {\n      type: 'boolean',\n      description: 'Skip prompts and use default options',\n      short: 'y',\n      default: false,\n    },\n    input: {\n      type: 'string',\n      description: 'Path to the OpenAPI specification',\n      short: 'i',\n      metavar: 'path',\n    },\n    output: {\n      type: 'string',\n      description: 'Output directory for generated files',\n      short: 'o',\n      metavar: 'path',\n    },\n    plugins: {\n      type: 'string',\n      description:\n        'Comma-separated list of plugins to use (plugin-ts, plugin-axios, plugin-fetch, plugin-react-query, plugin-vue-query, plugin-zod, plugin-faker, plugin-msw, plugin-cypress, plugin-mcp, plugin-redoc)',\n      metavar: 'plugin-ts,plugin-zod,...',\n    },\n  },\n  async run(ctx) {\n    const { values } = ctx\n    const { run } = await import('../runners/init/run.ts')\n\n    await run({\n      yes: values.yes,\n      version,\n      input: values.input,\n      output: values.output,\n      plugins: values.plugins,\n      dryRun: ctx.extensions[dryRunId],\n    })\n  },\n})\n","import { define } from 'gunshi'\n\n/** The runner is imported when the command runs, so listing `kubb --help` never loads `@kubb/mcp`. */\nexport const command = define({\n  name: 'mcp',\n  description:\n    'Start a Model Context Protocol (MCP) server that exposes Kubb code generation as tools for AI assistants. Once running, configure your AI client (Claude, Cursor, Windsurf, etc.) to connect to it — the assistant can then call kubb generate directly without leaving the chat.',\n  examples: ['kubb mcp', '# Then add to your MCP client config:', '# { \"mcpServers\": { \"kubb\": { \"command\": \"npx\", \"args\": [\"kubb\", \"mcp\"] } } }'].join('\\n'),\n  async run() {\n    const { run } = await import('../runners/mcp/run.ts')\n    await run()\n  },\n})\n","import { define } from 'gunshi'\nimport { configArg, logLevelArg, studioConnectionArgs, studioPermissionArgs } from '../shared.ts'\n\nexport const command = define({\n  name: 'connect',\n  description: 'Connect this project to Kubb Studio and generate from the browser.',\n  examples: [\n    'kubb studio connect',\n    'kubb studio connect --allow-read',\n    'kubb studio connect --allow-write --allow-exec',\n    'kubb studio connect --url http://localhost:3000',\n  ].join('\\n'),\n  toKebab: true,\n  args: {\n    ...configArg,\n    ...studioConnectionArgs,\n    ...studioPermissionArgs,\n    open: {\n      type: 'boolean',\n      description: 'Open the approval page in a browser while pairing',\n      default: true,\n      negatable: true,\n    },\n    ...logLevelArg,\n  },\n  async run(ctx) {\n    const { connectRunner } = await import('../../runners/studio/commands.ts')\n    await connectRunner(ctx)\n  },\n})\n","import { define } from 'gunshi'\nimport { command as connectCommand } from './connect.ts'\n\nexport const command = define({\n  name: 'login',\n  description: 'Pair this machine with Kubb Studio without connecting.',\n  examples: ['kubb studio login', 'kubb studio login --url http://localhost:3000'].join('\\n'),\n  toKebab: true,\n  args: connectCommand.args,\n  async run(ctx) {\n    const { loginRunner } = await import('../../runners/studio/commands.ts')\n    await loginRunner(ctx)\n  },\n})\n","import { define } from 'gunshi'\nimport { configArg, logLevelArg, studioConnectionArgs, studioPermissionArgs } from '../shared.ts'\n\nexport const command = define({\n  name: 'logout',\n  description: 'Forget the stored Kubb Studio token.',\n  examples: ['kubb studio logout'].join('\\n'),\n  toKebab: true,\n  args: {\n    ...configArg,\n    ...studioConnectionArgs,\n    ...studioPermissionArgs,\n    ...logLevelArg,\n  },\n  async run(ctx) {\n    const { logoutRunner } = await import('../../runners/studio/commands.ts')\n    await logoutRunner(ctx)\n  },\n})\n","import { define } from 'gunshi'\nimport { configArg, logLevelArg, studioConnectionArgs } from '../shared.ts'\n\nexport const command = define({\n  name: 'snapshot',\n  description: 'Generate and publish a Kubb Studio snapshot from CI.',\n  examples: ['kubb studio snapshot', 'kubb studio snapshot --json'].join('\\n'),\n  toKebab: true,\n  args: {\n    ...configArg,\n    ...studioConnectionArgs,\n    id: {\n      type: 'string',\n      description: 'Stable identity for the CI agent, such as a pull request. Auto-detected on GitHub Actions, GitLab CI, Bitbucket Pipelines and CircleCI',\n    },\n    baseId: {\n      type: 'string',\n      description:\n        \"Identity of another CI agent, such as the base branch's, to also compare this snapshot with. Auto-detected on GitHub pull requests and GitLab merge requests\",\n      toKebab: true,\n    },\n    name: {\n      type: 'string',\n      description: 'Package name for the generated tarball. Defaults to the name in package.json',\n    },\n    packageVersion: {\n      type: 'string',\n      description: 'Package version for the generated tarball. Defaults to the version in package.json',\n      toKebab: true,\n    },\n    json: {\n      type: 'boolean',\n      description: 'Print the result as one JSON object instead of a summary',\n      default: false,\n    },\n    ...logLevelArg,\n  },\n  async run(ctx) {\n    const { runner } = await import('../../runners/studio/snapshot.ts')\n    await runner(ctx)\n  },\n})\n","import { define } from 'gunshi'\nimport { command as connectCommand } from './connect.ts'\n\nexport const command = define({\n  name: 'start',\n  description: 'Keep this project connected to Kubb Studio in the background.',\n  toKebab: true,\n  args: connectCommand.args,\n  async run(ctx) {\n    const { startRunner } = await import('../../runners/studio/commands.ts')\n    await startRunner(ctx)\n  },\n})\n\nexport const stopCommand = define({\n  name: 'stop',\n  description: \"Stop this project's background connection and keep its pairing.\",\n  async run() {\n    const { stopRunner } = await import('../../runners/studio/commands.ts')\n    await stopRunner()\n  },\n})\n","import { define } from 'gunshi'\nimport { configArg, logLevelArg, studioConnectionArgs, studioPermissionArgs } from '../shared.ts'\n\nexport const command = define({\n  name: 'status',\n  description: 'Show the project worker, Kubb Studio pairing, and saved permissions.',\n  examples: ['kubb studio status'].join('\\n'),\n  toKebab: true,\n  args: {\n    ...configArg,\n    ...studioConnectionArgs,\n    ...studioPermissionArgs,\n    ...logLevelArg,\n  },\n  async run(ctx) {\n    const { statusRunner } = await import('../../runners/studio/commands.ts')\n    await statusRunner(ctx)\n  },\n})\n","import { define } from 'gunshi'\nimport { command as connectCommand } from './connect.ts'\nimport { command as loginCommand } from './login.ts'\nimport { command as logoutCommand } from './logout.ts'\nimport { command as snapshotCommand } from './snapshot.ts'\nimport { command as startCommand, stopCommand } from './background.ts'\nimport { command as statusCommand } from './status.ts'\n\nexport const command = define({\n  name: 'studio',\n  description: 'Connect this project to Kubb Studio, or manage its pairing and snapshots.',\n  examples: ['kubb studio', 'kubb studio --allow-read', 'kubb studio login', 'kubb studio status', 'kubb studio logout', 'kubb studio snapshot'].join('\\n'),\n  toKebab: true,\n  args: connectCommand.args,\n  async run(ctx) {\n    const { connectRunner } = await import('../../runners/studio/commands.ts')\n    await connectRunner(ctx)\n  },\n  subCommands: {\n    start: startCommand,\n    stop: stopCommand,\n    connect: connectCommand,\n    login: loginCommand,\n    logout: logoutCommand,\n    status: statusCommand,\n    snapshot: snapshotCommand,\n  },\n})\n\n/**\n * Sends `kubb studio --flag value` to `kubb studio connect`, the same runner. gunshi picks a\n * subcommand from the first token that is not a flag, so `--url http://…` would read the URL as one.\n */\nexport function routeStudioFlags(args: Array<string>): Array<string> {\n  const [name, next] = args\n  if (name !== 'studio' || !next?.startsWith('-') || next === '--help' || next === '-h') return args\n\n  return ['studio', 'connect', ...args.slice(1)]\n}\n","import { define } from 'gunshi'\n\n/** The runner is imported when the command runs, so listing `kubb --help` never loads `@kubb/adapter-oas`. */\nexport const command = define({\n  name: 'validate',\n  description:\n    'Parse and validate an OpenAPI/Swagger file for structural correctness. Reports schema errors, missing required fields, and malformed references. Use this before running generate to catch spec issues early.',\n  examples: ['kubb validate ./openapi.yaml', 'kubb validate https://petstore3.swagger.io/api/v3/openapi.json'].join('\\n'),\n  args: {\n    input: {\n      type: 'positional',\n      description: 'Path or URL to the OpenAPI/Swagger file to validate',\n      required: true,\n    },\n  },\n  async run({ values }) {\n    const { run } = await import('../runners/validate/run.ts')\n    await run({ input: values.input })\n  },\n})\n","import { styleText } from 'node:util'\n\n/**\n * Maps each camelCase flag removed in favor of kebab-case (kubb-labs/kubb#4046) to its\n * replacement. Drop this table, and the rewrite it drives, once the deprecation window ends.\n */\nconst DEPRECATED_FLAGS: Record<string, string> = {\n  allowWrite: 'allow-write',\n  allowConfigEdit: 'allow-config-edit',\n  allowExec: 'allow-exec',\n  logLevel: 'log-level',\n  dryRun: 'dry-run',\n  packageVersion: 'package-version',\n}\n\nconst FLAG_PATTERN = /^--([a-zA-Z][\\w-]*)(=.*)?$/\n\n/**\n * Rewrites a deprecated camelCase flag to its kebab-case replacement and warns on stderr, so a\n * script written against the old flag names keeps working during the deprecation window instead\n * of failing with an unknown-option error.\n */\nexport function resolveDeprecatedFlags(args: Array<string>): Array<string> {\n  return args.map((arg) => {\n    const match = FLAG_PATTERN.exec(arg)\n    const name = match?.[1]\n    const replacement = name ? DEPRECATED_FLAGS[name] : undefined\n\n    if (!name || !replacement) {\n      return arg\n    }\n\n    console.error(\n      `${styleText('yellow', 'Warning:')} --${name} is deprecated, use --${replacement} instead. --${name} will be removed in a future major version.`,\n    )\n\n    return `--${replacement}${match?.[2] ?? ''}`\n  })\n}\n","import { styleText } from 'node:util'\nimport dryrun from '@gunshi/plugin-dryrun'\nimport { cli } from 'gunshi'\nimport { isDisabled as isTelemetryDisabled } from './Telemetry.ts'\nimport { version } from '../package.json'\nimport { command as generateCommand } from './commands/generate.ts'\nimport { command as initCommand } from './commands/init.ts'\nimport { command as mcpCommand } from './commands/mcp.ts'\nimport { command as studioCommand, routeStudioFlags } from './commands/studio/index.ts'\nimport { command as validateCommand } from './commands/validate.ts'\nimport { resolveDeprecatedFlags } from './deprecatedFlags.ts'\n\n/** Flags that short-circuit execution (help and version). The telemetry notice is suppressed for these. */\nconst QUIET_FLAGS = new Set<string>(['--help', '-h', '--version', '-v', '--json'])\n\n/**\n * Strips the leading executable + script entries when `process.argv` is passed directly.\n * Handles Node.js (`/usr/bin/node`), Bun (`/usr/local/bin/bun`), Deno, tsx, etc. All runtime\n * executable paths contain a path separator; bare command names do not.\n */\nfunction stripExecArgs(argv: Array<string>): Array<string> {\n  const firstArgIsExecutablePath = (argv[0]?.includes('/') || argv[0]?.includes('\\\\')) ?? false\n  return argv.length >= 2 && firstArgIsExecutablePath ? argv.slice(2) : argv\n}\n\n/**\n * Entry point for the `kubb` CLI. Prints the telemetry notice unless telemetry is disabled or a\n * quiet flag is passed, then runs the generate, validate, mcp, studio, and init commands. Defaults to\n * `generate` when no command is given.\n */\nexport async function run(argv: Array<string> = process.argv): Promise<void> {\n  const args = routeStudioFlags(resolveDeprecatedFlags(stripExecArgs(argv)))\n  const isQuietFlag = args.some((arg) => QUIET_FLAGS.has(arg))\n\n  // stderr, so the notice never lands in a stream a client parses, such as `kubb mcp` stdio.\n  if (!isTelemetryDisabled() && !isQuietFlag) {\n    console.error(\n      `${styleText('yellow', 'Notice:')} Kubb collects anonymous telemetry data to help improve the tool. No personal data or file contents are collected. \\nTo disable, set ${styleText('cyan', 'KUBB_DISABLE_TELEMETRY=1')}.\\n`,\n    )\n  }\n\n  // Each command's `run` imports its runner, so an optional peer (@kubb/adapter-oas, @kubb/mcp, @kubb/studio) loads only when it runs.\n  await cli(args, generateCommand, {\n    name: 'kubb',\n    version,\n    // Not `generateCommand.description`: gunshi prints this on every subcommand's help too, so\n    // `kubb studio --help` would open with a paragraph about generating types.\n    description: 'Generate code from an OpenAPI specification, or connect the project to Kubb Studio.',\n    subCommands: {\n      generate: generateCommand,\n      init: initCommand,\n      validate: validateCommand,\n      mcp: mcpCommand,\n      studio: studioCommand,\n    },\n    fallbackToEntry: true,\n    strict: true,\n    plugins: [dryrun({ name: 'dry-run' })],\n    onErrorCommand: async (_ctx, error) => {\n      process.exitCode = 1\n      console.error(error)\n    },\n  })\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["command","define","command","defineWithTypes","dryRunId","command","defineWithTypes","dryRunId","command","define","command","define","command","define","command","define","connectCommand","command","define","command","define","command","define","connectCommand","command","define","command","define","connectCommand","startCommand","loginCommand","logoutCommand","statusCommand","snapshotCommand","command","define","define","styleText","isTelemetryDisabled","styleText","cli","generateCommand","initCommand","validateCommand","mcpCommand","studioCommand","addCommand","updateCommand","listCommand","dryrun"],"sources":["../src/commands/shared.ts","../src/commands/add.ts","../src/commands/generate.ts","../src/commands/init.ts","../src/commands/list.ts","../src/commands/mcp.ts","../src/commands/studio/connect.ts","../src/commands/studio/login.ts","../src/commands/studio/logout.ts","../src/commands/studio/snapshot.ts","../src/commands/studio/background.ts","../src/commands/studio/status.ts","../src/commands/studio/index.ts","../src/commands/update.ts","../src/commands/validate.ts","../src/deprecatedFlags.ts","../src/index.ts"],"sourcesContent":["import { pluginId as dryRunId } from '@gunshi/plugin-dryrun'\nimport type { DryRunExtension } from '@gunshi/plugin-dryrun'\n\nexport { dryRunId }\n\n/** Extension shape gunshi's command context carries with `@gunshi/plugin-dryrun`; the `extensions` type parameter of `defineWithTypes`. */\nexport type DryRunExtensions = {\n  [dryRunId]: DryRunExtension\n}\n\nexport const configArg = {\n  config: {\n    type: 'string',\n    description: 'Path to the Kubb config',\n    short: 'c',\n  },\n} as const\n\nexport const yesArg = {\n  yes: {\n    type: 'boolean',\n    description: 'Skip the confirmation',\n    short: 'y',\n    default: false,\n  },\n} as const\n\nexport const logLevelArg = {\n  logLevel: {\n    type: 'enum',\n    choices: ['silent', 'info', 'verbose'] as const,\n    description: 'Info, silent or verbose',\n    short: 'l',\n    default: 'info',\n    toKebab: true,\n  },\n} as const\n\nexport const studioConnectionArgs = {\n  url: {\n    type: 'string',\n    description: 'Base URL of the Kubb Studio instance',\n  },\n  token: {\n    type: 'string',\n    description: 'Organization CI API key for `snapshot`. Defaults to KUBB_TOKEN',\n  },\n} as const\n\nexport const studioPermissionArgs = {\n  allowRead: {\n    type: 'boolean',\n    description: 'Read the source of files a generation produced. Asked for once per project when omitted',\n    default: false,\n    toKebab: true,\n  },\n  allowWrite: {\n    type: 'boolean',\n    description: 'Write generated files to disk. Asked for once per project when omitted',\n    default: false,\n    toKebab: true,\n  },\n  allowConfigEdit: {\n    type: 'boolean',\n    description: 'Let Studio change plugin options in kubb.config.ts. Asked for once per project when omitted',\n    default: false,\n    toKebab: true,\n  },\n  allowExec: {\n    type: 'boolean',\n    description: 'Run the formatter, the linter, and output.postGenerate after a generation',\n    default: false,\n    toKebab: true,\n  },\n} as const\n","import { define } from 'gunshi'\nimport { configArg, yesArg } from './shared.ts'\n\nexport const command = define({\n  name: 'add',\n  description:\n    'Install a plugin, adapter, or parser from the Kubb registry at its reviewed version. A plugin is added to kubb.config.ts, an adapter or parser prints the code to add. Reads KUBB_REGISTRY to use another registry.',\n  examples: ['kubb add plugin-zod', 'kubb add kubb-labs/plugin-react-query', 'kubb add acme/plugin-x --yes', 'kubb add plugin-zod --no-install'].join('\\n'),\n  toKebab: true,\n  args: {\n    id: {\n      type: 'positional',\n      description: 'Registry id: owner/slug, or a slug for an official extension',\n      required: true,\n    },\n    ...configArg,\n    ...yesArg,\n    install: {\n      type: 'boolean',\n      description: 'Install the package. Pass --no-install to only edit the config',\n      negatable: true,\n      default: true,\n    },\n  },\n  async run({ values }) {\n    const { run } = await import('../runners/add/run.ts')\n    await run({ id: values.id, configPath: values.config, yes: values.yes, install: values.install })\n  },\n})\n","import { defineWithTypes } from 'gunshi'\nimport type { ReporterName } from '@kubb/core'\nimport { configArg, dryRunId, type DryRunExtensions, logLevelArg } from './shared.ts'\n\nconst REPORTER_NAMES: Array<ReporterName> = ['cli', 'json', 'file', 'html']\n\n/**\n * Splits and validates the comma-separated `--reporter` value against the known reporter names.\n */\nfunction parseReporters(value: string): Array<ReporterName> {\n  const names = value\n    .split(',')\n    .map((name) => name.trim())\n    .filter(Boolean)\n\n  for (const name of names) {\n    if (!REPORTER_NAMES.includes(name as ReporterName)) {\n      throw new Error(`must be one of cli, json, file, html (got \"${name}\")`)\n    }\n  }\n\n  return names as Array<ReporterName>\n}\n\n/**\n * Resolves the effective log level, letting the `--verbose` and `--silent` flags win over `--log-level`.\n */\nfunction resolveLogLevel({ verbose, silent, logLevel }: { verbose: boolean; silent: boolean; logLevel: string }): string {\n  if (verbose) return 'verbose'\n  if (silent) return 'silent'\n  return logLevel\n}\n\nexport const command = defineWithTypes<{ extensions: DryRunExtensions }>()({\n  name: 'generate',\n  description:\n    'Generate TypeScript types, API clients, React Query hooks, Zod schemas, and more from an OpenAPI specification. Reads kubb.config.ts by default. Pass an OpenAPI file path as the first argument to override the input without editing the config.',\n  examples: [\n    'kubb generate                     # generate from kubb.config.ts',\n    'kubb generate ./openapi.yaml      # generate from this spec instead of the config input',\n    'kubb generate --config kubb.config.ts',\n    'kubb generate --watch             # regenerate whenever the spec changes',\n    'kubb generate --dry-run           # preview the run without writing files',\n    'kubb generate --reporter html     # write an HTML run report',\n    'kubb studio                       # connect this project to Kubb Studio and generate from the browser',\n    'kubb studio --allow-write         # let Studio write the generated files to disk',\n    'kubb studio login                 # pair this machine with Studio without connecting',\n  ].join('\\n'),\n  toKebab: true,\n  args: {\n    input: {\n      type: 'positional',\n      required: false,\n      description: 'Path to the OpenAPI specification, overriding the config',\n    },\n    ...configArg,\n    ...logLevelArg,\n    watch: {\n      type: 'boolean',\n      description: 'Watch mode: watches an input file for changes, or polls an input URL',\n      short: 'w',\n      default: false,\n    },\n    verbose: {\n      type: 'boolean',\n      description: 'Override logLevel to verbose',\n      default: false,\n    },\n    silent: {\n      type: 'boolean',\n      description: 'Override logLevel to silent',\n      short: 's',\n      default: false,\n    },\n    reporter: {\n      type: 'custom',\n      description: 'Reporters that render the run: cli, json, file, html. Comma-separated. Overrides config.reporters',\n      metavar: 'cli|json|file|html',\n      parse: parseReporters,\n    },\n  },\n  async run(ctx) {\n    const { values } = ctx\n    const logLevel = resolveLogLevel(values)\n    const { run } = await import('../runners/generate/run.ts')\n\n    await run({\n      input: values.input,\n      configPath: values.config,\n      logLevel,\n      watch: values.watch,\n      reporters: values.reporter,\n      dryRun: ctx.extensions[dryRunId].enabled,\n    })\n  },\n})\n","import { defineWithTypes } from 'gunshi'\nimport { dryRunId, type DryRunExtensions } from './shared.ts'\nimport { version } from '../../package.json'\n\nexport const command = defineWithTypes<{ extensions: DryRunExtensions }>()({\n  name: 'init',\n  description:\n    'Scaffold a kubb.config.ts and install plugins for code generation from an OpenAPI spec. Run without flags for interactive setup, or pass --input, --output, and --plugins to skip the prompts.',\n  examples: [\n    'kubb init',\n    'kubb init --yes',\n    'kubb init --input ./openapi.yaml --output ./src/gen --plugins plugin-ts,plugin-zod',\n    'kubb init --plugins plugin-ts,plugin-axios,plugin-react-query',\n    'kubb init --yes --dry-run',\n  ].join('\\n'),\n  toKebab: true,\n  args: {\n    yes: {\n      type: 'boolean',\n      description: 'Skip prompts and use default options',\n      short: 'y',\n      default: false,\n    },\n    input: {\n      type: 'string',\n      description: 'Path to the OpenAPI specification',\n      short: 'i',\n      metavar: 'path',\n    },\n    output: {\n      type: 'string',\n      description: 'Output directory for generated files',\n      short: 'o',\n      metavar: 'path',\n    },\n    plugins: {\n      type: 'string',\n      description:\n        'Comma-separated list of plugins to use (plugin-ts, plugin-axios, plugin-fetch, plugin-react-query, plugin-vue-query, plugin-zod, plugin-faker, plugin-msw, plugin-cypress, plugin-mcp, plugin-redoc)',\n      metavar: 'plugin-ts,plugin-zod,...',\n    },\n  },\n  async run(ctx) {\n    const { values } = ctx\n    const { run } = await import('../runners/init/run.ts')\n\n    await run({\n      yes: values.yes,\n      version,\n      input: values.input,\n      output: values.output,\n      plugins: values.plugins,\n      dryRun: ctx.extensions[dryRunId],\n    })\n  },\n})\n","import { define } from 'gunshi'\n\nexport const command = define({\n  name: 'list',\n  description:\n    'List the installed Kubb extensions: their registry id, package, installed version, the version the Kubb registry pins, and whether an update exists.',\n  examples: 'kubb list',\n  async run() {\n    const { run } = await import('../runners/list/run.ts')\n    await run()\n  },\n})\n","import { define } from 'gunshi'\n\n/** The runner is imported when the command runs, so listing `kubb --help` never loads `@kubb/mcp`. */\nexport const command = define({\n  name: 'mcp',\n  description:\n    'Start a Model Context Protocol (MCP) server that exposes Kubb code generation as tools for AI assistants. Once running, configure your AI client (Claude, Cursor, Windsurf, etc.) to connect to it — the assistant can then call kubb generate directly without leaving the chat.',\n  examples: ['kubb mcp', '# Then add to your MCP client config:', '# { \"mcpServers\": { \"kubb\": { \"command\": \"npx\", \"args\": [\"kubb\", \"mcp\"] } } }'].join('\\n'),\n  async run() {\n    const { run } = await import('../runners/mcp/run.ts')\n    await run()\n  },\n})\n","import { define } from 'gunshi'\nimport { configArg, logLevelArg, studioConnectionArgs, studioPermissionArgs } from '../shared.ts'\n\nexport const command = define({\n  name: 'connect',\n  description: 'Connect this project to Kubb Studio and generate from the browser.',\n  examples: [\n    'kubb studio connect',\n    'kubb studio connect --allow-read',\n    'kubb studio connect --allow-write --allow-exec',\n    'kubb studio connect --url http://localhost:3000',\n  ].join('\\n'),\n  toKebab: true,\n  args: {\n    ...configArg,\n    ...studioConnectionArgs,\n    ...studioPermissionArgs,\n    open: {\n      type: 'boolean',\n      description: 'Open the approval page in a browser while pairing',\n      default: true,\n      negatable: true,\n    },\n    ...logLevelArg,\n  },\n  async run(ctx) {\n    const { connectRunner } = await import('../../runners/studio/commands.ts')\n    await connectRunner(ctx)\n  },\n})\n","import { define } from 'gunshi'\nimport { command as connectCommand } from './connect.ts'\n\nexport const command = define({\n  name: 'login',\n  description: 'Pair this machine with Kubb Studio without connecting.',\n  examples: ['kubb studio login', 'kubb studio login --url http://localhost:3000'].join('\\n'),\n  toKebab: true,\n  args: connectCommand.args,\n  async run(ctx) {\n    const { loginRunner } = await import('../../runners/studio/commands.ts')\n    await loginRunner(ctx)\n  },\n})\n","import { define } from 'gunshi'\nimport { configArg, logLevelArg, studioConnectionArgs, studioPermissionArgs } from '../shared.ts'\n\nexport const command = define({\n  name: 'logout',\n  description: 'Forget the stored Kubb Studio token.',\n  examples: ['kubb studio logout'].join('\\n'),\n  toKebab: true,\n  args: {\n    ...configArg,\n    ...studioConnectionArgs,\n    ...studioPermissionArgs,\n    ...logLevelArg,\n  },\n  async run(ctx) {\n    const { logoutRunner } = await import('../../runners/studio/commands.ts')\n    await logoutRunner(ctx)\n  },\n})\n","import { define } from 'gunshi'\nimport { configArg, logLevelArg, studioConnectionArgs } from '../shared.ts'\n\nexport const command = define({\n  name: 'snapshot',\n  description: 'Generate and publish a Kubb Studio snapshot from CI.',\n  examples: ['kubb studio snapshot', 'kubb studio snapshot --json'].join('\\n'),\n  toKebab: true,\n  args: {\n    ...configArg,\n    ...studioConnectionArgs,\n    id: {\n      type: 'string',\n      description: 'Stable identity for the CI agent, such as a pull request. Auto-detected on GitHub Actions, GitLab CI, Bitbucket Pipelines and CircleCI',\n    },\n    baseId: {\n      type: 'string',\n      description:\n        \"Identity of another CI agent, such as the base branch's, to also compare this snapshot with. Auto-detected on GitHub pull requests and GitLab merge requests\",\n      toKebab: true,\n    },\n    name: {\n      type: 'string',\n      description: 'Package name for the generated tarball. Defaults to the name in package.json',\n    },\n    packageVersion: {\n      type: 'string',\n      description: 'Package version for the generated tarball. Defaults to the version in package.json',\n      toKebab: true,\n    },\n    json: {\n      type: 'boolean',\n      description: 'Print the result as one JSON object instead of a summary',\n      default: false,\n    },\n    ...logLevelArg,\n  },\n  async run(ctx) {\n    const { runner } = await import('../../runners/studio/snapshot.ts')\n    await runner(ctx)\n  },\n})\n","import { define } from 'gunshi'\nimport { command as connectCommand } from './connect.ts'\n\nexport const command = define({\n  name: 'start',\n  description: 'Keep this project connected to Kubb Studio in the background.',\n  toKebab: true,\n  args: connectCommand.args,\n  async run(ctx) {\n    const { startRunner } = await import('../../runners/studio/commands.ts')\n    await startRunner(ctx)\n  },\n})\n\nexport const stopCommand = define({\n  name: 'stop',\n  description: \"Stop this project's background connection and keep its pairing.\",\n  async run() {\n    const { stopRunner } = await import('../../runners/studio/commands.ts')\n    await stopRunner()\n  },\n})\n","import { define } from 'gunshi'\nimport { configArg, logLevelArg, studioConnectionArgs, studioPermissionArgs } from '../shared.ts'\n\nexport const command = define({\n  name: 'status',\n  description: 'Show the project worker, Kubb Studio pairing, and saved permissions.',\n  examples: ['kubb studio status'].join('\\n'),\n  toKebab: true,\n  args: {\n    ...configArg,\n    ...studioConnectionArgs,\n    ...studioPermissionArgs,\n    ...logLevelArg,\n  },\n  async run(ctx) {\n    const { statusRunner } = await import('../../runners/studio/commands.ts')\n    await statusRunner(ctx)\n  },\n})\n","import { define } from 'gunshi'\nimport { command as connectCommand } from './connect.ts'\nimport { command as loginCommand } from './login.ts'\nimport { command as logoutCommand } from './logout.ts'\nimport { command as snapshotCommand } from './snapshot.ts'\nimport { command as startCommand, stopCommand } from './background.ts'\nimport { command as statusCommand } from './status.ts'\n\nexport const command = define({\n  name: 'studio',\n  description: 'Connect this project to Kubb Studio, or manage its pairing and snapshots.',\n  examples: ['kubb studio', 'kubb studio --allow-read', 'kubb studio login', 'kubb studio status', 'kubb studio logout', 'kubb studio snapshot'].join('\\n'),\n  toKebab: true,\n  args: connectCommand.args,\n  async run(ctx) {\n    const { connectRunner } = await import('../../runners/studio/commands.ts')\n    await connectRunner(ctx)\n  },\n  subCommands: {\n    start: startCommand,\n    stop: stopCommand,\n    connect: connectCommand,\n    login: loginCommand,\n    logout: logoutCommand,\n    status: statusCommand,\n    snapshot: snapshotCommand,\n  },\n})\n\n/**\n * Sends `kubb studio --flag value` to `kubb studio connect`, the same runner. gunshi picks a\n * subcommand from the first token that is not a flag, so `--url http://…` would read the URL as one.\n */\nexport function routeStudioFlags(args: Array<string>): Array<string> {\n  const [name, next] = args\n  if (name !== 'studio' || !next?.startsWith('-') || next === '--help' || next === '-h') return args\n\n  return ['studio', 'connect', ...args.slice(1)]\n}\n","import { define } from 'gunshi'\nimport { yesArg } from './shared.ts'\n\nexport const command = define({\n  name: 'update',\n  description:\n    'Update installed extensions to the version the Kubb registry pins. Pass ids to update only those, or --check to list the updates without installing.',\n  examples: ['kubb update', 'kubb update --check', 'kubb update plugin-zod plugin-ts --yes'].join('\\n'),\n  args: {\n    ids: {\n      type: 'positional',\n      description: 'Registry ids to update, all installed extensions when omitted',\n      multiple: true,\n    },\n    check: {\n      type: 'boolean',\n      description: 'List the available updates without installing them',\n      default: false,\n    },\n    ...yesArg,\n  },\n  async run({ values }) {\n    const { run } = await import('../runners/update/run.ts')\n    await run({ ids: values.ids ?? [], check: values.check, yes: values.yes })\n  },\n})\n","import { define } from 'gunshi'\n\n/** The runner is imported when the command runs, so listing `kubb --help` never loads `@kubb/adapter-oas`. */\nexport const command = define({\n  name: 'validate',\n  description:\n    'Parse and validate an OpenAPI/Swagger file for structural correctness. Reports schema errors, missing required fields, and malformed references. Use this before running generate to catch spec issues early.',\n  examples: ['kubb validate ./openapi.yaml', 'kubb validate https://petstore3.swagger.io/api/v3/openapi.json'].join('\\n'),\n  args: {\n    input: {\n      type: 'positional',\n      description: 'Path or URL to the OpenAPI/Swagger file to validate',\n      required: true,\n    },\n  },\n  async run({ values }) {\n    const { run } = await import('../runners/validate/run.ts')\n    await run({ input: values.input })\n  },\n})\n","import { styleText } from 'node:util'\n\n/**\n * Maps each camelCase flag removed in favor of kebab-case (kubb-labs/kubb#4046) to its\n * replacement. Drop this table, and the rewrite it drives, once the deprecation window ends.\n */\nconst DEPRECATED_FLAGS: Record<string, string> = {\n  allowWrite: 'allow-write',\n  allowConfigEdit: 'allow-config-edit',\n  allowExec: 'allow-exec',\n  logLevel: 'log-level',\n  dryRun: 'dry-run',\n  packageVersion: 'package-version',\n}\n\nconst FLAG_PATTERN = /^--([a-zA-Z][\\w-]*)(=.*)?$/\n\n/**\n * Rewrites a deprecated camelCase flag to its kebab-case replacement and warns on stderr, so a\n * script written against the old flag names keeps working during the deprecation window instead\n * of failing with an unknown-option error.\n */\nexport function resolveDeprecatedFlags(args: Array<string>): Array<string> {\n  return args.map((arg) => {\n    const match = FLAG_PATTERN.exec(arg)\n    const name = match?.[1]\n    const replacement = name ? DEPRECATED_FLAGS[name] : undefined\n\n    if (!name || !replacement) {\n      return arg\n    }\n\n    console.error(\n      `${styleText('yellow', 'Warning:')} --${name} is deprecated, use --${replacement} instead. --${name} will be removed in a future major version.`,\n    )\n\n    return `--${replacement}${match?.[2] ?? ''}`\n  })\n}\n","import { styleText } from 'node:util'\nimport dryrun from '@gunshi/plugin-dryrun'\nimport { cli } from 'gunshi'\nimport { isDisabled as isTelemetryDisabled } from './Telemetry.ts'\nimport { version } from '../package.json'\nimport { command as addCommand } from './commands/add.ts'\nimport { command as generateCommand } from './commands/generate.ts'\nimport { command as initCommand } from './commands/init.ts'\nimport { command as listCommand } from './commands/list.ts'\nimport { command as mcpCommand } from './commands/mcp.ts'\nimport { command as studioCommand, routeStudioFlags } from './commands/studio/index.ts'\nimport { command as updateCommand } from './commands/update.ts'\nimport { command as validateCommand } from './commands/validate.ts'\nimport { resolveDeprecatedFlags } from './deprecatedFlags.ts'\n\n/** Flags that short-circuit execution (help and version). The telemetry notice is suppressed for these. */\nconst QUIET_FLAGS = new Set<string>(['--help', '-h', '--version', '-v', '--json'])\n\n/**\n * Strips the leading executable + script entries when `process.argv` is passed directly.\n * Handles Node.js (`/usr/bin/node`), Bun (`/usr/local/bin/bun`), Deno, tsx, etc. All runtime\n * executable paths contain a path separator; bare command names do not.\n */\nfunction stripExecArgs(argv: Array<string>): Array<string> {\n  const firstArgIsExecutablePath = (argv[0]?.includes('/') || argv[0]?.includes('\\\\')) ?? false\n  return argv.length >= 2 && firstArgIsExecutablePath ? argv.slice(2) : argv\n}\n\n/**\n * Entry point for the `kubb` CLI. Prints the telemetry notice unless telemetry is disabled or a\n * quiet flag is passed, then runs the given command, or `generate` when none is given.\n */\nexport async function run(argv: Array<string> = process.argv): Promise<void> {\n  const args = routeStudioFlags(resolveDeprecatedFlags(stripExecArgs(argv)))\n  const isQuietFlag = args.some((arg) => QUIET_FLAGS.has(arg))\n\n  // stderr, so the notice never lands in a stream a client parses, such as `kubb mcp` stdio.\n  if (!isTelemetryDisabled() && !isQuietFlag) {\n    console.error(\n      `${styleText('yellow', 'Notice:')} Kubb collects anonymous telemetry data to help improve the tool. No personal data or file contents are collected. \\nTo disable, set ${styleText('cyan', 'KUBB_DISABLE_TELEMETRY=1')}.\\n`,\n    )\n  }\n\n  // Each command's `run` imports its runner, so an optional peer (@kubb/adapter-oas, @kubb/mcp, @kubb/studio) loads only when it runs.\n  await cli(args, generateCommand, {\n    name: 'kubb',\n    version,\n    // Not `generateCommand.description`: gunshi prints this on every subcommand's help too, so\n    // `kubb studio --help` would open with a paragraph about generating types.\n    description: 'Generate code from an OpenAPI specification, manage Kubb extensions, or connect the project to Kubb Studio.',\n    subCommands: {\n      generate: generateCommand,\n      init: initCommand,\n      validate: validateCommand,\n      mcp: mcpCommand,\n      studio: studioCommand,\n      add: addCommand,\n      update: updateCommand,\n      list: listCommand,\n    },\n    fallbackToEntry: true,\n    strict: true,\n    plugins: [dryrun({ name: 'dry-run' })],\n    onErrorCommand: async (_ctx, error) => {\n      process.exitCode = 1\n      console.error(error)\n    },\n  })\n}\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -2,8 +2,7 @@ import { t as __name } from "./rolldown-runtime-CRm0XQPb.js";
 //#region src/index.d.ts
 /**
  * Entry point for the `kubb` CLI. Prints the telemetry notice unless telemetry is disabled or a
- * quiet flag is passed, then runs the generate, validate, mcp, studio, and init commands. Defaults to
- * `generate` when no command is given.
+ * quiet flag is passed, then runs the given command, or `generate` when none is given.
  */
 export declare function run(argv?: Array<string>): Promise<void>;
 //#endregion

package/dist/index.js

@@ -1,5 +1,5 @@
 import "./rolldown-runtime-CRm0XQPb.js";
-import { r as version, t as isDisabled } from "./Telemetry-A_TdzcbF.js";
+import { r as version, t as isDisabled } from "./Telemetry-DMMnTu4n.js";
 import { styleText } from "node:util";
 import dryrun, { pluginId as dryRunId } from "@gunshi/plugin-dryrun";
 import { cli, define, defineWithTypes } from "gunshi";
@@ -9,6 +9,12 @@ const configArg = { config: {
 	description: "Path to the Kubb config",
 	short: "c"
 } };
+const yesArg = { yes: {
+	type: "boolean",
+	description: "Skip the confirmation",
+	short: "y",
+	default: false
+} };
 const logLevelArg = { logLevel: {
 	type: "enum",
 	choices: [
@@ -58,6 +64,43 @@ const studioPermissionArgs = {
 	}
 };
 //#endregion
+//#region src/commands/add.ts
+const command$13 = define({
+	name: "add",
+	description: "Install a plugin, adapter, or parser from the Kubb registry at its reviewed version. A plugin is added to kubb.config.ts, an adapter or parser prints the code to add. Reads KUBB_REGISTRY to use another registry.",
+	examples: [
+		"kubb add plugin-zod",
+		"kubb add kubb-labs/plugin-react-query",
+		"kubb add acme/plugin-x --yes",
+		"kubb add plugin-zod --no-install"
+	].join("\n"),
+	toKebab: true,
+	args: {
+		id: {
+			type: "positional",
+			description: "Registry id: owner/slug, or a slug for an official extension",
+			required: true
+		},
+		...configArg,
+		...yesArg,
+		install: {
+			type: "boolean",
+			description: "Install the package. Pass --no-install to only edit the config",
+			negatable: true,
+			default: true
+		}
+	},
+	async run({ values }) {
+		const { run } = await import("./run-BURZ4hDs.js");
+		await run({
+			id: values.id,
+			configPath: values.config,
+			yes: values.yes,
+			install: values.install
+		});
+	}
+});
+//#endregion
 //#region src/commands/generate.ts
 const REPORTER_NAMES = [
 	"cli",
@@ -81,7 +124,7 @@ function resolveLogLevel({ verbose, silent, logLevel }) {
 	if (silent) return "silent";
 	return logLevel;
 }
-const command$10 = defineWithTypes()({
+const command$12 = defineWithTypes()({
 	name: "generate",
 	description: "Generate TypeScript types, API clients, React Query hooks, Zod schemas, and more from an OpenAPI specification. Reads kubb.config.ts by default. Pass an OpenAPI file path as the first argument to override the input without editing the config.",
 	examples: [
@@ -131,7 +174,7 @@ const command$10 = defineWithTypes()({
 	async run(ctx) {
 		const { values } = ctx;
 		const logLevel = resolveLogLevel(values);
-		const { run } = await import("./run-BNEll0r7.js");
+		const { run } = await import("./run-Myj1dJrW.js");
 		await run({
 			input: values.input,
 			configPath: values.config,
@@ -144,7 +187,7 @@ const command$10 = defineWithTypes()({
 });
 //#endregion
 //#region src/commands/init.ts
-const command$9 = defineWithTypes()({
+const command$11 = defineWithTypes()({
 	name: "init",
 	description: "Scaffold a kubb.config.ts and install plugins for code generation from an OpenAPI spec. Run without flags for interactive setup, or pass --input, --output, and --plugins to skip the prompts.",
 	examples: [
@@ -182,7 +225,7 @@ const command$9 = defineWithTypes()({
 	},
 	async run(ctx) {
 		const { values } = ctx;
-		const { run } = await import("./run-BTU318R1.js");
+		const { run } = await import("./run-USNnlQcA.js");
 		await run({
 			yes: values.yes,
 			version,
@@ -194,9 +237,20 @@ const command$9 = defineWithTypes()({
 	}
 });
 //#endregion
+//#region src/commands/list.ts
+const command$10 = define({
+	name: "list",
+	description: "List the installed Kubb extensions: their registry id, package, installed version, the version the Kubb registry pins, and whether an update exists.",
+	examples: "kubb list",
+	async run() {
+		const { run } = await import("./run-CDS3EWEN.js");
+		await run();
+	}
+});
+//#endregion
 //#region src/commands/mcp.ts
 /** The runner is imported when the command runs, so listing `kubb --help` never loads `@kubb/mcp`. */
-const command$8 = define({
+const command$9 = define({
 	name: "mcp",
 	description: "Start a Model Context Protocol (MCP) server that exposes Kubb code generation as tools for AI assistants. Once running, configure your AI client (Claude, Cursor, Windsurf, etc.) to connect to it — the assistant can then call kubb generate directly without leaving the chat.",
 	examples: [
@@ -205,13 +259,13 @@ const command$8 = define({
 		"# { \"mcpServers\": { \"kubb\": { \"command\": \"npx\", \"args\": [\"kubb\", \"mcp\"] } } }"
 	].join("\n"),
 	async run() {
-		const { run } = await import("./run-CN5DJ5XC.js");
+		const { run } = await import("./run-CGqjX3nk.js");
 		await run();
 	}
 });
 //#endregion
 //#region src/commands/studio/connect.ts
-const command$7 = define({
+const command$8 = define({
 	name: "connect",
 	description: "Connect this project to Kubb Studio and generate from the browser.",
 	examples: [
@@ -234,26 +288,26 @@ const command$7 = define({
 		...logLevelArg
 	},
 	async run(ctx) {
-		const { connectRunner } = await import("./commands-Hx6XpJx7.js");
+		const { connectRunner } = await import("./commands-DZgyEg0r.js");
 		await connectRunner(ctx);
 	}
 });
 //#endregion
 //#region src/commands/studio/login.ts
-const command$6 = define({
+const command$7 = define({
 	name: "login",
 	description: "Pair this machine with Kubb Studio without connecting.",
 	examples: ["kubb studio login", "kubb studio login --url http://localhost:3000"].join("\n"),
 	toKebab: true,
-	args: command$7.args,
+	args: command$8.args,
 	async run(ctx) {
-		const { loginRunner } = await import("./commands-Hx6XpJx7.js");
+		const { loginRunner } = await import("./commands-DZgyEg0r.js");
 		await loginRunner(ctx);
 	}
 });
 //#endregion
 //#region src/commands/studio/logout.ts
-const command$5 = define({
+const command$6 = define({
 	name: "logout",
 	description: "Forget the stored Kubb Studio token.",
 	examples: ["kubb studio logout"].join("\n"),
@@ -265,13 +319,13 @@ const command$5 = define({
 		...logLevelArg
 	},
 	async run(ctx) {
-		const { logoutRunner } = await import("./commands-Hx6XpJx7.js");
+		const { logoutRunner } = await import("./commands-DZgyEg0r.js");
 		await logoutRunner(ctx);
 	}
 });
 //#endregion
 //#region src/commands/studio/snapshot.ts
-const command$4 = define({
+const command$5 = define({
 	name: "snapshot",
 	description: "Generate and publish a Kubb Studio snapshot from CI.",
 	examples: ["kubb studio snapshot", "kubb studio snapshot --json"].join("\n"),
@@ -305,19 +359,19 @@ const command$4 = define({
 		...logLevelArg
 	},
 	async run(ctx) {
-		const { runner } = await import("./snapshot-B0piE_yD.js");
+		const { runner } = await import("./snapshot-BdP6LpUP.js");
 		await runner(ctx);
 	}
 });
 //#endregion
 //#region src/commands/studio/background.ts
-const command$3 = define({
+const command$4 = define({
 	name: "start",
 	description: "Keep this project connected to Kubb Studio in the background.",
 	toKebab: true,
-	args: command$7.args,
+	args: command$8.args,
 	async run(ctx) {
-		const { startRunner } = await import("./commands-Hx6XpJx7.js");
+		const { startRunner } = await import("./commands-DZgyEg0r.js");
 		await startRunner(ctx);
 	}
 });
@@ -325,13 +379,13 @@ const stopCommand = define({
 	name: "stop",
 	description: "Stop this project's background connection and keep its pairing.",
 	async run() {
-		const { stopRunner } = await import("./commands-Hx6XpJx7.js");
+		const { stopRunner } = await import("./commands-DZgyEg0r.js");
 		await stopRunner();
 	}
 });
 //#endregion
 //#region src/commands/studio/status.ts
-const command$2 = define({
+const command$3 = define({
 	name: "status",
 	description: "Show the project worker, Kubb Studio pairing, and saved permissions.",
 	examples: ["kubb studio status"].join("\n"),
@@ -343,13 +397,13 @@ const command$2 = define({
 		...logLevelArg
 	},
 	async run(ctx) {
-		const { statusRunner } = await import("./commands-Hx6XpJx7.js");
+		const { statusRunner } = await import("./commands-DZgyEg0r.js");
 		await statusRunner(ctx);
 	}
 });
 //#endregion
 //#region src/commands/studio/index.ts
-const command$1 = define({
+const command$2 = define({
 	name: "studio",
 	description: "Connect this project to Kubb Studio, or manage its pairing and snapshots.",
 	examples: [
@@ -361,19 +415,19 @@ const command$1 = define({
 		"kubb studio snapshot"
 	].join("\n"),
 	toKebab: true,
-	args: command$7.args,
+	args: command$8.args,
 	async run(ctx) {
-		const { connectRunner } = await import("./commands-Hx6XpJx7.js");
+		const { connectRunner } = await import("./commands-DZgyEg0r.js");
 		await connectRunner(ctx);
 	},
 	subCommands: {
-		start: command$3,
+		start: command$4,
 		stop: stopCommand,
-		connect: command$7,
-		login: command$6,
-		logout: command$5,
-		status: command$2,
-		snapshot: command$4
+		connect: command$8,
+		login: command$7,
+		logout: command$6,
+		status: command$3,
+		snapshot: command$5
 	}
 });
 /**
@@ -390,6 +444,38 @@ function routeStudioFlags(args) {
 	];
 }
 //#endregion
+//#region src/commands/update.ts
+const command$1 = define({
+	name: "update",
+	description: "Update installed extensions to the version the Kubb registry pins. Pass ids to update only those, or --check to list the updates without installing.",
+	examples: [
+		"kubb update",
+		"kubb update --check",
+		"kubb update plugin-zod plugin-ts --yes"
+	].join("\n"),
+	args: {
+		ids: {
+			type: "positional",
+			description: "Registry ids to update, all installed extensions when omitted",
+			multiple: true
+		},
+		check: {
+			type: "boolean",
+			description: "List the available updates without installing them",
+			default: false
+		},
+		...yesArg
+	},
+	async run({ values }) {
+		const { run } = await import("./run-B9wWJSSx.js");
+		await run({
+			ids: values.ids ?? [],
+			check: values.check,
+			yes: values.yes
+		});
+	}
+});
+//#endregion
 //#region src/commands/validate.ts
 /** The runner is imported when the command runs, so listing `kubb --help` never loads `@kubb/adapter-oas`. */
 const command = define({
@@ -402,7 +488,7 @@ const command = define({
 		required: true
 	} },
 	async run({ values }) {
-		const { run } = await import("./run-BeptvKTj.js");
+		const { run } = await import("./run-D9QTeOsm.js");
 		await run({ input: values.input });
 	}
 });
@@ -457,23 +543,25 @@ function stripExecArgs(argv) {
 }
 /**
 * Entry point for the `kubb` CLI. Prints the telemetry notice unless telemetry is disabled or a
-* quiet flag is passed, then runs the generate, validate, mcp, studio, and init commands. Defaults to
-* `generate` when no command is given.
+* quiet flag is passed, then runs the given command, or `generate` when none is given.
 */
 async function run(argv = process.argv) {
 	const args = routeStudioFlags(resolveDeprecatedFlags(stripExecArgs(argv)));
 	const isQuietFlag = args.some((arg) => QUIET_FLAGS.has(arg));
 	if (!isDisabled() && !isQuietFlag) console.error(`${styleText("yellow", "Notice:")} Kubb collects anonymous telemetry data to help improve the tool. No personal data or file contents are collected. \nTo disable, set ${styleText("cyan", "KUBB_DISABLE_TELEMETRY=1")}.\n`);
-	await cli(args, command$10, {
+	await cli(args, command$12, {
 		name: "kubb",
 		version,
-		description: "Generate code from an OpenAPI specification, or connect the project to Kubb Studio.",
+		description: "Generate code from an OpenAPI specification, manage Kubb extensions, or connect the project to Kubb Studio.",
 		subCommands: {
-			generate: command$10,
-			init: command$9,
+			generate: command$12,
+			init: command$11,
 			validate: command,
-			mcp: command$8,
-			studio: command$1
+			mcp: command$9,
+			studio: command$2,
+			add: command$13,
+			update: command$1,
+			list: command$10
 		},
 		fallbackToEntry: true,
 		strict: true,