Working
The agent’s icon sits next to the camera while it runs. Glance up instead of checking the terminal.
Claude Code and Codex on macOS
Know when your coding agent needs you.
Simple Notch shows whether Claude Code or Codex is working, waiting on you, or finished, and how close you are to your usage limits. Stop checking the terminal every few minutes.
7-day free trial · No account needed · macOS 14 Sonoma or later
At a glance
Every state you care about, beside the camera.
Needs permission
A hand badge appears the moment Claude Code stops to ask before running a tool.
Needs input
A question badge tells you the agent is waiting for an answer from you.
Usage limits
Open the drawer to see how much of your 5-hour and weekly windows you’ve used.
A warning color appears as you approach a limit, and failed runs are marked too. No notch? The same status shows in a floating pill on any display.
Setup
One click for Claude Code. Nothing for Codex.
Claude Code
- Open Settings › Coding Agents and click Connect.
- Simple Notch adds one hook command per event to ~/.claude/settings.json and keeps a backup of the original.
- Optionally turn on usage limits. Your own status line keeps working exactly as before.
Codex
- Nothing to install. Tasks from the Codex desktop app show up on their own.
- Simple Notch checks the task list every 15 seconds. Tasks move to Recent once they go quiet.
- Rate limits come straight from Codex, read only when they’re needed.
Built to be trusted with your tools
It watches. It never steers.
Documented interfaces only
Claude Code hooks and status line input, and the Codex app’s own task and rate-limit data. No scraping.
Can’t block an agent
The hook prints nothing and always succeeds, so your agent runs exactly as it would without Simple Notch.
Stays on your Mac
Events are written to a local folder and read locally. Disconnect removes exactly what was added.
FAQ
Coding agent questions.
Which coding agents does Simple Notch support?
Claude Code and the Codex desktop app. Claude Code reports its status through hooks you connect once in Settings. Codex desktop tasks appear automatically, with nothing to install.
Does it change my Claude Code settings?
Only when you click Connect. Simple Notch adds one hook command per event to ~/.claude/settings.json and keeps a backup of the original. Disconnect removes exactly those entries. If the file isn’t shaped as expected, Simple Notch leaves it untouched.
Can it block or slow down an agent?
No. The hook script prints nothing and always exits successfully, so it can’t block or steer an agent. It only writes the event to a folder on your Mac for Simple Notch to read.
How are usage limits shown?
For Claude Code on Pro and Max plans, Simple Notch shows the 5-hour and weekly windows from sessions you run in the terminal, and your own status line keeps working as before. Sessions in the Claude desktop app don’t report limits. For Codex, it reads the rate limits from Codex itself. You get a warning as you approach a limit.
Is my code or agent activity uploaded anywhere?
No. Agent events are written to a folder on your Mac and read locally. Simple Notch doesn’t send them anywhere.
Do I need a MacBook with a notch?
No. On external displays and Macs without a notch, agent status shows up in a floating pill at the top of the screen.
Keep coding. The notch will tell you when it’s your turn.
Music, weather and your apps come with it. Every feature is free for 7 days.