kumiko upgrade

kumiko upgrade [--from <version>] [--json] [--verbose]
kumiko upgrade --apply [--dir <path>] [--dry-run] [--from <version>]

Reads changes.json from bundled features plus the framework core and shows what is new since your current (or --from) Kumiko version.

--apply runs the codemod referenced by every pending breaking change’s codemod field (oldest version first), against --dir (default: cwd). Codemod scripts must live under <repo>/scripts/codemod/ — that only works from a checkout that has the framework repo locally (workspace member), not a plain npm install. Writes .kumiko/upgrade-state.json on full success; stops on the first codemod failure without writing it.

Flags

Flag	Meaning
--from <ver>	Override current version (default: auto-detect from node_modules)
--json	Machine-readable output (for agents)
--verbose	Show detail + migration text
--apply	Run pending breaking changes’ codemods instead of reporting
--dir <path>	Target directory for --apply (default: cwd)
--dry-run	With --apply: run codemods without writing files or the marker

Examples

kumiko upgrade
kumiko upgrade --from 0.160.0 --verbose
kumiko upgrade --json
kumiko upgrade --apply --dry-run

See also

• Upgrade Kumiko guide
• kumiko changes — author changelog entries