Upgrading & Uninstalling

Upgrading

warden update

This checks for new versions, shows a changelog summary, asks for confirmation, downloads the update, and restarts the server. Configuration, session data, and learned patterns are preserved across upgrades.

To skip the confirmation prompt:

warden update --yes

To check without installing:

warden update --check

Post-Upgrade Verification

warden version           # Should show new version
warden server-status     # Should show "running"
warden doctor            # Full health check

If the server version doesn’t match after an update:

warden server-restart

Rollback

If an upgrade introduces a problem:

warden update --rollback

This swaps to the previous version and restarts the server. One level of rollback is supported — for older versions, download from the releases page.

Version Compatibility

Session data is backward-compatible across minor versions. Rule files are forward-compatible: rules written for older versions continue to work on newer versions.

Uninstalling

warden uninstall

This removes hook registrations, stops the server, and optionally deletes all Warden data (~/.warden/). Your AI assistant will continue to work normally — it just won’t have Warden’s protection.