How to Uninstall Heptabase on Mac

Before removing Heptabase, use Settings › Backup › Export now and open the resulting ZIP. The Markdown is portable, while the archive also includes Heptabase-specific backup data; neither was exercised in the recorded unsigned-in test. The recorded test used a direct download, not a Homebrew installation.

Remove the app and inspect its data

Quit Heptabase and move Heptabase.app from Applications to Trash. Inspect local preferences and any project-meta support folder before deciding whether it is safe to clear. The cask zap currently names preferences and saved state, but not the separately observed project-meta folder. The folder is not proven to be the only workspace copy. Vendor guidance.

Check the result

ls -ld ~/Library/'Application Support'/project-meta ~/Library/Preferences/app.projectmeta.projectmeta.plist

Run this read-only check after quitting the app. A printed path still exists; “No such file or directory” means that path is absent, while a permission error needs its own investigation.

If you installed it with Homebrew

The Homebrew cask has a zap list that includes preferences and saved state, not the separately observed project-meta folder. Run the command below without --zap if you want to keep those files and inspect them separately. A manual --zap follows the whole cask list regardless of Mole’s checkboxes. Mole uses zap only when its targets are selected, owned and within the checked boundary; otherwise it removes selected remnants through its own flow.

brew uninstall --cask heptabase

What Mole lists

The exact Application Support/project-meta leaf is listed for review and unselected by default; bundle-ID preferences are normally selected. Do not infer cloud preservation from a first-run scan.

What this test covered

The official 1.111.0 archive was copied and removed on September 20, 2026. At the time, the uninstall review showed only preferences and temporary cache. A separate disk check found Application Support/project-meta, which stayed on disk; the current scanner lists that exact folder for review. No sign-in, whiteboard or export was tested.