Skip to main content
grindxp uninstall [--all] [--gateway] [--web] [--vault] [--yes] [--dry-run]
Without flags, an interactive multiselect lets you choose which components to remove. Pass explicit flags to skip the prompt.

Flags

FlagDescription
--allSelect all scopes (gateway, web, vault)
--gatewayStop the gateway process and remove its autostart service (launchd / systemd / schtasks)
--webStop the background web app process
--vaultDelete ~/.grind/ (removes the vault DB, config, encryption key, and all data)
--yes / -ySkip the confirmation prompt
--dry-runPrint what would be removed without making any changes

What Gets Removed

ScopeWhat is removed
gatewayRunning gateway process (SIGTERM → SIGKILL) + autostart service registration
webRunning web app process (SIGTERM → SIGKILL)
vault~/.grind/: vault DB, config, encryption key, timer state, auth tokens, service state files
The CLI binary itself is not removed. After uninstalling, remove it manually:
rm -rf ~/.grind/bin/
--vault deletes your vault, encryption key, and all quest data permanently. Back up ~/.grind/vault.db and ~/.grind/config.json before running if you want to preserve your data.