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.

Say that a server's folder stays while its port is in use

Țugui Dragoșb596aa1410b4
diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md
index f5aaaf12..4a65d3b8 100644
--- a/ARCHITECTURE.md
+++ b/ARCHITECTURE.md
@@ -406,9 +406,9 @@ macOS asks the user to approve it once. It talks to the app over XPC.
entry: each workspace Xcode built in DerivedData, each archive, an editor's state for a project that is gone, and
the versions an installer keeps beside the one it runs. `Location.isRecommended` is what Peel suggests: build data,
downloads, caches, and logs, once measured and not held back (a secret inside, a clone of another repository, a
- recent write where a server may still use it, a workspace that may still be in use), and `peel caches` gives each
- other row's reason by the same rule. Nothing moves while one of the tool's apps runs (`runningApp`), and a folder in
- the temporary folder that a program holds open isn't listed.
+ recent write or a listening port where a server may still use it, a workspace that may still be in use), and
+ `peel caches` gives each other row's reason by the same rule. Nothing moves while one of the tool's apps runs
+ (`runningApp`), and a folder in the temporary folder that a program holds open isn't listed.
- **Background Items.** `BackgroundItems.scan` reads the job files in `~/Library/LaunchAgents`,
`/Library/LaunchAgents`, and `/Library/LaunchDaemons`, and asks launchd which jobs are loaded, in the GUI domain, the
user's own, and the system's, and which it keeps disabled (`launchctl print-disabled`). A loaded job no file there
diff --git a/GUIDE.md b/GUIDE.md
index 0ca37cda..7d4d13aa 100644
--- a/GUIDE.md
+++ b/GUIDE.md
@@ -167,9 +167,9 @@ copied from your devices, model weights, installed packages and the stores your
pnpm's and Dart's, what a tool keeps for you to install again (Vagrant boxes, Asset Store packages, Godot's export
templates), an editor's saved state for a project that no longer exists, the build data of an Xcode project opened in
the last week or whose last opening Xcode didn't record, a folder in DerivedData that is neither a cache Xcode names
-nor one it made for a workspace, a Spring Boot server's folder written to in the last 15 minutes, a folder Peel
-couldn't measure, a copy of CocoaPods' specs that didn't come from CocoaPods, and a cache with a wallet, a signing key,
-or a password database inside. Nothing is selected for you.
+nor one it made for a workspace, a Spring Boot server's folder written to in the last 15 minutes, or the newest one
+while something still listens on its port, a folder Peel couldn't measure, a copy of CocoaPods' specs that didn't come
+from CocoaPods, and a cache with a wallet, a signing key, or a password database inside. Nothing is selected for you.
**Build Artifacts:** what builds left in the folders you choose, like `node_modules`, `DerivedData`, `target`, `.nuxt`,
`__pycache__`, Unity's `Library`, and any folder its tool tagged as a cache (`CACHEDIR.TAG`), each only when a file of
diff --git a/SAFETY.md b/SAFETY.md
index 8f7faf94..d779426a 100644
--- a/SAFETY.md
+++ b/SAFETY.md
@@ -394,7 +394,7 @@ Never selected for you, even when found:
container, that something wrote to in the last 15 minutes: Peel knows an open app's caches only by the app's names,
and a program may still be using one under a name of its own, such as an extension that runs without its app. On
the Developer page, the same holds for the folders a Spring Boot server makes in the temporary folder each time it
- starts.
+ starts, and for the newest one while something still listens on its port, however long ago it was written.
- A log in `/opt/homebrew/var/log` that something wrote to in the last 15 minutes: a running service may hold it
open, and moving it would free nothing.
- `/Users/Shared`: it belongs to every account, not just yours.