Claude Code, in your notch.
Approve a command without leaving your editor. See what the session is costing, how much context is left, and when your limits reset. Watch every project you have Claude running in, from the one place on a Mac you are always looking at.
Works with Claude Code, and Codex (beta)
Free for personal use · macOS 13+ · Apple Silicon and Intel
See it in action
One click, and you're back to work
Claude Code asks, the notch answers. Approve, deny, or read the diff without ever leaving your editor.
Features
Everything Claude needs, up in the notch
ClaudeNotch mirrors the prompts Claude Code shows in your terminal, then lets you handle them without breaking focus.
Permissions in the notch
Allow, Deny, or Always-Allow a command or edit right in the notch, then your keyboard is back in the terminal. No app switching, no lost focus.
See the diff first
Edit and Write requests show a red and green diff inside the card.
Guardrails for risky commands
rm -rf, sudo, and force-push get a red warning and a press-and-hold to confirm.
Cost, context, and plan limits
Live session cost and context left, plus your 5-hour and weekly usage with reset countdowns.
Every session at a glance
Run Claude in five projects at once and see what each is doing, its branch, and its spend.
Claude Code and Codex (beta)
Turn on Codex support and your OpenAI Codex sessions show up in the notch too: status, context, resume, and a task bar, each tagged so you know which is which.
Drop a folder onto the notch
Drag a folder onto the notch and Claude opens a session right there.
One settings window
Alerts, budgets, a sound per pop-up, the pet, and a usage heatmap. Open with ⌥⌘,.
Pet Mode
A creature lives in your notch, reacts to the run, and backflips when you boop it. One click to turn off.
In motion
A few things it does
Short clips of ClaudeNotch at work, from launching a session to the pet that keeps you company.
One settings window for everything
A sidebar leads to a page for every part of ClaudeNotch, from sounds and the pet to plan limits, spend, and resuming past sessions. Search the top to jump straight to any setting.
Start a session from the notch
Drag a project folder onto the notch and a Claude Code session opens in that directory. No terminal, no cd.
A pet that reacts to your session
The mascot lives in the notch and animates around what Claude is doing, so a glance tells you the state.
Little moments of delight
Playful touches make the notch feel alive while you work.
How it works
Up and running in three steps
Install and run setup
Open the app and click through the one-click setup. It grants accessibility and input permissions, then wires ClaudeNotch into Claude Code's hooks.
Run Claude Code
Start a session in any terminal, exactly like you always do. No flags, no wrappers, nothing new to learn.
Respond in the notch
Prompts appear up top. Press Enter to allow, Esc to deny, and keep working without switching windows.
Install
Get set up in under two minutes
Works on notched MacBooks and ordinary Macs alike. On a Mac without a notch it draws a Dynamic-Island-style pill instead.
- 1
Download ClaudeNotch.dmg
Grab the latest release. The link always points to the newest build.
- 2
Drag it to Applications
Open the disk image and drag ClaudeNotch into your Applications folder.
- 3
First-launch warning (one time)
macOS blocks the first launch. Click Done, then open System Settings → Privacy & Security and click Open Anyway next to ClaudeNotch. Or install with Homebrew below to skip this entirely.
- 4
Run the Setup window
It walks you through Accessibility and Input Monitoring, then installs the Claude Code hooks. It backs up your ~/.claude/settings.json first.
- 5
Start coding
Launch a Claude Code session in your terminal. Prompts now appear in the notch.
Requirements
- macOS 13 (Ventura) or later
- Apple Silicon or Intel
- Claude Code CLI installed
- jq recommended (brew install jq) for the live activity line
Works with Claude Code in any terminal, including the one inside VS Code. The Claude Code VS Code extension panel does not fire hooks yet, so use the CLI there.
Download ClaudeNotchOr install with Homebrew
brew install --cask rawsun007/tap/claudenotch
Click to copy. One line, and Homebrew fetches the tap and installs.
FAQ
Questions, answered
Yes. Free for personal and any noncommercial use, and the full source lives on GitHub. Commercial use needs permission first, so just ask the author.
Built by
Roshan Ramani
Indie developer building small tools that make Claude Code feel at home on the Mac. ClaudeNotch is one of them. Say hi or follow along.
Stop alt-tabbing to your terminal.
Keep Claude Code flowing and approve everything from the notch. Free for personal use, and ready for your Mac.
Free for personal use · macOS 13+ · Apple Silicon and Intel