Orbit is a native macOS contact workspace that mirrors Apple Contacts and layers notes, insights, follow-ups, and WhatsApp-assisted verification on top.
brew install --cask zekevh/tap/orbitOr download the latest DMG from the GitHub releases page.
Requirements:
- Xcode 16+
- macOS 15+ for local development
Open the project in Xcode:
open Orbit.xcodeprojOr build from the command line:
./scripts/run-build.shPushing a tag in the form v1.0.0 triggers the release workflow in GitHub Actions. That workflow:
- builds
Orbit.appfor direct distribution - creates
Orbit-<version>.dmg - publishes the DMG to GitHub Releases
- updates
Casks/orbit.rbinzekevh/homebrew-tap
Required GitHub secret:
TAP_GITHUB_TOKEN: token with push access tozekevh/homebrew-tap
Release builds in CI are packaged for direct distribution with the app sandbox disabled. Users will need to bypass Gatekeeper manually, but Contacts access can still be granted because the shipped app is no longer relying on sandbox entitlements.