Brewlight Privacy Policy
Summary
Brewlight is a free, local-first macOS companion app for Homebrew. It does not require an account, does not include advertising, does not include telemetry by default, and does not upload your installed package list, command history, or Direct execution history.
The Mac App Store version is preview and copy only. Brewlight Direct is a separate download from xsampedro.com that can run approved local Homebrew commands from the Homebrew prefix you select.
Data Brewlight Stores Locally
Brewlight may store the following data on your Mac:
- Onboarding completion state.
- The selected Homebrew prefix path and security-scoped bookmark, if you choose a prefix.
- Local inventory scan timestamps.
- Cached public Homebrew formula and cask metadata for offline browsing.
- Command history for commands you explicitly copy from preview sheets.
- Brewlight Direct execution history metadata for approved local actions, such as operation type, package target when applicable, selected prefix, status, and time.
This data is stored locally on your Mac and is used to make the app work offline, remember your selected prefix, show recent copied commands, and show recent Direct actions.
Brewlight Direct does not store full command output by default.
Public Metadata Downloads
Brewlight can download public Homebrew formula and cask metadata from Homebrew's public metadata endpoints. These downloads are used for catalog browsing, package details, latest-known version comparisons, and search.
Brewlight does not send your installed package list to Homebrew or to the developer when fetching public metadata.
Local Homebrew Inspection
If you select a Homebrew prefix, Brewlight reads local Homebrew folders in read-only mode to show installed formulae, installed casks, version information, and cleanup guidance.
The Mac App Store version does not run brew, does not install packages, does not update packages, does not remove packages, does not clean files, does not control services, and does not request administrator privileges.
Brewlight Direct Local Execution
Brewlight Direct can run approved local Homebrew commands from the Homebrew prefix you select. Direct actions run locally on your Mac using the permissions available to your normal macOS user account.
Brewlight Direct does not request root or administrator privileges, does not install helper tools, does not install system background services, and has no installer behavior beyond the app download itself.
The first Brewlight Direct release does not include auto-update. Updating Direct requires downloading a newer release from xsampedro.com when one is published.
Command Preview And History
Brewlight generates command text for manual Terminal use. Commands are shown in preview sheets and are copied only when you choose Copy.
When you copy a command, Brewlight records a local command history entry containing the command text, operation type, package target when applicable, source screen, and copy time. Command history is not uploaded and can be cleared from History or Settings.
When you approve a Brewlight Direct action, Direct may record local execution history metadata such as the action type, target, selected prefix, status, and time. Full command output is not stored by default.
Clearing Local Data
Brewlight includes local controls to clear metadata cache, clear command history, reset the selected Homebrew prefix, and reset onboarding. These actions affect Brewlight's local app data only and do not modify your Homebrew installation.
No Tracking Or Accounts
Brewlight v1 does not require an account and does not include default telemetry, analytics, advertising tracking, subscriptions, in-app purchases, or paid unlocks.
External Links
Brewlight may include user-initiated external links, such as links to package homepages or the Homebrew website. External websites are governed by their own privacy policies.
Contact
For privacy questions, use the Brewlight support contact channel published with the app or linked from the Brewlight support page.