Skip to content
bayesianhunterPublic

About

Halo for Mac is a free, open-source menu bar app: reverse mouse scrolling while the trackpad stays natural, see peripheral batteries, keep Bluetooth speakers off the microphone, and share devices and clipboard across two Macs with Universal Control. Your AI agent can use it too.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Halo for Mac

Halo

Everything you connect, looked after.

Halo for Mac is a free, open-source menu bar app. Reverse your mouse while your trackpad stays natural, see your peripherals’ batteries, and keep scrolling settings and your clipboard in step across two Macs, from the menu bar or from your AI agent.

brew install --cask bayesianhunter/tap/halo

macOS 26+ · Apple silicon · GPL-3.0 · Download

halo-github.mp4

On your Mac

Scrolling that feels right. Reverse your mouse and keep your trackpad natural. Set each device separately, with 0.5×–4× speed for mouse wheels. Works in iPhone Mirroring too.

Batteries at a glance. See the charge of your mouse, keyboard, trackpad and Bluetooth audio, with time-left estimates where available.

Halo’s menu-bar ring: normal, low battery in red, and charging in green.

Speakers stay speakers. Keep macOS from using your Bluetooth speaker as the microphone, so music stays at full quality.

Across two Macs

Halo recognizes the mouse and trackpad that Universal Control brings to the other Mac, with a separate scrolling rule for each.

Two cropped desktop views of Halo, without device frames. The Air recognizes the Pro’s mouse and shows the shared clipboard link.

Pair Halo on both Macs to see each other’s devices, sync scrolling settings, and let text and images follow your pointer.

Pair two Macs
  1. Install Halo on both Macs and keep them on the same network.
  2. Choose Pair… on both. Leave the sharing options you want selected.
  3. Compare the six digits. If they match, click Match on both.

If the digits differ, choose Don’t Match.

Both Macs show the same six digits. After pairing, scrolling-settings sync and clipboard sharing can be switched on or off.

Know what happened

When a peripheral stops behaving, ask your coding agent. Halo gives it live diagnostics, 30 days of events, and checks it can run on demand.

You askHalo provides
What happened to my mouse?Connection and Universal Control events.
Why is my speaker cutting out?A check of the Bluetooth audio link.
Why can’t my Macs connect?A connection check between the paired Macs.

Your agent can also change scrolling direction, wheel speed and the speaker microphone rule. Halo shows a notification for every change.

Add the Agent Skill from Diagnostics, or copy a diagnostics summary into your chat.

Agent commands
halo --diagnostics
halo --events --since 1h
halo --diagnostics --audio-check
halo --diagnostics --link-check
halo --set speed <id> 1.5

Get started

Install with Homebrew above, or download the app from Releases.

  1. Open Halo. Allow it in System Settings → Privacy & Security → Accessibility.
  2. Turn on Reverse for the mouse or trackpad you want to change. Everything starts unchanged.
Set up with your coding agent

Copy this request into your agent:

Install Halo from https://github.com/bayesianhunter/halo
(brew install --cask bayesianhunter/tap/halo).
Open the app and ask me to allow Accessibility access.
Wait for me to confirm it is allowed.
Link /Applications/Halo.app/Contents/Resources/AgentSkill as halo in your
skills folder (~/.claude/skills or ~/.agents/skills), then read its SKILL.md.
If a halo skill is already there, ask me first.
Run halo --diagnostics and show me the devices before changing any settings.

Clean in, clean out

Halo keeps its data in one folder, ~/Library/Application Support/Halo, beside its preferences and the caches macOS keeps for every app. It doesn’t start at login unless you turn that on, and it links the Agent Skill only when you ask.

Settings → General → Uninstall Halo… lists everything Halo has put on your Mac, then takes it all away: it unpairs (telling the other Mac if it’s connected), deletes the pairing key, turns off Open at Login, removes its Agent Skill links, moves its files and the app to the Trash, and quits. Anything it couldn’t remove, it tells you. macOS keeps its own lists in Privacy & Security and Notifications until you remove Halo there, so Halo opens Privacy & Security on its way out.

Installed with Homebrew? Uninstall in Halo, then run brew uninstall --cask halo. halo --uninstall prints the same list without removing anything.

FAQ

How do I reverse mouse scrolling but keep the trackpad natural on a Mac?

macOS has one Natural scrolling setting, shared by every mouse and trackpad. Halo sets each device separately: turn on Reverse for your mouse and leave the trackpad unchanged.

How do I keep different scroll directions for my mouse and trackpad with Universal Control?

With Universal Control, the mouse and trackpad from your other Mac arrive as separate devices. Halo recognizes them and gives each its own rule, so the mouse stays reversed and the trackpad natural on whichever Mac the pointer is on. Pair the two Macs to keep these settings in sync.

Why does my Bluetooth speaker suddenly sound bad on my Mac?

A Bluetooth speaker used as a microphone drops to call quality for as long as anything records. macOS can make a speaker the microphone when it reconnects; Halo switches the input back to the Mac’s own microphone. If an app picks the speaker’s microphone itself, Halo can’t change that, but it tells you, naming the app when it can.

How can I see the battery of my mouse, keyboard and trackpad on a Mac?

Halo shows the charge of mice, keyboards, trackpads and Bluetooth audio devices that report a battery, in its menu. It also reads the standard Bluetooth Low Energy battery of mice and keyboards, such as the Logitech MX Master 2S we test with. For devices that report fine-grained levels, it estimates the time left after a day of readings.

Can my AI agent check or change my peripherals?

Yes. Halo includes an Agent Skill and a halo command. Your agent can read live diagnostics and 30 days of events, run Bluetooth audio and connection checks, and change scrolling direction, wheel speed and the speaker microphone rule. Halo shows a notification for every change.

Which Macs does Halo run on?

macOS 26 or later on Apple silicon. Halo is free and open source under GPL-3.0.

Feedback

Something not right, or an idea? Open an issue, or email milky.eggy.app@gmail.com. In Halo, Settings → About → Send Feedback… starts either one with your Halo and macOS versions written in, and clicking the version at the top of the menu copies them.

Privacy

Halo talks only to the Mac you pair with and, if you allow it, checks halo.liuzhekan.com for updates once a day. No keystrokes, screen content or microphone audio is recorded. Shared clipboard contents stay in memory, not in a history on disk. Security and privacy details.

Build from source

Requires Xcode 26 or later.

scripts/build-app.sh --install
swift test --disable-sandbox

Contributing · Security · Changelog

The idea of identifying each scroll by its HID sender came from Scroll Reverser by Nick Moore (Apache-2.0). Updates by Sparkle (MIT; license text in the app).

© 2026 Beijing Bayesian Hunter Technology Co., Ltd · GPL-3.0

About

Halo for Mac is a free, open-source menu bar app: reverse mouse scrolling while the trackpad stays natural, see peripheral batteries, keep Bluetooth speakers off the microphone, and share devices and clipboard across two Macs with Universal Control. Your AI agent can use it too.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages