Uninstall Mac apps with every file they leave behind, and see why each belongs. Free up space, fine-tune macOS, and set up Terminal.
Swift cache-cleanercleanerclideveloper-toolsdisk-cleanupdisk-spaceduplicate-finderhomebrewliquid-glassmac-cleanermacosmacos-appmacos-golden-gatemacos-tahoemacos-tweaksswiftswiftuiterminal-themesuninstalluninstaller
Keep local servers' databases and AI apps' conversations unselected
Țugui Dragoșbf8d02d5649d
diff --git a/GUIDE.md b/GUIDE.mdindex f57f06f6..1238681c 100644--- a/GUIDE.md+++ b/GUIDE.md@@ -24,8 +24,9 @@ and how to get it, [SAFETY.md](SAFETY.md) what it protects, [PRIVACY.md](PRIVACY- **What may exist nowhere else is left to you.** A folder holding a crypto wallet, a signing key, a password database,or a repository is shown with its reason and not selected, and so is a place where an app keeps what may exist only onthis Mac, such as local mail, message history, sign-in codes, a browser's saved passwords, VPN connections, a torrent- client's list of torrents, a game's saves, a database, a code editor's unsaved files and local history, an app's own- backups, or the sign-in a tool saved when you logged in. Uninstalling Xcode lists the simulators it made the same way.+ client's list of torrents, a game's saves, a database, an AI app's conversations, a code editor's unsaved files and+ local history, an app's own backups, or the sign-in a tool saved when you logged in. Uninstalling Xcode lists the+ simulators it made the same way.- **Shared or guessed, never selected.** A file another installed app also uses is shown but never selected, and afolder holding another installed app's own data, such as Xcode's in `~/Library/Developer`, can't be selected atall, and neither can anything that syncs to your other devices, an app's container holding your documents, or adiff --git a/Packages/PeelCore/Sources/PeelCore/Leftovers/KeptOnlyHere.swift b/Packages/PeelCore/Sources/PeelCore/Leftovers/KeptOnlyHere.swiftindex 514e7011..a4503b1d 100644--- a/Packages/PeelCore/Sources/PeelCore/Leftovers/KeptOnlyHere.swift+++ b/Packages/PeelCore/Sources/PeelCore/Leftovers/KeptOnlyHere.swift@@ -99,6 +99,28 @@ enum KeptOnlyHere {// Postgres.app's "Installing Postgres.app": its default data directory is `Postgres/var-XX`, and deleting the// data directories is an optional step of uninstalling it.("Library/Application Support/Postgres", nil, .holdsWorkMadeWithTheApp),+ // Laravel Herd's "Uninstalling Herd": the Herd Pro services' databases are in `config/services`, to back up+ // before the folder goes.+ ("Library/Application Support/Herd", "config/services", .holdsWorkMadeWithTheApp),+ // Plex's "Where is the Plex Media Server data directory located?" and "Backing up Plex Media Server data": what+ // was watched, the metadata, and the settings in its preferences file.+ ("Library/Application Support/Plex Media Server", nil, .holdsWorkMadeWithTheApp),+ ("Library/Preferences/com.plexapp.plexmediaserver.plist", nil, .holdsWorkMadeWithTheApp),+ // Neo4j Desktop's "Re-installation of Desktop" for 1.x and "Installation" for 2.x: each version keeps its+ // databases in `Application`, to back up before removing it.+ ("Library/Application Support/Neo4j Desktop", "Application", .holdsWorkMadeWithTheApp),+ ("Library/Application Support/neo4j-desktop", "Application", .holdsWorkMadeWithTheApp),+ // UniFi's "How to Uninstall the Self-Hosted UniFi Network Server": a backup first, then this folder.+ ("Library/Application Support/UniFi", nil, .holdsWorkMadeWithTheApp),+ // Jan's "Data Folder": threads, assistants, memories, skills and subagents live there permanently.+ ("Library/Application Support/Jan", "data/threads", .holdsWorkMadeWithTheApp),+ ("Library/Application Support/Jan", "data/assistants", .holdsWorkMadeWithTheApp),+ ("Library/Application Support/Jan", "data/agent-workspace/memory", .holdsWorkMadeWithTheApp),+ ("Library/Application Support/Jan", "data/agent-workspace/skills", .holdsWorkMadeWithTheApp),+ ("Library/Application Support/Jan", "data/agent-workspace/subagents", .holdsWorkMadeWithTheApp),+ // Open WebUI's desktop app runs Open WebUI with its data, the chats among them, in `data`+ // (`src/main/utils/index.ts`).+ ("Library/Application Support/open-webui", "data", .holdsWorkMadeWithTheApp),// Cultured Code's "Completely Uninstalling Things": deleting this group container deletes the to-dos.("Library/Group Containers/JLMPQHK86H.com.culturedcode.ThingsMac", nil, .holdsWorkMadeWithTheApp),// OBS Studio keeps its profiles and scene collections in `obs-studio/basic` in its configuration folder@@ -161,6 +183,8 @@ enum KeptOnlyHere {// inside the app.("Library/Application Support/Tunnelblick", "Shared", .holdsVPNConnections),("Library/Application Support/Tunnelblick", "Backup", .holdsVPNConnections),+ // MAMP PRO's "Uninstall MAMP PRO": uninstalling it removes the databases kept here.+ ("Library/Application Support/appsolute/MAMP PRO", "db", .holdsWorkMadeWithTheApp),]static func reason(for path: String, home: String, root: String) -> HoldBack? {diff --git a/Packages/PeelCore/Tests/PeelCoreTests/KeptOnlyHereTests.swift b/Packages/PeelCore/Tests/PeelCoreTests/KeptOnlyHereTests.swiftindex 28ff5a38..fa6be94f 100644--- a/Packages/PeelCore/Tests/PeelCoreTests/KeptOnlyHereTests.swift+++ b/Packages/PeelCore/Tests/PeelCoreTests/KeptOnlyHereTests.swift@@ -58,6 +58,20 @@ struct KeptOnlyHereTests {("Library/Application Support/Dia", .holdsPasswordsOrCodes),("Library/Application Support/Orion/Defaults/favourites.plist", .holdsWorkMadeWithTheApp),("Library/Application Support/Orion/profiles", .holdsWorkMadeWithTheApp),+ ("Library/Application Support/Herd", .holdsWorkMadeWithTheApp),+ ("Library/Application Support/Herd/config/services/mysql/data", .holdsWorkMadeWithTheApp),+ ("Library/Application Support/Plex Media Server/Plug-in Support/Databases", .holdsWorkMadeWithTheApp),+ ("Library/Preferences/com.plexapp.plexmediaserver.plist", .holdsWorkMadeWithTheApp),+ ("Library/Application Support/Neo4j Desktop/Application/relate-data/dbmss", .holdsWorkMadeWithTheApp),+ ("Library/Application Support/neo4j-desktop/Application/data", .holdsWorkMadeWithTheApp),+ ("Library/Application Support/UniFi/data/db", .holdsWorkMadeWithTheApp),+ ("Library/Application Support/Jan", .holdsWorkMadeWithTheApp),+ ("Library/Application Support/Jan/data/threads/01J0", .holdsWorkMadeWithTheApp),+ ("Library/Application Support/Jan/data/assistants/jan", .holdsWorkMadeWithTheApp),+ ("Library/Application Support/Jan/data/agent-workspace/memory", .holdsWorkMadeWithTheApp),+ ("Library/Application Support/Jan/data/agent-workspace/skills", .holdsWorkMadeWithTheApp),+ ("Library/Application Support/Jan/data/agent-workspace/subagents", .holdsWorkMadeWithTheApp),+ ("Library/Application Support/open-webui/data/webui.db", .holdsWorkMadeWithTheApp),("Library/Application Support/Tunnelblick/Configurations/work.tblk", .holdsVPNConnections),("Library/Application Support/Viscosity", .holdsVPNConnections),("Library/Application Support/Steam", .holdsWorkMadeWithTheApp),@@ -108,6 +122,8 @@ struct KeptOnlyHereTests {("Library/Application Support/Tunnelblick", .holdsVPNConnections),("Library/Application Support/Tunnelblick/Shared/Office.tblk", .holdsVPNConnections),("Library/Application Support/Tunnelblick/Backup/Deployed/Office.tblk", .holdsVPNConnections),+ ("Library/Application Support/appsolute/MAMP PRO", .holdsWorkMadeWithTheApp),+ ("Library/Application Support/appsolute/MAMP PRO/db/mysql80/shop", .holdsWorkMadeWithTheApp),]for (path, reason) in heldOnTheMac {#expect(KeptOnlyHere.reason(for: "/\(path)", home: home, root: "/") == reason, "\(path)")@@ -117,6 +133,10 @@ struct KeptOnlyHereTests {@Test func leavesWhatSitsBesideOrAroundThem() {let free = ["Library/Application Support", "Library/Group Containers", "Library", "Library/Caches/Signal",+ "Library/Application Support/Herd/Log/mail", "Library/Application Support/Herd/bin",+ "Library/Application Support/Jan/data/llamacpp/models", "Library/Application Support/Jan/data/logs",+ "Library/Application Support/Jan/data/agent-workspace/sessions", "Library/Application Support/open-webui/logs",+ "Library/Application Support/Neo4j Desktop/Cache", "Library/Application Support/neo4j-desktop/logs","Library/Application Support/Microsoft Edge/NativeMessagingHosts/org.example.host.json","Library/Application Support/Microsoft Edge Beta/NativeMessagingHosts/org.example.host.json","Library/Application Support/Microsoft", "Library/Application Support/Microsoft/EdgeUpdater",@@ -148,6 +168,7 @@ struct KeptOnlyHereTests {#expect(KeptOnlyHere.reason(for: "\(home)/\(path)", home: home, root: "/") == nil, "\(path)")}let freeOnTheMac = [+ "Library/Application Support/appsolute/MAMP PRO/templates", "Library/Application Support/appsolute","Library/Application Support/ZeroTier/Other", "Library/Application Support/Tunnelblick/Logs","Library/Application Support/Tunnelblick/Users/me", "Library/Application Support/Signal",]diff --git a/SAFETY.md b/SAFETY.mdindex f707b85e..980e4f10 100644--- a/SAFETY.md+++ b/SAFETY.md@@ -413,13 +413,14 @@ Never selected for you, even when found:- A folder with a repository, a wallet, a signing key, or a password database (KeePass's `.kdbx`, KeePassXC's `.keyx`,a 1Password vault kept outside an account, `.opvault` or `.agilekeychain`) inside.- What an app keeps that may exist only on this Mac: local mail, message history, a password manager's vaults and- backups and an authenticator's codes, a browser's saved passwords, VPN connections and identities, a torrent client's- list of torrents, a game's saves, a database, a streaming app's scenes and profiles, an office suite's own templates- and dictionaries, a terminal's scripts and profiles, a code editor's unsaved files, local history, and the packages- you made for it, and the sign-in a tool saved when you logged in, such as Docker's or Cargo's, each where the app's- own documentation or source says it keeps them, and anything named as an app's backups, or the app's folder that keeps- them. When you uninstall Xcode, the simulators it made in your home folder are listed too, with the apps installed in- them and their data, and never selected.+ backups and an authenticator's codes, a browser's saved passwords, VPN connections and identities, a torrent+ client's list of torrents, a game's saves, a database, an AI app's conversations, a streaming app's scenes and+ profiles, an office suite's own templates and dictionaries, a terminal's scripts and profiles, a code editor's+ unsaved files, local history, and the packages you made for it, and the sign-in a tool saved when you logged in,+ such as Docker's or Cargo's, each where the app's own documentation or source says it keeps them, or where its+ Homebrew definition names its folder, and anything named as an app's backups, or the app's folder that keeps them.+ When you uninstall Xcode, the simulators it made in your home folder are listed too, with the apps installed in them+ and their data, and never selected.- A copy Mail keeps of an attachment you opened, which you may have changed.- A file a program has open right now, and a disk image that is open right now.- An installer package an app keeps in Application Support, which the app may still need, and an update whose app is