Skip to content

NotchPal 1.1.0 — broken, use 1.1.1

Choose a tag to compare

View all tags
@simonveprek simonveprek released this 29 Jul 09:05
v1.1.0
ac54201

NotchPal shows what Claude Code and OpenAI Codex are doing — in your notch.

Not "an agent is running". The file, the command, the line range, the elapsed
time. When nothing is running, NotchPal shows nothing at all.

See it running at mac.simonveprek.cz.

New in 1.1.0

  • Open at Login. Toggle it from the menu bar item. It registers the app with
    macOS through SMAppService, so it also shows up under System Settings ›
    General › Login Items and can be switched off there.

Installing

  1. Download NotchPal-1.1.0.zip below, unzip it, and move NotchPal.app to
    your Applications folder.
  2. macOS will refuse to open it the first time — this is expected. See below.
  3. From the menu bar item, turn on hooks for Claude Code and/or Codex.
  4. Optionally turn on Open at Login.

Getting past "Apple could not verify NotchPal"

This build is not notarized, because notarizing requires a paid Apple
Developer ID this project doesn't have. The app is fine — macOS simply has no
Apple-issued signature to check it against.

Right-click → Open does not work for this on macOS 15 and later. Do one of:

Either — try to open the app, click Done on the warning, then open
System Settings › Privacy & Security, scroll down to Security, and click
Open Anyway next to the NotchPal message.

Or — clear the quarantine flag from Terminal:

xattr -dr com.apple.quarantine /Applications/NotchPal.app

Or, best — build it yourself. Nothing gets quarantined because nothing came
from the internet, and it takes about a minute:

git clone https://github.com/simonveprek/NotchPal.git
cd NotchPal
make install

Codex needs one extra step

Claude Code runs the hooks as soon as they're registered; Codex ignores any new
hook until you've reviewed what it runs. In the Codex app open Settings and
allow Hooks; in the Codex CLI run /hooks and trust the NotchPal command.
Once only.

Requirements

  • macOS 26 (Tahoe) or later
  • Universal — Apple Silicon and Intel
  • Any Mac. Without a notch, the panel floats below the menu bar instead

Known limitation

If you stop an agent yourself — Escape, Ctrl-C, or closing the terminal — no
hook fires, so nothing tells NotchPal the work ended. Hover the card and click
the ✕ to dismiss it. It clears the card, not the agent: hooks only travel
one way, so there's no channel back.

Privacy

Entirely local. No network calls of any kind. Events travel over a Unix socket
in your Application Support folder, live in memory, and are forgotten on quit.

NotchPal-1.1.0.zip — SHA-256
25919957a2bf293aacee22bbffd54c5a82d1e7cd855670a637bd19cb0de1f3b5

Assets 3
Loading