Releases: simonveprek/NotchPal
Release list
NotchPal 1.1.1 — fixes 1.1.0 not launching
Fixes 1.1.0, which would not launch.
If you downloaded 1.1.0 and macOS quit it immediately — with no dialog, or a
crash reporter — that was a packaging fault, not your Mac. The app was killed
with Code Signature Invalid before it ever ran. Please delete 1.1.0 and use
this build.
What was wrong
The release archive was created with ditto --sequesterRsrc, which writes the
bundle's extended attributes into __MACOSX sidecar entries. Finder doesn't
restore them faithfully, so the code signature was valid on the machine that
built it and invalid on yours. Separately, macOS stamps com.apple.provenance
on binaries it has seen, which broke verification of the nested reporter binary.
Both are fixed. The build script now verifies the signature after signing,
refuses to ship an archive containing __MACOSX, then unpacks the finished
archive and verifies the signature again — because a signature that's valid
on disk says nothing about what you actually unzip.
No changes to the app itself. Everything from 1.1.0 is here, including
Open at Login.
Installing
- Download
NotchPal-1.1.1.zip, unzip, move NotchPal.app to Applications. - macOS will still warn that it can't verify the app — it isn't notarized,
because that needs a paid Apple Developer ID this project doesn't have.
Right-click → Open does not work on macOS 15+. Either:or open System Settings › Privacy & Security, scroll to Security, andxattr -dr com.apple.quarantine /Applications/NotchPal.app
click Open Anyway. - Turn on hooks for Claude Code and/or Codex from the menu bar item.
- Optionally turn on Open at Login.
Codex needs one extra step. In the Codex app, open Settings and allow Hooks;
in the CLI, run /hooks and trust the NotchPal command. Once only.
Building from source avoids the warning entirely — nothing is quarantined
because nothing came from the internet:
git clone https://github.com/simonveprek/NotchPal.git
cd NotchPal
make installRequirements
- macOS 26 (Tahoe) or later · Universal (Apple Silicon and Intel)
- Any Mac. Without a notch, the panel floats below the menu bar instead
NotchPal-1.1.1.zip — SHA-256
af2ab011a7c273e0214627e32a607f5f994484de17feebb3cff2d258b3646969
NotchPal 1.1.0 — broken, use 1.1.1
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 throughSMAppService, so it also shows up under System Settings ›
General › Login Items and can be switched off there.
Installing
- Download
NotchPal-1.1.0.zipbelow, unzip it, and move NotchPal.app to
your Applications folder. - macOS will refuse to open it the first time — this is expected. See below.
- From the menu bar item, turn on hooks for Claude Code and/or Codex.
- 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.appOr, 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 installCodex 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
NotchPal 1.0.0
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.
Install
- Download
NotchPal-1.0.0.zipbelow and unzip it. - Move NotchPal.app to your Applications folder.
- Right-click the app → Open, then confirm. (See the note below — this step is required.)
- From the menu bar item, turn on hooks for Claude Code and/or Codex.
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.
⚠️ This build is not notarized
It's ad-hoc signed, so macOS Gatekeeper will refuse to open it on the first
try. This is expected, and it's because notarizing requires a paid Apple
Developer ID that this project doesn't have yet — not because anything is wrong
with the download.
Right-click → Open is usually enough. If macOS still refuses:
xattr -dr com.apple.quarantine /Applications/NotchPal.appPrefer not to run an unnotarized binary? Build it yourself — it takes a minute:
git clone https://github.com/simonveprek/NotchPal.git
cd NotchPal
make installRequirements
- 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.0.0.zip — SHA-256
4e23a699e57f9c4558d4a8199d063da823bfe660a9c49d7037989d1bbbb08dd3