Skip to content

Uninstalling

Alan Wizemann edited this page Apr 20, 2026 · 5 revisions

Uninstalling

Scarf is a self-contained .app bundle with no installers, launch agents, or kernel extensions. Removing it is two steps; cleaning up its caches is one more.

Quit and remove the app

  1. Quit Scarf (⌘Q).
  2. Drag Scarf.app from /Applications to the Trash.

That's the minimum. Scarf is gone.

Clean up Scarf's caches and prefs

If you want a complete uninstall, also remove:

rm -rf ~/Library/Caches/scarf            # remote SQLite snapshots, ssh ControlMaster sockets
rm -f  ~/Library/Preferences/com.scarf.app.plist   # app preferences + server registry

The cache holds atomic SQLite snapshots pulled from remote Hermes hosts and SSH ControlMaster sockets — both are safe to delete; Scarf rebuilds them on demand.

What Scarf does NOT touch

Scarf reads Hermes's data; it does not own it. The following are not removed by uninstalling:

  • ~/.hermes/ — your Hermes install, sessions, memory, config, etc.
  • ~/.ssh/ — SSH keys and config used to reach remote servers.
  • ~/.local/bin/hermes (or wherever your hermes CLI lives).

To uninstall Hermes itself, follow the Hermes documentation — that's a separate process.

What about the wiki?

Just for completeness: the GitHub wiki at https://github.com/awizemann/scarf/wiki is a separate git repo from the main one. Uninstalling the app has no effect on the wiki.


Last updated: 2026-04-20 — Scarf v2.0.1

Clone this wiki locally