Skip to content
zeusinsightPublic

About

Did you ship today? Your GitHub streak as a living flame in the macOS menu bar

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

12 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Streak

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.

Streak popover

Features

  • 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.

Requirements

  • macOS 14 or later
  • Swift toolchain (Xcode Command Line Tools are enough, no Xcode project needed)

Build and run

./build.sh
open build/Streak.app

That's the whole build system: build.sh compiles the sources with swiftc and assembles the .app bundle directly.

Connecting GitHub

Streak reads your contribution calendar through the GitHub GraphQL API, private contributions included, so the grid matches what you see on your own profile.

  1. Open the popover, hover to reveal the gear, and open Settings.
  2. Click "Create a token on GitHub". The page opens with the right settings preselected: a classic token with only the read:user scope.
  3. 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.

Limitations

  • 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.

License

MIT

About

Did you ship today? Your GitHub streak as a living flame in the macOS menu bar

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages