Repository navigation
Releases
ClaudeNotch v0.44.1
ClaudeNotch v0.44.1. See the changelog: https://rawsun007.github.io/claude-notch/changelog/
ClaudeNotch v0.44.0
ClaudeNotch v0.44.0. See the changelog: https://rawsun007.github.io/claude-notch/changelog/
ClaudeNotch v0.43.1: the Linux notch shows on Ubuntu
Downloads
| Platform | File |
|---|---|
| macOS 13+ (Apple silicon and Intel) | ClaudeNotch.dmg |
| Linux: Ubuntu, Debian, Mint, Pop!_OS | claudenotch_0.43.1_all.deb |
| Linux: Fedora, Arch, openSUSE and others | claudenotch-0.43.1-linux.tar.gz |
Ubuntu and Debian: sudo apt install ./claudenotch_0.43.1_all.deb (upgrades 0.43.0 in place), then quit the old copy (pkill -f claudenotch) and start it again from the app menu.
Fedora, Arch and the rest: tar xzf claudenotch-0.43.1-linux.tar.gz && ./claudenotch-0.43.1-linux/install.sh.
macOS: nothing changed for the Mac app in this release. brew upgrade --cask rawsun007/tap/claudenotch or Update Now in the app.
Fixed
- Linux: the notch shows on Ubuntu. It was drawn at the very top of the screen, behind GNOME's top bar, so the idle pill was invisible and every card lost its first row. It now hangs just below the bar, like a notch, and sits below the top panel on KDE and XFCE too.
- Linux: starting the app has a visible result. It says ClaudeNotch is running for a few seconds after it starts, and launching it again while it runs makes the running app say so instead of doing nothing. Errors from an app-menu launch now show as a desktop notification and are written to
~/.cache/claudenotch/claudenotch.log, whichclaudenotch --statuspoints to. - Linux: the app still starts when XWayland refuses it, falling back to native Wayland instead of quitting with "no display".
Every Linux build is now also tested on Ubuntu's real desktop shell (headless GNOME Shell) in CI, which checks that the card sits below the top bar.
Full changelog: https://rawsun007.github.io/claude-notch/changelog/#v0.43.1
ClaudeNotch v0.43.0: now on Linux
Downloads
| Platform | File |
|---|---|
| macOS 13+ (Apple silicon and Intel) | ClaudeNotch.dmg |
| Linux: Ubuntu, Debian, Mint, Pop!_OS | claudenotch_0.43.0_all.deb |
| Linux: Fedora, Arch, openSUSE and others | claudenotch-0.43.0-linux.tar.gz |
macOS with Homebrew: brew upgrade --cask rawsun007/tap/claudenotch, or Update Now in the app.
Added
-
ClaudeNotch runs on Linux. The same permission card, questions, danger warnings and secret redaction as the Mac app, in a small pill at the top centre of the screen that grows into a card when Claude needs you and into your session list when you point at it.
- Ubuntu and Debian:
sudo apt install ./claudenotch_0.43.0_all.deb - Fedora, Arch and the rest:
tar xzf claudenotch-0.43.0-linux.tar.gz && ./claudenotch-0.43.0-linux/install.sh(no root needed)
Either way it starts at login and connects itself to Claude Code on first run, keeping your own hooks. Works on X11 and on GNOME Wayland through XWayland; uses layer-shell on KDE, Sway and Hyprland when
gir1.2-gtklayershell-0.1is installed. Details in linux/README.md. - Ubuntu and Debian:
-
Linux-specific danger warnings.
pkexec,systemctl enable, and writes to autostart entries or systemd user units get the same second-click guard asrm -rfandsudo.
Fixed
- Clicking a button on the open notch, such as History, works again. A click was read as the start of a file drag, which closed the notch under the cursor before the button could respond.
Full changelog: https://rawsun007.github.io/claude-notch/changelog/#v0.43.0
ClaudeNotch for Linux 0.44.0: Settings, painless updates and clean uninstall
Linux only. The macOS app is unchanged: Mac users stay on v0.43.1.
Downloads
| Linux | File |
|---|---|
| Ubuntu, Debian, Mint, Pop!_OS | claudenotch_0.44.0_all.deb |
| Fedora, Arch, openSUSE and others | claudenotch-0.44.0-linux.tar.gz |
Ubuntu and Debian: sudo apt install ./claudenotch_0.44.0_all.deb. Install it straight over 0.43.x, no uninstall: the running copy is replaced by the new version.
Fedora, Arch and the rest: tar xzf claudenotch-0.44.0-linux.tar.gz && ./claudenotch-0.44.0-linux/install.sh.
Added
- A Settings window. Right-click the notch and choose Settings, right-click ClaudeNotch in the dock or app grid, launch it again while it runs, or run
claudenotch --settings. Pages: General (start at login, greeting, sessions on hover, session updates), Notifications, Claude Code (hooks status, install, remove), Always allow (every rule, each removable) and About. - Right-click the notch for Settings and Quit, also on the app's dock icon.
claudenotch --quitquits it.
Changed
- Desktop notifications for cards are off by default. The card is already on screen, and on Ubuntu the notification banner landed right on top of it. Turn them on in Settings, for every card or for dangerous calls only.
Fixed
- Installing a new version replaces the running one. The package was upgraded, but the old app kept running the old code, so an update looked like it did nothing until you uninstalled. Now the app restarts itself into the new version within a few seconds (after any card you are answering) and says it was updated. Upgrading from 0.43.x restarts the running copy for you, in your desktop session. The tarball's
install.shreplaces a running copy too. - Removing ClaudeNotch removes all of it.
apt removeandapt purgenow stop the running app and take its hooks out of your Claude Code settings (your own hooks stay); purge also deletes its token, rules, settings and log. Before, the app kept running afterapt purgeand Claude Code kept calling it.
Already removed 0.43.x and still getting notifications?
Run this as yourself (not with sudo), then restart open claude sessions:
curl -fsSLO https://raw.githubusercontent.com/rawsun007/claude-notch/main/linux/packaging/remove-leftovers.sh
less remove-leftovers.sh
bash remove-leftovers.shIt stops the leftover copy, removes only ClaudeNotch's hooks from ~/.claude/settings.json (backup first) and deletes its folders.
Full changelog: https://rawsun007.github.io/claude-notch/changelog/#linux-v0.44.0
ClaudeNotch v0.42.3
ClaudeNotch v0.42.3. See the changelog: https://rawsun007.github.io/claude-notch/changelog/
ClaudeNotch v0.42.2
ClaudeNotch v0.42.2. See the changelog: https://rawsun007.github.io/claude-notch/changelog/
ClaudeNotch v0.42.1
ClaudeNotch v0.42.1. See the changelog: https://rawsun007.github.io/claude-notch/changelog/
ClaudeNotch v0.42.0
ClaudeNotch v0.42.0. See the changelog: https://rawsun007.github.io/claude-notch/changelog/
ClaudeNotch v0.41.1
ClaudeNotch v0.41.1. See the changelog: https://rawsun007.github.io/claude-notch/changelog/