Skip to content
Commands

kubb update

The update command moves installed Kubb extensions to the version the Kubb extension registry pins, or lists the available updates with --dry-run.

kubb update moves installed extensions to the version the registry pins. It shows each version change, asks which updates to install, installs them, then offers to generate again. It never changes kubb.config.ts and never downgrades.

Ids, versions, and project files work as in Extension commands.

Terminal
kubb update                              # check every installed extension
kubb update --dry-run                    # list updates, install nothing
kubb update plugin-zod plugin-ts --yes   # two extensions, no prompt

Arguments

ArgumentWhat it does
[ids...]The registry ids to update. Without ids, it checks every installed extension the registry lists.

Pick the updates

Output
◇  Checked 3 extensions against the registry
│  Extension         Current  Latest
│  @kubb/plugin-ts   5.0.0    5.2.0       minor
│  @kubb/plugin-zod  5.2.0    6.0.0       major · breaking
│  @kubb/plugin-msw  5.4.2    up to date
│
◆  Select the updates to install
│  ◼ @kubb/plugin-ts (5.0.0 → 5.2.0)
│  ◻ @kubb/plugin-zod (5.2.0 → 6.0.0)
│  ↑/↓ to navigate • Space: select • Enter: confirm
  • Minor and patch updates start selected.
  • A major starts unselected unless you named its id, since it can break the generated code.
  • After the install, it asks whether to generate again, since that rewrites the generated files.

Which extensions it updates

An extension gets an update when its installed version is older than the pinned one, or when package.json lists it but it is not installed. Kubb skips an update that does not support your Kubb or Node.js version and prints Skipped <id>: <reason>. See Command output.

Options

FlagAliasDefaultWhat it does
--yes-yfalseSkip the prompts. Installs every update except majors you did not name, and does not regenerate.
--dry-runfalseList the updates, then stop. Nothing changes.
Pass --yes in scripts and CI, where no one can answer the prompt.

Exit codes

CodeWhen
0The updates are installed, nothing is outdated, or you canceled a prompt. Also when the generation after the install fails.
1An id is malformed (nothing updates) or not installed (the other ids still update), a named extension's update is not compatible, the registry cannot be read, or the install fails.

Less common cases

Command output

After the install, kubb update finds the config like kubb generate and asks whether to generate again. The summary lists installed and skipped packages and changed files.

CaseResult
An update does not support your Kubb or Node.js versionSkipped with Skipped <id>: <reason>.
A named id matches no installed extension<id> is not installed, or not in the registry. Other ids still update, and the exit code is 1.
Nothing is outdatedThe summary says Already up to date.
The generation after the install failsThe summary says Extensions updated; generation failed, and the exit code stays 0.