Skip to content

NotchPal 1.0.0

Choose a tag to compare

View all tags
@simonveprek simonveprek released this 28 Jul 11:16
v1.0.0
f634631

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

Assets 3
Loading