claudeers.
// Automation & Workflows

nosynotch

Your MacBook notch keeps an eye on Claude Code, Codex and Cursor: live status, approve commands with a click or a nod, usage limits, and your music while the…

// Automation & Workflows[ cli ][ api ][ desktop ][ web ][ mobile ][ claude ]#claude#ai-agents#claude-code#codex#cursor#developer-tools#dynamic-island#macos#automation◷ MIT$open-sourceupdated 13 days ago

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up nosynotch (npm project) into my current project.
Found on https://claudeers.com/nosynotch
Repo: https://github.com/ddkbs/nosynotch
Homepage/docs: https://nosynotch.davidkubus.dev
Detected install method: npm → npm install nosynotch
Category: automation. Platforms: cli, api, desktop, web, mobile.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
unknown; community-verified: false. Confirm the source before running anything.
// or install directly (npm)
npm install nosynotch
// or clone
git clone https://github.com/ddkbs/nosynotch

// compatibility

Platformscli, api, desktop, web, mobile
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguageSwift

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

Nosy Notch

Your MacBook notch keeps an eye on Claude Code, Codex and Cursor –
with Nosy, a tiny helper who lives in it.

Nosy Notch: Claude thinks, uses tools, asks for permission and finishes

npx nosynotch · macOS 14+ · free · no account, no App Store, no Xcode

Coding agents spend a lot of time working on their own – and then sit there waiting for a "yes" you never saw. Nosy Notch turns the black notch of your MacBook into a tiny status display: it slides open while an agent thinks, shows which tool it's running, waves when it needs you, and throws confetti when it's done. You can approve a command right there, with a click or a nod of your head – or read the conversation and reply without leaving what you're doing. Living in the notch is Nosy, a little helper who works along, cheers when a task is done and falls asleep when nothing happens. And in between, the notch is your music player, file shelf, focus timer and meeting reminder.

Working
Live status
Thinking, the tool it's running, how long it's been
Needs you
Allow from the notch
Deny · Always allow · Allow – or just nod
Done
Done
Checkmark, confetti and the gist of the answer
Unseen
Didn't see it?
A green dot waits until you look
Usage
Every session, every limit
Hover for all sessions, context fill and usage limits
Music
Music in between
Spotify / Apple Music, with an equalizer that follows the beat
Nosy
Meet Nosy
Peeks out, follows your pointer, dives back into the notch
Chat
Reply from the notch
The conversation and a reply field, right there
Shelf and AirDrop
Shelf and AirDrop
Drag files onto the notch
Meeting
Your next meeting
A heads-up 10 minutes before, Join in one click

→ Every animation, explained

Install

npx nosynotch

That one command downloads the app to ~/.nosynotch/, connects every agent it finds and starts Nosy Notch in the background – no Dock icon, just a ✦ in the menu bar. You need Node.js 18+ for npx (brew install node works too).

Two small things afterwards: restart Claude Code sessions that were already running, and – if you use Codex – trust the new hooks once in Codex (ChatGPT app → Codex → Settings → Hooks, or /hooks in the CLI). Codex runs no hook you haven't trusted.

More commands
npx nosynotch demo        # play every animation
npx nosynotch settings    # open the settings window
npx nosynotch status      # what is installed and running
npx nosynotch autostart   # start at login (autostart off to disable)
npx nosynotch stop
npx nosynotch uninstall   # removes app, hooks and autostart

Works with

Live statusAllow / deny in the notchUsage limitsContext fill
Claude Code – terminal, VS Code, desktop app✓✓✓ Pro / Max✓
Codex – CLI and the ChatGPT app's Codex mode✓✓✓✓
Cursor – Cursor's agent✓✓ commands outside its sandbox–✓

Cursor doesn't share its usage limits with any hook, so that column stays empty for now.

Several sessions at once are no problem, mixed across agents. Each one gets a small badge and its own colour: orange for Claude, blue for Codex, silver for Cursor. Macs without a notch get a virtual one in the middle of the menu bar.

What the notch does

While an agent works, the notch slides out sideways: a spark spins on the left, the current tool on the right (terminal, pencil, magnifier, globe …). Hover it to see every session with its status, a ring for how full its context window is, and your 5-hour and weekly limits as bars. If a limit was at 80 % or more, the notch tells you the moment it resets. A click on a session brings its terminal or app to the front.

When it needs you, the notch opens with an amber glow, shakes and shows the exact command. Click Allow, Deny or Always allow – the agent carries on, no hunting for the right window. Claude Code keeps its own dialog open at the same time, so you can answer wherever you are. With head gestures turned on, a nod with your AirPods allows and a head shake denies.

When it's done, a checkmark draws itself, confetti flies and you get the start of the answer. Missed it? A small green dot stays in the notch until you switch to that app or hover the list, and after five minutes you get one gentle reminder. Already looking at the app? Then everything stays small and silent.

Want to answer? Click Reply on the done card (or the bubble next to a session) and the notch shows the conversation with a reply field. Your reply is pasted into the session's app and sent – or, if you prefer, run in the background with claude --resume / codex exec resume.

When nothing's running, Spotify or Apple Music takes over: cover on the left, equalizer on the right, a full player on hover. The agents always win – the music comes back as soon as they're done.

Meet Nosy

Nosy peeks out, gets petted and dives back into the notch

Nosy is a tiny helper who lives in your notch. Only its eyes look out of the black – they follow your pointer, and they change with your agents: focused while one thinks, looking down while it types, a sweat drop on long turns, spiral eyes while it compacts, wide eyes and a wave when it needs you, ^^ and a jump when it's done.

When the notch opens, Nosy drips out of the edge and hangs from it by its paws; when it closes, Nosy dives back in like into a puddle of tar – splash included. Bring the pointer close and it peeks out; leave it alone for a while and it falls asleep (sooner at night). Click it and it giggles.

Energy, levels and streaks – every finished task feeds Nosy, days with tasks make a streak, XP unlock a little wardrobe (headphones, glasses, cap, bow). Deliberately guilt-free: Nosy never gets sad or sick, a missed day just starts a new streak. Eight colours to pick from – Obsidian, the default, glows in the colour of the agent that's working. All of it stays in your Mac's settings, and you can turn Nosy off for the classic agent symbols.


More in the notch

  • Shelf and AirDrop – drag files onto the notch: park them on the shelf and drag them out later, or AirDrop them.
  • Focus timer – 15 / 25 / 50 minutes from the hover view or the menu bar, a ring in the notch, agent sounds stay quiet until the break.
  • Calendar – your next meeting in the hover view and a heads-up 10 minutes before, with Join for Zoom, Meet, Teams, Webex and FaceTime links. (Opt-in.)
  • Charging and AirPods – a little animation when you plug in, a heads-up at 20 %, and your headphones with left / right / case battery when they connect. (Headphones are opt-in.)

Settings

The settings window

Click the ✦ in the menu bar → Settings…

  • Agents – connect Claude Code, Codex and Cursor
  • Nosy – Nosy on or off, energy / levels / streaks, colour and wardrobe
  • Alerts – sounds, mute for 1 h / 8 h / ∞, reminders
  • Permissions – the notch buttons and head gestures
  • Usage – which limits to show, a heads-up when a limit resets, context rings
  • Extras – Shelf and AirDrop, how replies are sent, focus timer, battery, headphones, calendar
  • Music – player and the live equalizer

Mute and the focus timer are also right in the menu bar menu. Everything that needs a macOS permission (controlling your player, the live equalizer, head gestures, headphones, the calendar, replying by typing into an app) is off until you turn it on – or asks only the first time you use it.


Privacy

Everything stays on your Mac. The hooks talk to 127.0.0.1 only and nothing is uploaded. The only network requests are for album covers (Spotify's public oEmbed with the track ID, Apple's iTunes Search with artist and title). The live equalizer analyses the player's audio in memory and records nothing; head gestures only read motion while a request is open. The calendar, headphone batteries and the conversation in the notch are read locally and never sent anywhere; Nosy's progress and the shelf live in the app's settings. A reply typed in the notch goes to the session's own app (pasted with ⌘V, your clipboard is put back) or to the agent's own CLI. Approvals are protected by a secret in ~/.nosynotch/approval-token, so no other process can answer in your name.

How it works

Claude Code / Codex / Cursor ──hook (curl, ~15 ms)──▶ 127.0.0.1:7823 ──▶ Nosy Notch (SwiftUI panel over the notch)

All three agents have hooks: little commands they run at every step (prompt sent, tool started, permission needed, done …). Nosy Notch adds a one-line curl that forwards each event to the app. If the app isn't running, curl fails instantly and the agent carries on as if nothing happened – hooks never slow it down.

Where the hooks liveExtra
Claude Codesettings.json in ~/.claude, $CLAUDE_CONFIG_DIR and every ~/.claude-* account folderUsage limits and context via a silent status line – only if you don't have your own
Codex~/.codex/hooks.jsonLimits and context from its session files
Cursor~/.cursor/hooks.jsonPrints {} so Cursor never waits on it – except beforeShellExecution for commands outside the sandbox, which waits for Allow / Deny

The permission hook is the one exception that waits: it holds the request until you click in the notch. Answer in the terminal instead, or let it time out, and the agent's own prompt takes over.

Build from source

Requires macOS 14+ and the free Xcode Command Line Tools (xcode-select --install).

swift run                      # run directly
./scripts/build-app.sh --open  # build and open build/Nosy Notch.app
./scripts/record-gifs.sh       # re-record the GIFs in docs/gifs and the website videos (needs ffmpeg)
./scripts/record-gifs.sh done  # just one scene ("settings" = the settings window)

The recorder renders on a virtual clock, so no frame is ever dropped – a slow Mac just takes longer. Each scene becomes a GIF for this README (30 fps, 840 px) and an MP4 + JPG poster in website/public/demo/. Options as environment variables: FPS=60 capture rate, SCALE=3 for sharper 1680 px frames (default 2), GIF_WIDTH / GIF_FPS / GIF_COLORS, VIDEO=0 for GIFs only, WEBM=1 for VP9 WebMs too, STILLS=1 for PNG stills.

Releases: bump the version in package.json and Resources/Info.plist, push a tag vX.Y.Z. GitHub Actions builds a universal binary, attaches it to the release and publishes to npm if the NPM_TOKEN secret is set.

Project layout
bin/nosynotch.js                     npx CLI (download, hooks, start/stop, autostart)
Sources/NosyNotch/
├── main.swift / AppDelegate.swift   app lifecycle, menu bar item, CLI flags
├── EventServer.swift                tiny HTTP server (Network.framework, loopback only)
├── HookEvent.swift                  hook JSON → event (Claude, Codex and Cursor dialects)
├── SessionStore.swift               event stream → state per session, unseen results, reminders
├── Session.swift                    states, agents, tool icons/labels, colours, error texts
├── HookInstaller.swift              hooks for Claude Code, Codex and Cursor
├── Approvals.swift                  permission requests waiting for Allow / Deny
├── HeadGestures.swift               nod / shake with AirPods
├── Usage.swift                      usage limits and context fill
├── Nosy/                            Nosy: drawing, moods, energy / levels / streaks, hanging + tar dive
├── Chat.swift                       transcripts → conversation, sending replies
├── Shelf.swift                      parked files, AirDrop
├── Notices.swift                    charging, low battery, headphones, meetings
├── FocusTimer.swift                 Pomodoro timer
├── CalendarMonitor.swift            next meeting (EventKit)
├── NowPlaying.swift                 Spotify / Apple Music: track, cover, controls
├── AudioSpectrum.swift              live equalizer: Core Audio tap + FFT
├── Notifier.swift                   sounds, banners, mute, bringing the right app to the front
├── NotchViewModel.swift             what the notch shows and how big it is
├── NotchWindow.swift                transparent panel over the notch, hover without stealing clicks
├── Clock.swift                      wall clock, or a virtual one while recording
├── Recorder.swift                   GIF / video recorder (--record, --record-settings)
└── Views/                           notch shape, spark, confetti, media player, settings …

Not affiliated with Anthropic, OpenAI or Anysphere. Claude is a trademark of Anthropic, Codex and ChatGPT are trademarks of OpenAI, Cursor is a trademark of Anysphere.

// faq

What is nosynotch?

Your MacBook notch keeps an eye on Claude Code, Codex and Cursor: live status, approve commands with a click or a nod, usage limits, and your music while they rest. npx nosynotch. It is open-source on GitHub.

Is nosynotch free to use?

nosynotch is open-source under the MIT license, so it is free to use.

What category does nosynotch belong to?

nosynotch is listed under automation in the Claudeers registry of Claude-compatible tools.

7 views
★ 22 stars
unclaimed
updated 13 days ago

// embed badge

nosynotch on Claudeers
[![Claudeers](https://claudeers.com/api/badge/nosynotch.svg)](https://claudeers.com/nosynotch)

// retro hit counter

nosynotch hit counter
[![Hits](https://claudeers.com/api/counter/nosynotch.svg)](https://claudeers.com/nosynotch)

// reviews

// guestbook

0/500

// related in Automation & Workflows

🔓

The agent that grows with you

// automationNousResearch/⟨Python⟩★ 264,763◷ MIT[ claude ]
🔓

The API to search, scrape, and interact with the web at scale. 🔥

// automationfirecrawl/⟨TypeScript⟩★ 199,533◷ AGPL-3.0[ claude ]
🔓

🌐 Make websites accessible for AI agents. Automate tasks online with ease.

// automationbrowser-use/⟨Python⟩★ 121,235◷ MIT[ claude ]
🔓

Taste-Skill - gives your AI good taste. stops the AI from generating boring, generic slop

// automationLeonxlnx/⟨JavaScript⟩★ 110,676◷ MIT[ claude ]
→ see how nosynotch connects across the ecosystem