Uninstall

Herald does not install a background service unless you explicitly run or configure one. Homebrew installs the release binaries on macOS; source checkouts create local build outputs.

Remove Homebrew install

brew uninstall herald

For a full tap reset before reinstalling:

brew untap herald-email/herald
brew tap herald-email/herald
brew install herald

Remove build outputs

From the repository root:

make clean

Or remove binaries manually:

rm -rf bin/

Remove config

Default config:

rm -f ~/.herald/conf.yaml

If you used custom config files, remove those paths too.

Remove cache files

Check cache.database_path in your config before deleting it. Generated cache files usually live under ~/.herald/cached/.

rm -rf ~/.herald/cached/

If you used a custom cache path, remove that file directly.

Remove logs

macOS:

rm -rf ~/Library/Logs/Herald

Linux/BSD:

rm -rf "${XDG_STATE_HOME:-$HOME/.local/state}/herald/logs"

Windows PowerShell:

Remove-Item -Recurse -Force "$env:LOCALAPPDATA\Herald\Logs"

Remove MCP client config

If you added Herald as an MCP server to Claude Code, Cursor, Windsurf, Codex, or another client, remove that client-side entry separately. Herald cannot remove tool registrations from external clients automatically.