Todos
A simple checklist. The badge beside the notch counts how much of it is done.
For Claude Code, on your Mac
Your agents work.
The notch keeps watch.
Cloud Notch lives in your MacBook’s notch and shows which Claude Code session needs you. Allow a command, answer a question or approve a plan right there, without hunting for the window.
The notch above is live, and waits for you. Send it a status:
Hover the notch. It’s live. Tap the notch. It’s live.
Four agents. Four windows.
One of them has been waiting on you for 20 minutes.
Agents get blocked. They stop to ask a question or wait for permission, then sit there unnoticed while you are in another window. Cloud Notch answers one question at a glance: which of my agents needs me right now?
01 See
Nine states. Each with its own colour and motion.
Every agent shows exactly one status, read from what Claude Code reports about itself. Only one is a judgement call: Possibly stuck
is inferred from five minutes of silence, and a long build can look quiet. Press any card to send it to the notch.
Speaks up for outcomes
A working agent flips between running and asking many times a minute. A banner for every step would never leave the screen. So Cloud Notch raises a banner, and plays a sound, only when an agent arrives somewhere that matters.
Stays up until you’re back
A question, an approval or an error stays on screen until the agent is actually unblocked, however many times you glance at it. Step away for coffee and it is still there when you return. Rather they faded? Settings → Banners lets them go after 3 to 60 seconds.
02 Answer
Answer from the notch. Keep your place.
When an agent stops to ask, answer it where you are. Then get back to what you were doing.
- Deny with a reason. A denial can carry a sentence, like
use the test database instead
, just as you would type it in the terminal. - “Always allow” is Claude Code’s own rule. It appears only when Claude Code offers one. Cloud Notch never answers anything by itself.
- The terminal keeps working. Claude Code still shows its own prompt. Whichever answer arrives first counts, and the notch drops the prompt within a second or two.
A working replica. Go ahead and press the buttons.
03 Jump
One click back to the right tab.
Click an agent in the notch and you land where it runs.
- Terminal, iTerm2
- Its exact tab, window brought forward
- tmux inside those
- Its exact pane, then the tab showing it
- Ghostty, Warp, WezTerm, kitty
- The terminal app, brought forward
- VS Code, Cursor and other editors
- The window with that project open
04 Budget
How much plan is left, and what’s eating it.
Your Claude plan has two caps: a 5-hour window and a weekly one. Knowing where you stand tells you whether to keep going on the biggest model or switch to a lighter one.
- Claude’s official percentages, fetched live with the login Claude Code already keeps once you turn that on (it is off until you do). Figures that are out of date are dimmed and labelled. Once a window resets, its old figure is hidden.
- A live spend estimate from your agents’ own records, naming which model is using up the window. It is priced at public list rates as a measure of pace. You are not charged it.
- Memory per agent. How full each conversation is. Past 80% an agent starts summarising away its earlier work, and quality drops.
05 Hear
Tell them apart from the next room.
Each cue has its own rhythm, not just its own pitch, so a call, a knock, a fall and a tick are easy to tell apart without looking. These are the app’s actual Retro sounds. Prefer quieter? There is a macOS set too, built from the Mac’s own alert sounds.
Four agents finishing together sound like one event, not four. Two sounds are always at least 1.5 seconds apart. Mute from the speaker in the panel.
06 Tune
Make the glow your own.
While your agents work, colour swirls round the notch. Choose one of six presets or pick your own three colours. You can also stop the swirl and hold each colour in place. Try one: the notch at the top of this page changes with it.
⌘F
07 Remember
What your agents are doing, and what you still have to do.
The panel has three more tabs, so the same strip of screen covers both.
Recap
One row for each session that actually ran, grouped by day: what finished, what’s still open, and what it cost.
Todayapi · web · infra
3 done1 open$18.40
apiRefactor the payment webhook
webChoose a caching strategy
infraRun the integration suite
Notes
A scratchpad for the thought you’d otherwise lose. The panel stays open while you type.
08 Trust
Built deep, not wide.
Claude Code, and only Claude Code
Each coding agent keeps its own undocumented files, and any update can break them. Rather than half-support five tools, Cloud Notch supports one properly.
Your setup stays yours
Answering is switched on by one command you paste yourself. It keeps every hook you already have and saves your old settings alongside. An existing status line is left alone. The app itself writes only to its own folder, ~/.claude/notch-status/.
It talks to two servers
Anthropic’s, to fetch your plan figures with the login Claude Code already keeps in your Keychain, only if you turn live usage on. It never signs you in or out. And GitHub’s, once a day, to see whether a newer version is out, which you can switch off. No account and no analytics.
Signed and notarized
Every download is signed with a Developer ID and checked by Apple for malicious software before it is published. macOS still asks you before Cloud Notch can use the camera, your calendar or reminders, or control your terminal.
What it won’t do
- Start, stop or redirect an agent. It answers only when you tell it to.
- Send a new message. It answers prompts; follow-ups still go in your terminal.
- See agents on other machines, servers or in the cloud. This Mac only.
- Pick the exact tab outside Terminal and iTerm2. Other terminals are brought forward.
- Answer sessions opened before setup. Those show their questions read-only until restarted.
09 Board
Every first flight gets a boarding pass.
The welcome tour ends at your gate: a pass prints to a dot-matrix chatter and is stamped CLEARED. In the app you can share it, copy it or save it as a picture. Here, you can print one.
10 Ask
Questions, answered.
Which coding agents does it work with?
Claude Code, on purpose. Every agent tool stores its sessions in its own undocumented format that can change with any update, so Cloud Notch supports one tool properly instead of several partly.
Do I need a MacBook with a notch?
No. On a display without one, Cloud Notch draws a notch-shaped tab at the top centre of the screen, and you can choose which display it lives on. If that display is unplugged, it moves back until the display returns.
What does it need?
macOS 15.6 or later, on Apple silicon or Intel, and Claude Code. It reads your Claude Code folder, ~/.claude, where it is. Answering from the notch takes one setup command, which you copy from Settings and paste into Terminal.
How do I install and update it?
Open the disk image and drag Cloud Notch to Applications. Once a day the app checks whether a newer version is out. When one is, a blue arrow appears in the notch’s tab bar, and Settings → General shows what is new with a Download button. Nothing is installed for you, and you can switch the check off. Every version is listed in the release history.
Why isn’t it on the Mac App Store?
Some of what Cloud Notch does needs more reach than the App Store’s sandbox gives an app, such as steering Terminal, iTerm2 and tmux to the exact tab and pane an agent runs in. So it is a direct download, signed with a Developer ID and notarized by Apple.
Can it approve commands for me automatically?
No. Cloud Notch never answers a prompt on its own. “Always allow” is Claude Code’s own don’t-ask-again rule, and it only appears when Claude Code offers one.
What if I answer in the terminal instead?
That works as it always has. Whichever answer arrives first counts, and the notch drops the prompt within a second or two. If Cloud Notch isn’t running, nothing waits for it.
Does it change my Claude Code settings?
The app never edits them. The one setup command you paste adds Cloud Notch’s reporter, keeps every other hook you have, and saves your old settings alongside. From then on, the app writes only to its own folder, ~/.claude/notch-status/.
Why might macOS ask for my password?
For permission to read the login Claude Code keeps in your Keychain, which Cloud Notch uses to fetch your official plan figures from Anthropic, and only after you turn live usage on. Often it does not ask, because the access Claude Code set up for itself already covers it. If it asks and you turn it down, Cloud Notch uses the figures Claude Code’s status line reports.
Is the dollar figure what I’m being charged?
No. It shows your usage priced at public list rates, as a measure of how fast you are using up your limit. Your subscription already covers it. It counts only agents on this Mac, so your real usage is the same or higher.
How often does it update?
Agent statuses every 3 seconds, which balances speed against battery. The spend estimate and saved plan figures every 30 seconds, and live plan figures from Anthropic every 2 minutes, or whenever you press refresh.
Let the notch keep watch.
A direct download for your Mac, signed and notarized.
- macOS 15.6 or later
- Claude Code
- Best on a Mac with a notch, and works on any display