A tiny companion for your coding days

Your GitHub activity, cared for.

Pushtopia is a friendly macOS companion that turns eligible GitHub activity into gentle changes in your pet’s needs, plus levels and streaks. Human pushes feed it. Successful workflows restore health. Reviews can lift or lower its mood.

$ beta download coming soon · macOS 14+ · menu-bar app

~/pushtopia — companionYOUR PET
Brita · dog · neutralstarting indicators
Brita, a neutral dog

Illustrative starting values · the app does not keep an activity feed.

human push ▸ satiety +10workflow success ▸ health +5workflow failure or timeout ▸ health −10approved review ▸ happiness +10changes requested ▸ happiness −10closed PR without merge ▸ happiness −5no death · no game over · always recoverablehuman push ▸ satiety +10

Make progress feel alive

Small coding moments become visible care, giving your work a gentle sense of momentum.

A calm desktop ritual

Your pet lives quietly alongside your workflow, without noisy streaks or heavy dashboards.

Built for the Mac

A lightweight menu-bar companion designed for the way you already work. No webhooks or repository hooks — GitHub is checked on a rate-aware schedule.

The loop

A simple rhythm for your day.

Connect a GitHub account in the macOS app and choose repositories to monitor. Pushtopia checks GitHub on a rate-aware schedule and can also watch folders you configure locally. No webhooks or repository hooks are installed.

  1. 01

    Sign in on your Mac

    Authorize Pushtopia through GitHub Device Flow. The token stays in macOS Keychain; access depends on the permissions you grant.

    $ open -a Pushtopia # → enter code ABCD-1234
  2. 02

    Pick your repos

    Choose repositories from those your GitHub authorization can access. You can also configure local folders for push detection.

    watching acme/api · acme/web · you/dotfiles
  3. 03

    Keep building

    GitHub checks and optional local folder monitoring detect eligible activity. A local commit alone does not count as a push.

    push ▸ needs · XP · streaks
  4. 04

    Care for your pet

    See your pet’s needs, mood, level and streaks in the menu bar and pet window. Activity details are not presented as a saved feed.

    needs · level · contribution · green CI

The rules are kind

Signals in. Gentle feedback out.

Satiety

Eligible human pushes feed your pet. A local commit by itself does not.

+10 per push

Health

Green workflows keep it well.

+5 passed · −10 failed

Happiness

Reviews on your PRs shape happiness; closing a PR without merging also lowers it.

+10 approved · −10 requested · −5 closed
Happy BritaHAPPY☼ ≥70 · ♥ ≥50 · ◆ ≥40
Neutral BritaNEUTRALan ordinary moment
Sad BritaSAD☼ <30 or ◆ <20
Sick BritaSICK♥ <30
Exhausted BritaEXHAUSTEDall zero · recoverable

Pick a companion

Same rhythm. Different personality.

Selected companion: Brita

In the app

Progress you can take with you.

Your activity shapes the pet. Your progress stays focused on the things that matter.

01 · LEVELS

Grow through real activity

Eligible pushes, successful workflow runs and approved reviews earn XP. Levels follow a steady curve, and rewards are deduplicated.

XP stays with your progress
02 · STREAKS

Two different kinds of momentum

Track consecutive contribution days and the count of successful workflow runs since a failure. Gaps and unknown coverage are treated carefully.

Contribution · Green CI
03 · ACCOUNT SYNC

Continue on another Mac

Account sync is optional. Sign in with the same GitHub account to recover your pet progress on another machine.

Off until you turn it on

Privacy by default

Your code stays yours.

This site does not access your GitHub account. Sign-in happens in the macOS app through GitHub Device Flow. GitHub activity and pet progress are processed on your Mac; if you opt into account sync, limited pseudonymous progress data is sent to our backend so it can be recovered on another Mac. When configured, minimal app-open analytics is on by default and can be disabled in Settings. No webhooks or repository hooks are installed.

// GitHub authorizationrepo · repository and activity access
read:org · organization repositories
notifications · notification signals
Token stored in macOS Keychain

Early access

Come take care of a tiny friend.

The Pushtopia macOS beta is being prepared for distribution. The download link will appear here once the signed installer is ready.

Requirements: macOS 14 Sonoma or later · Apple silicon · no Electron, no WebView

Questions?

Questions about Pushtopia?

Sign-in is available inside the macOS app through GitHub Device Flow. A public web login is not part of the app. A public support contact will be added before beta invitations.

Support contact to be announced with the beta.