Brewlight Support
Getting Help
For help with Brewlight, use the support contact channel published with the app.
Include the following when reporting an issue:
- Brewlight version.
- macOS version.
- Apple Silicon Mac model, if relevant.
- Which screen you were using.
- What you expected to happen.
- What happened instead.
Do not include private command history, personal paths, or full installed package lists unless you intentionally choose to share them.
What Brewlight Does
Brewlight helps you browse public Homebrew metadata, inspect a user-selected Homebrew prefix, and understand common Homebrew maintenance actions.
Mac App Store Brewlight
The Mac App Store version is preview and copy only. It can inspect your selected Homebrew prefix in read-only mode and generate command text for manual Terminal use.
The Mac App Store version does not run brew, install packages, update packages, uninstall packages, clean files, control services, request administrator privileges, install helper tools, or modify your Homebrew installation.
Brewlight Direct
Brewlight Direct is the separate download published from xsampedro.com. Version 0.1.1 build 1 can run approved local Homebrew commands from the Homebrew prefix you select in the app.
Brewlight Direct still does not require an account, does not include telemetry by default, does not request root or administrator privileges, does not install helper tools, and does not behave as an installer for system components.
The first Direct release does not include auto-update. To update Brewlight Direct, download a newer release from xsampedro.com when one is published.
Before Running Direct Commands
Review each Direct action before approving it. Commands run locally using your selected Homebrew prefix and the permissions available to your normal macOS user account.
If a Homebrew action itself asks for additional confirmation in Terminal or through macOS, follow Homebrew's prompt only if you understand the change.
Local Data Controls
You can clear Brewlight local data from the app:
- Clear command history from History or Settings.
- Clear Direct execution history from History or Settings when available.
- Clear cached metadata from Settings.
- Reset the selected Homebrew prefix from Settings or the Dashboard prefix controls.
- Reset onboarding from Settings.
These actions affect Brewlight's local app data only.
Homebrew Support
Brewlight is not affiliated with Homebrew. For Homebrew itself, package formulae, casks, taps, or command-line behavior, use Homebrew's official documentation and support resources.