HostBar
Help
Install
Download HostBar.dmg, drag HostBar to Applications, and open it. HostBar lives in the menu bar; there is no Dock icon. With Homebrew: brew tap suresk/tap && brew install --cask suresk/tap/hostbar.
Why HostBar needs a helper
Overrides live in /etc/hosts, which only root can edit. HostBar installs a small helper that runs as root and can do exactly two things: replace the HostBar block in /etc/hosts, and tell mDNSResponder to drop its cache. It refuses connections from anything that is not HostBar's signed binary. Everything outside the block, including your own entries, is never touched.
Installing and approving the helper
The first time you open HostBar it asks to install the helper. macOS shows an admin password prompt, then a banner in System Settings › General › Login Items & Extensions where the helper must be allowed. HostBar's menu shows "Helper off" until it is. If an update changes the helper, HostBar asks to reinstall it.
Profiles
A profile is a named set of overrides: an address and one or more hostnames per line, switched on and off together. Create one in the HostBar window (⌘N), add entries, and flip the switch. The block HostBar writes is marked with # >>> HostBar managed block. Do not edit; changes are overwritten. >>> and # <<< HostBar managed block <<< lines, with a summary line saying which profiles are on and when they expire.
Expiry
Every profile expires eight hours after you turn it on unless you pick 1, 4, or 24 hours, a custom number, or Never. When it expires HostBar turns it off, rewrites the file, and posts a notification. Expiry runs while HostBar is running: it also checks at launch, on wake, and when the clock changes, so an override that expired while your Mac was asleep is removed when it wakes. Turn on Launch at login in Settings if you want that to hold across reboots.
Quitting with overrides on
If profiles are on when you quit, HostBar asks whether to turn them off or keep them. Choose "Remember my choice" to skip the question next time; change it later in Settings.
When another tool edits the file
HostBar watches /etc/hosts. If the block changes outside HostBar, the menu bar icon shows a warning and a banner offers Reapply (write the block again from your profiles) or Adopt (treat the file as the truth and mark profiles whose lines are gone as off).
Resolve panel
Type a hostname and HostBar shows the whole chain: any hosts-file match (and which profile put it there), what macOS itself answers, and what every DNS server your Mac is configured to use answers, grouped by the resolver that would be asked: the default, split-DNS resolvers from a VPN, and /etc/resolver files. The verdict at the top explains disagreements. Copy Summary puts a plain-text version on the clipboard for a bug report.
Flush DNS cache
The Flush button in the menu asks the helper to send mDNSResponder a HUP, which is what sudo killall -HUP mDNSResponder does. Hosts-file changes normally take effect without it; use it when a cached DNS answer is in the way.
License
The 14-day trial is unrestricted. After it ends you can still see everything and turn profiles off; turning profiles on and flushing need a license. Buy one at polar.sh, then paste the key into HostBar › License… One key activates three Macs; free one from the customer portal. A license includes a year of updates; after that the app keeps working and a renewal is $9/year.
Keyboard shortcut
Settings can enable ⌃⌥H to open the menu from anywhere.
Uninstalling
Turn your profiles off first so the block is removed from /etc/hosts. Then HostBar › Settings › Uninstall helper, quit HostBar, and drag it to the Trash. With Homebrew, brew uninstall --cask hostbar unloads the helper's launchd job; use HostBar › Settings › Uninstall helper first so its registration is removed as well. brew uninstall --zap also removes preferences and ~/Library/Application Support/HostBar.
Something else?
Email support@gethostbar.com. Include the Copy Summary text if it is about resolution.