Skip to content

Releases: simonveprek/NotchPal

NotchPal 1.1.1 — fixes 1.1.0 not launching

Choose a tag to compare

@simonveprek simonveprek released this 29 Jul 09:30

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

  1. Download NotchPal-1.1.1.zip, unzip, move NotchPal.app to Applications.
  2. 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:
    xattr -dr com.apple.quarantine /Applications/NotchPal.app
    or open System Settings › Privacy & Security, scroll to Security, and
    click Open Anyway.
  3. Turn on hooks for Claude Code and/or Codex from the menu bar item.
  4. 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 install

Requirements

  • 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

Choose a tag to compare

@simonveprek simonveprek released this 29 Jul 09:05

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

NotchPal 1.0.0

Choose a tag to compare

@simonveprek simonveprek released this 28 Jul 11:16

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

  1. Download NotchPal-1.0.0.zip below and unzip it.
  2. Move NotchPal.app to your Applications folder.
  3. Right-click the app → Open, then confirm. (See the note below — this step is required.)
  4. 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.app

Prefer not to run an unnotarized binary? Build it yourself — it takes a minute:

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

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.0.0.zip — SHA-256
4e23a699e57f9c4558d4a8199d063da823bfe660a9c49d7037989d1bbbb08dd3