{"id":48085209,"url":"https://github.com/deepshal99/notch-so-good","last_synced_at":"2026-05-20T07:14:02.646Z","repository":{"id":343935133,"uuid":"1179766084","full_name":"deepshal99/notch-so-good","owner":"deepshal99","description":"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","archived":false,"fork":false,"pushed_at":"2026-04-02T22:52:46.000Z","size":13945,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-03T09:11:00.681Z","etag":null,"topics":["ai-coding","ai-tools","anthropic","claude","claude-code","claude-code-hooks","claude-code-plugin","developer-tools","dynamic-island","macbook","macos","macos-app","menubar","notch","notification","open-source","pixel-art","productivity","swift","swiftui"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/notch-so-good","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/deepshal99.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-12T11:05:45.000Z","updated_at":"2026-04-02T22:52:51.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/deepshal99/notch-so-good","commit_stats":null,"previous_names":["deepshal99/notch-so-good"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/deepshal99/notch-so-good","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deepshal99%2Fnotch-so-good","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deepshal99%2Fnotch-so-good/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deepshal99%2Fnotch-so-good/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deepshal99%2Fnotch-so-good/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/deepshal99","download_url":"https://codeload.github.com/deepshal99/notch-so-good/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deepshal99%2Fnotch-so-good/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32028547,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-20T00:18:06.643Z","status":"ssl_error","status_checked_at":"2026-04-20T00:17:31.068Z","response_time":55,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-coding","ai-tools","anthropic","claude","claude-code","claude-code-hooks","claude-code-plugin","developer-tools","dynamic-island","macbook","macos","macos-app","menubar","notch","notification","open-source","pixel-art","productivity","swift","swiftui"],"created_at":"2026-04-04T15:14:13.314Z","updated_at":"2026-04-20T01:00:47.285Z","avatar_url":"https://github.com/deepshal99.png","language":"Swift","funding_links":[],"categories":["Plugins"],"sub_categories":["All Plugins"],"readme":"# \u003cimg src=\"https://em-content.zobj.net/source/apple/391/crab_1f980.png\" width=\"28\"\u003e Notch So Good\n\n**The world's smallest coworker lives in your Mac's notch.**\n\nMeet **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.\n\n```\n                    ┌──────────────────────────┐\n                    │         M A C B O O K    │\n         ┌──────────┤                          ├──────────┐\n         │  🦀 0:42 │      [ N O T C H ]       │ ● 3:21  │\n         └──────────┴──────────────────────────┴──────────┘\n              ↑                                      ↑\n          Chawd                                 Live timer\n          (has no chill)                     (green pulse dot)\n```\n\n---\n\n## Install\n\n```bash\nnpx notch-so-good\n```\n\nThat's it. 10 seconds. No Xcode, no dependencies, no sign-up.\n\nAlso works with curl:\n```bash\ncurl -fsSL https://raw.githubusercontent.com/deepshal99/notch-so-good/main/get.sh | bash\n```\n\n### Requirements\n\n- **macOS 14+** (Sonoma or later) — MacBook with a notch recommended\n- **Claude Code** — [get it here](https://docs.anthropic.com/en/docs/claude-code)\n\n---\n\n## What Chawd Does\n\n**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.\n\n**He performs.** 13 idle animations — wave, dance, sneeze, peek-a-boo, backflip, levitate, yawn, hiccup, spin, stretch, and more. He has absolutely no chill.\n\n**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.\n\n**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.\n\n**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\n```\n         ┌──────────────────────────────────────┐\n         │             [ N O T C H ]             │\n         │                                       │\n         │  🦀  PERMISSION                       │\n         │      ⚡ Bash                           │\n         │      rm -rf node_modules              │\n         │                                       │\n         │     [ Deny ]        [ Allow ]         │\n         └──────────────────────────────────────┘\n```\n\n**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.\n\n**He sets himself up.** Hooks install automatically on first launch. No manual setup, no config files to edit.\n\n---\n\n## How It Works\n\nHooks into [Claude Code's hook system](https://docs.anthropic.com/en/docs/claude-code/hooks) via URL scheme callbacks and a local permission server. No cloud, no polling, no network requests.\n\n```\n  Claude starts    →  🦀 Chawd appears\n  Claude works     →  🦀 Chawd does tricks, timer ticks\n  Claude asks      →  🔔 Notch expands with notification\n  Claude needs ok  →  🔐 Approve/Deny buttons in the notch\n  Claude done      →  ✅ Completion notification, pill fades\n```\n\n### Permission Approvals\n\nSafe 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.\n\n---\n\n## Update\n\nAutomatic via [Sparkle](https://sparkle-project.org). You'll get a native macOS update dialog when a new version drops. Or check manually: **menu bar Chawd icon → Check for Updates**.\n\n## Uninstall\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/deepshal99/notch-so-good/main/uninstall.sh | bash\n```\n\n## Build from Source\n\n```bash\ngit clone https://github.com/deepshal99/notch-so-good.git\ncd notch-so-good\nbash install.sh\n```\n\nRequires Xcode Command Line Tools (`xcode-select --install`).\n\n---\n\n## Macs Without a Notch\n\nNotifications appear centered below the menu bar. Chawd prefers notch MacBooks but doesn't discriminate.\n\n---\n\n## Contributing\n\nPRs welcome. The crab demands more gimmicks.\n\n## License\n\n[MIT](LICENSE)\n\n\u003csub\u003eBuilt by [deepshal99](https://github.com/deepshal99) and Claude. Chawd built himself.\u003c/sub\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeepshal99%2Fnotch-so-good","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdeepshal99%2Fnotch-so-good","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeepshal99%2Fnotch-so-good/lists"}