uninstall

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

Flag	Description
`--all`	Select all scopes (gateway, web, vault)
`--gateway`	Stop the gateway process and remove its autostart service (launchd / systemd / schtasks)
`--web`	Stop the background web app process
`--vault`	Delete `~/.grind/` (removes the vault DB, config, encryption key, and all data)
`--yes` / `-y`	Skip the confirmation prompt
`--dry-run`	Print what would be removed without making any changes

What Gets Removed

Scope	What is removed
`gateway`	Running gateway process (SIGTERM → SIGKILL) + autostart service registration
`web`	Running 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/

bun remove -g grindxp

npm uninstall -g grindxp

pnpm remove -g grindxp

# Remove alias from ~/.zshrc or ~/.bashrc
nano ~/.zshrc
# Delete the line: alias grindxp="bun --cwd ~/grind cli"

# Then delete the repo
rm -rf ~/grind

--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.

Installation: how to install Grind
gateway disable: disable autostart without a full uninstall

Commands

Integrations & Automation

Flags

What Gets Removed

​Flags

​What Gets Removed

​Related

Flags

What Gets Removed

Related