docs: document update local-change handling

This commit is contained in:
liuyuchen 2026-06-06 22:31:24 +08:00 committed by Teknium
parent 365437e4aa
commit b2b4d97bbb
3 changed files with 40 additions and 0 deletions

View file

@ -1124,6 +1124,27 @@ display:
# hooks_auto_accept: false
# =============================================================================
# Update Behavior
# =============================================================================
updates:
# Create a full HERMES_HOME zip before every `hermes update`.
# Backups land in ~/.hermes/backups/ and can be restored with `hermes import`.
# Off by default because large homes can add minutes to every update.
pre_update_backup: false
# Number of pre-update backup zips to retain.
backup_keep: 5
# What non-interactive updates do with local source edits in the Hermes repo.
# Interactive terminal updates always prompt before restoring the autostash.
#
# stash - auto-stash before pull, then auto-restore after success (default)
# discard - drop the update-created stash after success; use only on managed
# installs where local source edits should not persist
non_interactive_local_changes: "stash"
# =============================================================================
# Web Dashboard
# =============================================================================