Pulse Notch | paugarcia32

Project Overview

Pulse Notch is a native macOS app that turns the MacBook notch into a compact activity surface. I built it for my own workflow: I wanted to know when a coding agent or GitHub Action finished and keep my next calendar event nearby without adding more notifications. The surface stays small until expanded, and it also works on Macs and external displays without a physical notch.

Pulse Notch showing activity in the MacBook notch — Pulse Notch in action

Features

Coding agents

Shows running and recently completed Codex, Claude Code, Cursor Agent, Antigravity, and OpenCode sessions.

GitHub activity

Tracks pull requests, reviews, checks, and Actions for repositories selected in Settings.

Calendar

Shows upcoming events, meeting links, and configurable reminders.

Media controls

Displays artwork and playback progress with Now Playing controls.

System activity

Surfaces downloads, Homebrew operations, charging, volume, and Bluetooth-headphone activity.

Timers

Keeps stopwatch and timer activity visible in the notch.

Tech Stack

Layer	Technology
App and interface	Swift 6, SwiftUI, AppKit
Build and tests	Swift Package Manager, Swift Testing
GitHub integration	Authenticated GitHub CLI (`gh`)

Domain behavior lives in PulseNotchCore, while PulseNotchApp contains the macOS interface and integrations. The project uses Swift 6 strict concurrency checking.

Privacy and Availability

Pulse Notch processes activity locally and includes no telemetry. Agent detection reads process and session metadata rather than conversation contents. GitHub activity uses the authenticated gh CLI, and integrations can be disabled individually in Settings.

It runs on macOS 14 Sonoma or newer. Apple Silicon builds are available through Homebrew and the latest GitHub release.