What it does
- Contribution graph — the year of green squares, with month and weekday labels and a tooltip on every day ("7 contributions on Oct 21, 2026").
- Stats — total for the last year, best day, average per day, current streak and longest streak.
- Activity overview — GitHub's four-way chart of Commits, Issues, Pull requests and Code review, read from the public profile. No token needed for most people.
- Favorites — keep up to 10 people and flip between them with a two-finger swipe, the ← → keys or the ◀ ▶ buttons. Your Primary profile shows as a 7-day strip right in the menu bar.
- Widgets — Small, Medium and Large, on the desktop or in Notification Center, with ◀ ▶ buttons to cycle through up to 5 people.
- Works offline — shows the last data it saw, with "Offline, showing data from 2 hr ago."
- Themes — GitHub Green, Halloween, Ocean and Mono, in light and dark.
Install
Download:
- Download Tracker-for-GitHub-x.y.z.dmg from the latest release.
- Open it and drag Tracker for GitHub into Applications.
- Open the app. It's signed and notarized by Apple, so macOS only asks you to confirm the first time.
- Click the graph icon in your menu bar and type a GitHub username.
Or with Homebrew:
brew install --cask garoknows/tap/tracker-for-github
Step-by-step pictures: docs/INSTALL.md.
Build from source
You need macOS 14+ and Xcode (free in the Mac App Store).
git clone https://github.com/garoknows/github-tracker.git
cd github-tracker
./scripts/install.sh
The script builds a Release copy, puts it in /Applications and opens it. It prints a clear message if Xcode is missing.
For development, run swift test --package-path Packages/TrackerKit for the unit tests (no network needed), and see CONTRIBUTING.md. The Xcode project is generated from project.yml with XcodeGen.
FAQ
Why is the quadrant chart missing for someone?
GitHub only shows "Activity overview" for people who turned it on in their profile settings. If they did and it's still missing, paste a free read-only token in Settings. It needs no permissions at all (create one).
Does it show private work?
Only as anonymous squares, and only if that person turned on "Private contributions" on their profile. Private repo names and code are never shown. That's how GitHub's own profile works too.
Does the total match github.com?
Yes. The graph comes from the same public page GitHub uses for profiles, and the colors use GitHub's own intensity levels.
Why can't I swipe the widgets?
macOS widgets only support clicks on buttons, so they have ◀ ▶ instead. Swiping works in the menu bar popover.
Can the widgets use my app favorites?
Not in this free build. Sharing settings between an app and its widgets needs an Apple Developer signing team (App Groups). For now each widget is set up with Edit Widget, which takes about 10 seconds.
How often does it refresh?
Every 30 minutes by default (15 min to 3 hr in Settings). Widgets refresh about every 30 minutes. Refresh in the popover updates right away.
Something broke after GitHub changed its site.
Please open an issue. All of GitHub's page format is handled in one place with saved test pages, so fixes are quick. See docs/DATA-SOURCES.md.
Privacy
- No account, no server, no analytics, no third-party code.
- The app talks only to github.com and api.github.com, plus GitHub's avatar image host for profile pictures.
- The optional token lives only in your macOS Keychain, where the app and its widget can both read it. It's never written to disk, settings or logs, and only ever sent to api.github.com, over HTTPS.
- The app and widgets run in Apple's App Sandbox with outgoing network access only.
Details in SECURITY.md.
Credits
Built with ideas (not code) from these projects. Thank you!
No code from the GPL-licensed projects was copied into this MIT project.
Support
Tracker for GitHub is free. If it's useful to you, you can sponsor its development.
License
MIT © garoknows
Tracker for GitHub is an independent project. It is not affiliated with, endorsed by, or sponsored by GitHub, Inc. "GitHub" is a trademark of GitHub, Inc.
