{
  "markdown": "# NotchKit\n\nAn agent skill for building macOS notch apps. Install it once, and any AI coding agent can build a notch app in minutes.\n\n```bash\nnpx skills add aishwaryaashok14/notch-kit\n```\n\nWorks with Claude Code, Cursor, Cline, GitHub Copilot, Gemini CLI, Codex, and 40+ other agents.\n\n---\n\n## What is this?\n\nNotchKit is a skill for AI coding agents. It handles the hard parts of building a macOS notch app — panel configuration, notch detection, hover behavior, shape math — so you (or your agent) can focus on the actual app logic.\n\nInstall the skill, tell your agent what to build, and it knows how to use NotchKit.\n\n## Install\n\n**Skills.sh (works with 40+ agents):**\n```bash\nnpx skills add aishwaryaashok14/notch-kit\n```\n\n**Claude Code plugin:**\n```bash\n/plugin marketplace add aishwaryaashok14/notch-kit\n/plugin install notch-kit@aishwaryaashok14-notch-kit\n```\n\nThen tell your agent:\n\n```\nBuild me a macOS notch app that [describe your app].\nUse the notch-kit skill as the foundation.\n```\n\nOr use it directly without the skills CLI — paste this into Claude Code, Cursor, or any AI assistant:\n\n```\nI want to build a macOS notch app. Use the NotchKit starter kit from\nhttps://github.com/aishwaryaashok14/notch-kit as the foundation.\n\nClone it, then modify NotchContentView.swift to build [describe your app].\nThe collapsed view shows content on both sides of the notch camera.\nThe expanded view is the full tray that appears on hover.\n```\n\n## What you get\n\n| File | Purpose |\n|------|---------|\n| `NotchPanel.swift` | Floating `NSPanel` — non-activating, always on top, transparent, all spaces |\n| `NotchShape.swift` | Curved shape matching the MacBook notch (animatable corner radii) |\n| `NotchWindow.swift` | Notch detection, hover expand/collapse, clean teardown |\n| `NotchContentView.swift` | Template: collapsed wings + expanded tray — **edit this file** |\n| `NotchAppDelegate.swift` | Menu bar icon + app lifecycle |\n| `build-app.sh` | One command to build a `.app` bundle |\n\n## Quick start\n\n```bash\ngit clone https://github.com/aishwaryaashok14/notch-kit.git\ncd notch-kit\nchmod +x build-app.sh\nbash build-app.sh\nopen dist/NotchKit.app\n```\n\nYou should see a notch bar with \"NotchKit\" on the left and \"Ready\" on the right. Hover to expand the tray.\n\n## Build your own notch app\n\nAll your UI lives in `NotchKit/NotchContentView.swift`. Two sections to customize:\n\n**Collapsed view** — always visible, on both sides of the camera:\n\n```swift\nvar collapsedContent: some View {\n    HStack(spacing: 0) {\n        // LEFT WING\n        Text(\"My App\").font(.system(size: 9, design: .monospaced))\n\n        Color.clear.frame(width: viewModel.notchWidth - 30) // camera gap\n\n        // RIGHT WING\n        Text(\"Status\").font(.system(size: 9, design: .monospaced))\n    }\n}\n```\n\n**Expanded view** — the full tray on hover:\n\n```swift\nvar expandedContent: some View {\n    VStack {\n        Text(\"Your app content here\")\n        Button(\"Do something\") { /* ... */ }\n    }\n}\n```\n\n## Customization\n\nIn `NotchWindow.swift`:\n\n```swift\nvar expandedWidth: CGFloat = 420    // Tray width\nvar expandedHeight: CGFloat = 240   // Tray height\nvar wingExtension: CGFloat = 180    // Wing width beyond the notch\n```\n\nIn `NotchShape.swift` (corner radii):\n\n```\nCollapsed: top = 6,  bottom = 14\nExpanded:  top = 19, bottom = 24\n```\n\n## Architecture\n\n```\nNotchKit/\n  NotchApp.swift           App entry point\n  NotchAppDelegate.swift   Menu bar + lifecycle\n  NotchPanel.swift         NSPanel configuration\n  NotchShape.swift         Curved notch shape (animatable)\n  NotchWindow.swift        Notch detection + expand/collapse\n  NotchContentView.swift   YOUR UI GOES HERE\n  Info.plist               Agent app (no dock icon)\n```\n\n## Ideas to build with NotchKit\n\n- Pomodoro timer in the notch\n- Now playing music widget\n- CPU / memory monitor\n- Meeting countdown\n- Weather at a glance\n- Clipboard history\n- Quick notes\n- Habit tracker\n\n## How it works under the hood\n\n1. `NotchWindow` detects the notch via `NSScreen.auxiliaryTopLeftArea` and `auxiliaryTopRightArea`\n2. A `NotchPanel` (floating `NSPanel` at `.mainMenu + 3` level) is positioned at the notch\n3. `NotchTrackingView` handles mouse enter/exit for hover behavior\n4. On hover: panel animates to expanded size via `NSAnimationContext`\n5. `NotchViewModel.isExpanded` triggers the SwiftUI transition between collapsed and expanded\n6. On mouse leave: 0.8s delay, then collapse\n7. On quit: `destroy()` closes the panel and removes it — no ghost windows\n\n## Requirements\n\n- macOS 13+\n- Swift 5.9+\n- No Xcode project needed (Swift Package Manager)\n- Works on MacBooks with and without a notch\n\n## Built with NotchKit\n\n- [WalkOS](https://walkos.aishashok.com) — A walking reminder that lives in your MacBook notch ($4.99)\n\n## License\n\nMIT — use it for anything.\n",
  "bytes": 4785,
  "sha": "8f1eebd8ac3893a7fb405b99a58c7d7b699de6c1401b4758f5c6435e4bbf282f",
  "repo_slug": "aishwaryaashok14/notch-kit",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_aishwaryaashok14_notch_kit_notchkit_e814a7b5/readme"
}