hermes uninstall Command — Complete Reference & Examples

Overview

hermes uninstall removes Hermes Agent from your system. By default it keeps your configs and data so you can reinstall later and pick up where you left off.

hermes uninstall

Options

Common Scenarios

Standard Uninstall (Keep Data)

hermes uninstall
# Removes Hermes but keeps your configs and data
# You can reinstall later and continue where you left off

Preview Before Removing

hermes uninstall --dry-run
# Shows exactly what would be removed without changing anything

Full Removal

hermes uninstall --full
# Removes everything, including configs and data
# Prompts for confirmation before proceeding

Uninstall Only the Desktop GUI

hermes uninstall --gui
# Removes the desktop Chat GUI only — the agent stays intact

GUI Summary for Automation

hermes uninstall --gui-summary
# Prints a JSON summary of installed GUI/agent artifacts and exits
# Used by the desktop app to decide which uninstall options to offer

Scripted Cleanup

hermes uninstall --full --yes
# Non-interactive full removal — useful for CI/automation
# No confirmation prompts

Tips

• Run --dry-run first to review exactly what will be removed
• Without --full, your configs and data are preserved
• --gui only affects the desktop Chat GUI — the agent remains installed
• --gui-summary is designed for the desktop app, not interactive use
• Use --yes only in automated environments — double-check before a real uninstall