notch-so-good

skill
Security Audit
Fail
Health Warn
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 6 GitHub stars
Code Fail
  • rm -rf — Recursive force deletion command in build-app.sh
  • rm -rf — Recursive force deletion command in build-universal.sh
  • rm -rf — Recursive force deletion command in dev.sh
  • rm -rf — Recursive force deletion command in get.sh
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

The world's smallest coworker lives in your Mac's notch. A pixel-art crab watches Claude Code so you don't have to. 13 animations. Zero chill. npx notch-so-good

README.md

Notch So Good

The world's smallest coworker lives in your Mac's notch.

Meet Chawd. He's a mass of pixels. He lives in your MacBook's notch. And he has one job: watch Claude Code so you don't have to.

                    ┌──────────────────────────┐
                    │         M A C B O O K    │
         ┌──────────┤                          ├──────────┐
         │  🦀 0:42 │      [ N O T C H ]       │ ● 3:21  │
         └──────────┴──────────────────────────┴──────────┘
              ↑                                      ↑
          Chawd                                 Live timer
          (has no chill)                     (green pulse dot)

Install

brew install --cask deepshal99/tap/notch-so-good

That's it. 10 seconds. No Xcode, no dependencies, no sign-up.

Also works with:

npx notch-so-good

Or curl:

curl -fsSL https://raw.githubusercontent.com/deepshal99/notch-so-good/main/get.sh | bash

Requirements

  • macOS 14+ (Sonoma or later) — MacBook with a notch recommended
  • Claude Codeget it here

What Chawd Does

He watches. When Claude Code is running, a black pill extends your notch. Chawd sits on the left, a live timer ticks on the right.

He performs. 13 idle animations — wave, dance, sneeze, peek-a-boo, backflip, levitate, yawn, hiccup, spin, stretch, and more. He has absolutely no chill.

He follows your eyes. Move your mouse near the notch and Chawd's tiny pixel eyes track your cursor. Get close and he gets excited. Leave him alone too long and he falls asleep. Come back and he does a startled little jolt.

He tells you things. When Claude needs input, your notch expands into a notification. Color-coded by type — green for done, blue for questions, amber for permissions. Click anywhere to jump back to your terminal.

He approves things. When Claude wants to run a command or edit a file, Allow/Deny buttons appear right in the notch. No need to switch to the terminal — approve tool executions without leaving what you're doing.

         ┌──────────────────────────────────────┐
         │             [ N O T C H ]             │
         │                                       │
         │  🦀  PERMISSION                       │
         │      ⚡ Bash                           │
         │      rm -rf node_modules              │
         │                                       │
         │     [ Deny ]        [ Allow ]         │
         └──────────────────────────────────────┘

He multitasks. Running 5 Claude sessions? Hover the pill to see all of them, grouped by project, each with its own timer and status dot.

He sets himself up. Hooks install automatically on first launch. No manual setup, no config files to edit.


What's New in 4.0.0

  • Real completion summaries — Stop notifications now show Claude's actual last message pulled from the session transcript.
  • Nudge mode — If a session waits on you for 2+ minutes, Chawd pings you again (toggle in menu bar).
  • Menu bar attention dot — Amber dot appears on the crab when any session needs you.
  • Recent notifications history — Click the menu bar popover to see and jump back to recent notifications.
  • Launch at Login toggle — Control auto-start from the menu bar.
  • Gemini CLI support — Gemini sessions get their own badge alongside Claude.
  • Robustness improvements — Survives monitor/resolution changes, long sessions no longer vanish at 1 hour, event-driven hover tracking (no more constant polling), faster hook socket handling.
  • Fixed — iTerm2/Terminal tab deep-linking now prompts for Automation permission properly.

How It Works

Hooks into Claude Code's hook system via URL scheme callbacks and a local permission server. No cloud, no polling, no network requests.

  Claude starts    →  🦀 Chawd appears
  Claude works     →  🦀 Chawd does tricks, timer ticks
  Claude asks      →  🔔 Notch expands with notification
  Claude needs ok  →  🔐 Approve/Deny buttons in the notch
  Claude done      →  ✅ Completion notification, pill fades

Permission Approvals

Safe tools (Read, Grep, Glob, etc.) are auto-approved instantly — zero friction. When Claude wants to run Bash commands, edit files, or write new ones, you get interactive Allow/Deny buttons right in the notch. If the app isn't running, Claude Code falls back to its normal terminal-based permission flow.


Update

Automatic via Sparkle. You'll get a native macOS update dialog when a new version drops. Or check manually: menu bar Chawd icon → Check for Updates.

Uninstall

curl -fsSL https://raw.githubusercontent.com/deepshal99/notch-so-good/main/uninstall.sh | bash

Build from Source

git clone https://github.com/deepshal99/notch-so-good.git
cd notch-so-good
bash install.sh

Requires Xcode Command Line Tools (xcode-select --install).


Macs Without a Notch

Notifications appear centered below the menu bar. Chawd prefers notch MacBooks but doesn't discriminate.


Contributing

PRs welcome. The crab demands more gimmicks.

License

MIT

Built by deepshal99 and Claude. Chawd built himself.

Reviews (0)

No results found