Skip to content

mold upgrade

Update kit files to the latest version.

Usage

mold upgrade [flags]

Description

Reads .mold.toml to determine which kit, stack, and tools were used when the project was created, then compares each file against the latest embedded templates. User-modified files are preserved unless --force is used.

Flags

Flag Default Description
--dry-run false Preview changes without writing
--force false Overwrite user-modified files

Examples

Preview what would change:

mold upgrade --dry-run
Upgrade plan (dry run):

  = CLAUDE.md (unchanged)
  ~ .claude/settings.json (updated)
  + .claude/commands/refactor.md (new)
  ! docs/TODO.md (skipped — user-modified, use --force to overwrite)

Apply the upgrade:

mold upgrade

Force-overwrite modified files:

mold upgrade --force

Status indicators

Symbol Meaning
= File is unchanged, nothing to do
~ File will be updated to the latest template
+ New file that didn't exist before
! Skipped because the file was modified by the user

Requirements

The current directory must contain a .mold.toml file, which is created automatically by mold new. Projects created with mold init also get this file.

See also