Contact

Black Hole is maintained in the open, and nearly every useful conversation about it happens on GitHub. That is deliberate: a question asked in public gets answered once and then helps whoever searches for it next.

Report a bug

Open an issue at github.com/vanshpatelx/blackhole/issues. The things that make a report quick to act on: which version of Black Hole you are running (it is in Settings), which version of macOS, whether your Mac has a notch or you are on an external display, and what you expected to happen instead. Screenshots of the notch area help more than descriptions, because most of what can go wrong is visual.

Request a feature

Also the issue tracker. It helps to describe the moment in your day where the feature would have helped, rather than the feature itself — the underlying problem is usually solvable in more than one way, and the best version is often not the one first imagined.

Security

If you have found something with security implications — anything touching the MCP server, the access token or the tunnel that gives your Mac its public address — please open an issue marked as security, or contact the maintainer privately through GitHub rather than posting details publicly first. Black Hole's MCP endpoint is protected by a per-install token and answers only while the app is running, but we would still rather hear about a weakness early and quietly.

Contributing

Pull requests are welcome. The repository README covers building from source with XcodeGen, and the project runs SwiftLint and SwiftFormat in CI, so running make lint before pushing saves a round trip.