| name | minervia-update |
| description | Update Minervia to the latest version while preserving your customizations. Creates backups, shows what's new, lets you choose how to handle conflicts. Use when you want the latest skills and improvements. |
| use_when | User wants to update Minervia, get latest skills, check for updates, or upgrade their installation. |
| allowed_tools | Bash, Read |
Update Minervia
Check for updates and apply them safely while preserving your customizations.
Why This Matters
Minervia evolves with new skills, bug fixes, and improvements. The update system:
- Detects files you've customized (via checksum comparison)
- Preserves your changes unless you choose to overwrite
- Creates backups before any modifications
- Shows what's new between versions
Quick Start
Run the update:
bash ~/.minervia/bin/minervia-update.sh
Or preview changes first:
bash ~/.minervia/bin/minervia-update.sh --dry-run
What Happens During Update
- Version check - Compares installed version to latest on GitHub
- Changelog - Shows what's new since your version
- Customization scan - Identifies files you've modified
- Conflict resolution - For each customized file, you choose:
- Keep mine (skip this file)
- Take theirs (use new version)
- Backup + overwrite (save yours, use new)
- Backup - Creates timestamped backup of all tracked files
- Update - Applies changes to non-customized files
- Report - Shows what was updated
Options
| Flag | Effect |
|---|
--dry-run | Show what would change without applying |
-v, --verbose | Show detailed file-by-file actions |
--list-backups | Show available backups |
--restore TIMESTAMP | Restore from a specific backup |
Backups
Backups are stored in ~/.minervia/backups/ with timestamped folders:
2026-01-18T10-30-00/ contains all tracked files as of that update- Backups are kept forever (no auto-pruning)
To restore from a backup:
bash ~/.minervia/bin/minervia-update.sh --restore 2026-01-18T10-30-00
Process for Claude
- Check if update script exists:
ls ~/.minervia/bin/minervia-update.sh
- If missing, inform user to reinstall Minervia
- Run update with appropriate flags based on user request
- Report results to user
Success Criteria
