NemoNotch

An interactive floating panel for the MacBook notch area, turning the notch into a multi-purpose information hub.

Real-time AI session & agent status.

中文文档

Features

6 Functional Tabs

Highlights

• Notch Floating Panel — Hovers over the notch area, auto-detects notch size

• Multi-AI Provider — Unified interface for Claude Code, Gemini CLI, and opencode with hook event listening, session tracking, and permission interception. opencode integrates via a NemoNotch-written plugin (~/.config/opencode/plugin/nemonotch-notify.ts) that POSTs lifecycle events to NemoNotch's hook server — badge, completion flash, toast, and AI tab status card all work automatically

• AI usage quota — shows your Claude Code, Codex, and Gemini usage quotas (utilization % + reset countdown) as a card in the AI tab, read from each CLI's OAuth credential. The Codex and Gemini sections appear automatically when those CLIs are signed in.

• Global Shortcuts — Toggle panel: configure your own in Settings → Hotkeys (no default). Tab switches default to ⌥⌘1-5. All bindings are user-customizable, powered by KeyboardShortcuts

• Smart Auto-Switch — Automatically selects the active tab (AI working, music playing, etc.)

• Activity Glow — When AI/agents are busy (working, or waiting for approval), the expanded notch shows a soft blurred glow in the app's theme orange along its lower inner edge, fading out by the middle (content stays clean)

• Completion Flash — When an AI session or agent finishes a turn (working→idle), NemoNotch plays a one-shot full-screen accent-orange edge glow on all screens, plus a HUD-style toast capsule near the notch showing the finished project/agent name(s). Rapid completions are throttled and merged into the visible toast rather than replaying the flash. Toggleable in Settings.

  

• Menu Bar Entry — Fixed pixel-art notch icon (state is visible on the notch panel above the menubar); menu shows Now Playing controls (previous / play-pause / next) when media is active

• HUD Overlay — Volume, brightness, and battery level indicators with segmented bars

• i18n — Supports English and Simplified Chinese, switchable in Settings

• Explicit permission requests. NemoNotch does not auto-request permissions on launch. Each feature surfaces a "Grant Access" button (Calendar in the Overview tab, Location in the Weather card) — click to invoke the system dialog. Media control needs no permission at all — it goes through the Perl bridge.

• ESC closes the notch. Press ESC any time the notch is opened.

Tech Stack

• Swift 6 + SwiftUI, native macOS app
• AppKit — Custom NSWindow, click-through, multi-screen positioning
• MediaPlayer / MediaRemote — Media playback control
• EventKit — Calendar event access
• IOKit — System monitoring (CPU, memory, battery, disk)
• libproc — Per-process resource tracking via kernel APIs
• CocoaLumberjack — Logging (~/.NemoNotch/logs/, 7-day rotation)
• KeyboardShortcuts — User-customizable global hotkeys (replaces Carbon RegisterEventHotKey)
• WebSocket / Unix Socket — AI CLI Hooks & OpenClaw communication
• HTTP API — Hermes-agent monitoring via localhost:8787

Project Structure

NemoNotch/
├── NemoNotchApp.swift           # Entry point, MenuBarExtra, global hotkeys
├── Models/                      # Data models (Tab, AppSettings, AIProvider, PlaybackState, etc.)
├── Notch/                       # Notch UI core (window, animation, event handling, TabBar, HUD)
├── Tabs/                        # Tab content views (AIChatTab for unified AI sessions)
├── Services/                    # Background services (media, calendar, AI CLI monitor, launcher, etc.)
├── Settings/                    # Preferences UI
└── Helpers/                     # Utilities (MarkdownRenderer, ClaudeCrabIcon, ToolStyles)

Build

1. Open NemoNotch.xcodeproj in Xcode
2. Select the NemoNotch target
3. Build & Run (requires macOS 14+)

Note: If macOS blocks the app on first launch, run the following command to remove the quarantine attribute:

sudo xattr -d com.apple.quarantine /Applications/NemoNotch.app

Acknowledgements

NemoNotch draws inspiration from the following open-source projects:

Notch Window & Interaction

• NotchDrop — Notch window positioning, multi-screen support, click-through
• DynamicNotchKit — Spring animations, auto-dismiss, content switching
• Peninsula — Multi-view state management in the notch area

Media & Playback

• PlayStatus — MediaRemote framework integration, media key interception
• Tuneful — Now playing info & UI
• nowplaying-cli — CLI tool for now playing info
• mediaremote-adapter — Perl bridge for media control on macOS 15.4+ (bypasses the private-API signature gate)

Window Management & Shortcuts

• Loop — Global hotkey registration, window operations
• DSFQuickActionBar — Floating search bar component

Display & System Monitoring

• MonitorControl — Display brightness reading via DisplayServices API

Menu Bar & System Tools

• eul — Menu bar architecture, Combine reactive patterns
• menubar_runcat — Menu bar status animation

Launcher & UI Components

• sol — App launcher architecture
• Luminare — SwiftUI component library & design language

AI & Desktop Integration

• Vibe Notch — Claude Code notch notifications, session monitoring, permission approval UI
• masko-code — Claude Code status monitoring & desktop overlay concept

UI & Design

• Notch Pilot — Visual reference for the notch panel's layout, tab structure, and console-style header treatment

License

MIT