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
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.
Speakers stay speakers. Keep macOS from using your Bluetooth speaker as the microphone, so music stays at full quality.
Halo recognizes the mouse and trackpad that Universal Control brings to the other Mac, with a separate scrolling rule for each.
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
- Install Halo on both Macs and keep them on the same network.
- Choose Pair… on both. Leave the sharing options you want selected.
- Compare the six digits. If they match, click Match on both.
If the digits differ, choose Don’t Match.
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 ask | Halo 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.5Install with Homebrew above, or download the app from Releases.
- Open Halo. Allow it in System Settings → Privacy & Security → Accessibility.
- 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.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.
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.
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.
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.
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.
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.
macOS 26 or later on Apple silicon. Halo is free and open source under GPL-3.0.
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.
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-sandboxContributing · 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