Underhood Support

What can Underhood do?

• LaunchAgent management — browse the services in ~/Library/LaunchAgents and everything launchctl reports, then load, unload, start, stop, or restart them. You can edit a service with a visual form or edit its raw plist.
• Disk cleanup — scan common developer cache locations (Xcode, package managers, and similar), review what was found, and move the items you select to the Trash.
• Widgets — network info (public IP and region), favorited service status, disk space, reclaimable space, and locally listening development ports.

Where is my data stored?

Everything stays on your Mac. Preferences and favorites are kept in UserDefaults, and a shared local App Group container lets the widgets read data gathered by the main app. There is no account, no login, and nothing is uploaded to a server. See the Privacy Policy for details.

A widget shows stale data, or a dash instead of a value.

The widgets run in a sandboxed extension and cannot gather system data themselves — the main app collects it and shares it locally. If a widget looks out of date, open Underhood once so it can refresh the shared data, then give the widget a moment to reload. macOS also decides when widgets are allowed to refresh, so short delays are normal.

The Network Info widget cannot show my public IP.

The public IP is fetched from free third-party lookup services, which sometimes rate-limit requests. Underhood falls back across several providers and caches the last known result, so this is usually temporary. Check that your Mac is online, then try again in a few minutes.

Is the disk cleanup safe?

Nothing is removed without you selecting it and confirming. Confirmed items are moved to the Trash rather than erased, so you can restore them until you empty the Trash. Cleanup is restricted to a whitelist of known developer cache locations, and symlinks are not followed out of those locations. Some caches will be rebuilt by their tools the next time you use them, which is expected — that is what a cache is for.

A service will not start, or immediately exits.

Open the service in Underhood and check its last exit status, then check the program path and arguments in the editor — a wrong path or a missing executable is the most common cause. If your service depends on tools installed via a shell environment, make sure the required environment variables are set in the service configuration; Underhood can import the variables from your login shell for you. Finally, check the service's own log files at the paths configured in its plist.

Does Underhood have in-app purchases or a subscription?

No. Underhood has no in-app purchases and no subscriptions. If you purchased the app on the App Store and need a refund, purchases are handled by Apple: visit reportaproblem.apple.com and sign in with the Apple Account used for the purchase. As developers we cannot directly refund payments collected by Apple.