rai upgrade
Update an existing RaiSE project to the latest version. Upgrades configuration files, skills, hooks, and schema artifacts to match the installed CLI version. Safe to run repeatedly — changes are idempotent.
| Flag | Short | Description |
|---|---|---|
--path |
-p |
Project path to upgrade. Default: current directory |
--detect |
-d |
Auto-detect project conventions before upgrading |
--dry-run |
Show what would change without applying updates | |
--force |
Overwrite local customizations without prompting | |
--skip-updates |
Skip updating skills and hooks; upgrade config only | |
--skill-set |
Name of skill set to install during upgrade | |
--report-conflicts |
Print a conflict report instead of resolving interactively | |
--no-skills |
Skip skill installation entirely |
# Upgrade the current project
rai upgrade
# Preview changes
rai upgrade --dry-run
# Upgrade with a specific skill set
rai upgrade --skill-set backend
# Upgrade config only, keep existing skills
rai upgrade --skip-updates
# Upgrade from an explicit path
rai upgrade --path /path/to/project
When conflicts are detected between local customizations and the new defaults, rai upgrade prompts interactively unless --force or --report-conflicts is used.
See also: rai init, rai doctor, rai skill