Skip to content

GrantBirki/shit

Repository files navigation

Shit 📆

build test lint release

A native macOS menu bar app that helps you miss fewer meetings.

When I miss a meeting: Shit...

Shit reads your locally synced Apple Calendar events and shows a hard-to-miss overlay when a meeting is about to start or is already active. It does not use Google OAuth, cloud services, telemetry, or external credentials. It is 100% local.

Requires macOS Tahoe 26 or later.

demo.mp4

Installation

Homebrew (recommended):

brew install --cask grantbirki/tap/shit

Features

  • Local Apple Calendar access through macOS privacy permissions.
  • Full-screen meeting overlay with Liquid Glass panels and controls.
  • Configurable alert timing, calendar filters, and launch at login.
  • Native menu bar controls for checking meetings, reopening the current alert, settings, and quit.

Usage

Verify Releases

Release artifacts are published with SLSA provenance. After downloading Shit.zip:

gh attestation verify Shit.zip \
  --repo grantbirki/shit \
  --signer-workflow grantbirki/shit/.github/workflows/release.yml \
  --source-ref refs/heads/main \
  --deny-self-hosted-runners

Minimal verification by owner:

gh attestation verify Shit.zip --owner grantbirki

You can also verify the checksum:

shasum -a 256 Shit.zip

Unsigned Builds

Shit releases are currently unsigned. macOS Gatekeeper may block the first launch.

To open it:

  1. Right-click Shit.app and choose Open.
  2. Or go to System Settings -> Privacy & Security and click Open Anyway.
  3. If neither shows, remove the quarantine attribute:
xattr -dr com.apple.quarantine /Applications/Shit.app

Contributing

See CONTRIBUTING.md.

About

A tool to help me miss fewer meetings.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Contributors