Skip to content

armgit / peel

Public Imported from GitHub
0

Uninstall Mac apps with every file they leave behind, and see why each belongs. Free up space, fine-tune macOS, and set up Terminal.

Keep local servers' databases and AI apps' conversations unselected

Țugui Dragoșbf8d02d5649d
diff --git a/GUIDE.md b/GUIDE.md
index 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 on
this 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 a
folder holding another installed app's own data, such as Xcode's in `~/Library/Developer`, can't be selected at
all, and neither can anything that syncs to your other devices, an app's container holding your documents, or a
diff --git a/Packages/PeelCore/Sources/PeelCore/Leftovers/KeptOnlyHere.swift b/Packages/PeelCore/Sources/PeelCore/Leftovers/KeptOnlyHere.swift
index 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.swift
index 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.md
index 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