Did you ship today? A minimalist macOS menu bar app that turns your GitHub contribution graph into a living flame. One glance at the menu bar tells you your streak and whether today still needs a commit.
- Menu bar at a glance: a flame and your streak count. Filled flame means you shipped today, outline means not yet. Past your reminder hour with nothing shipped, it turns orange.
- Ember grid: your last year of contributions as a dot matrix. Intensity shifts the color from deep ember to hot yellow-orange, lit days flicker softly, and the dots of your current streak breathe together.
- Reveal animation: opening the popover ignites the grid left to right behind a curved, eased wavefront.
- Evening reminder: one notification, only on days your streak is at risk. "2-day streak ends at midnight." Nothing else, ever.
- Milestones: crossing 7, 30, 100, or 365 days sends a wave through the grid and one quiet notification.
- Hover any dot for the day's detail: "Mar 14 · 6 contributions".
- Manual days: hover the streak number and hit the check to mark a no-code day done. Persisted to disk, merged with GitHub data.
- macOS 14 or later
- Swift toolchain (Xcode Command Line Tools are enough, no Xcode project needed)
./build.sh
open build/Streak.appThat's the whole build system: build.sh compiles the sources with swiftc and assembles the .app bundle directly.
Streak reads your contribution calendar through the GitHub GraphQL API, private contributions included, so the grid matches what you see on your own profile.
- Open the popover, hover to reveal the gear, and open Settings.
- Click "Create a token on GitHub". The page opens with the right settings preselected: a classic token with only the
read:userscope. - Generate, copy, paste it into Streak, and Save.
The token is stored in the macOS Keychain, never in files or UserDefaults. With read:user only, it cannot touch code, repos, or settings. Contributions refresh every 15 minutes.
- Launch at login may require the app to live in
/Applications(macOS policy for ad-hoc-signed apps). - Local rebuilds change the app's code signature, so macOS re-asks for Keychain access after each rebuild. Downloaded builds prompt once.
