See when Claude Code or Codex is waiting for you
You start a task in Claude Code or Codex, switch to something else, and come back twenty minutes later to a terminal that has been waiting on a yes/no question the whole time. QNotch puts every session at the top of your screen, so you see the moment one needs you.
What you get
- Every session by name. The notch and the Agents tab list each Claude Code and Codex session by its title, with its status: working, needs you or done.
- A nudge when one needs you. On Windows the pill widens for a moment with the session's name. On a Mac the wings beside the notch say so. Both play a soft sound, except in Game mode or while you are in a call.
- One click back. The button on a session opens it in the Claude or Codex app. For a terminal session, it brings that terminal to the front.
- What each session costs. Today's tokens for each Claude Code session, and what they would cost at API list prices. On a Pro or Max plan that is not your bill, just a measure of what you are getting out of the plan.
- What it left running. The dev servers and test runners a session started, with their memory, CPU and ports, and a Stop button for any that outlived their session.
Set it up
- Install QNotch and open it.
- Open Settings, Agents and click Connect next to Claude Code or Codex.
- If you connected Codex, it asks you to trust the hooks once. Say yes.
- Start a session as usual. It shows in the notch within a moment.
The welcome tour offers the same Connect step on first start, so a new install may already be set up.
What Connect changes
Connect adds a hook to Claude Code's settings.json or Codex's hooks.json, and keeps a backup of the file first. Your own hooks stay as they are. The hook talks to QNotch on your computer only: over a local pipe on Windows and a Unix socket on a Mac. Token counts come from the transcripts Claude Code already keeps on your computer, so nothing about your sessions leaves it.
Only want a toast?
If you would rather not connect the Agents tab, a single hook can post a notification with a button back to the session whenever Claude waits for you. Add this to ~/.claude/settings.json on Windows:
{
"hooks": {
"Notification": [
{ "hooks": [{ "type": "command", "command": "C:\\path\\to\\QNotch.exe notify \"Claude needs you\" --app \"Claude Code\" --icon chat --focus" }] }
]
}
}On a Mac, use the path to the app's executable instead: /Applications/QNotch.app/Contents/MacOS/QNotch notify "Claude needs you" --app "Claude Code" --focus. The guide to script notifications covers the rest of that command, and the notifications reference has every option.
Good to know
- Agent sounds stay quiet in Game mode and while an app uses your microphone. Choose the sounds in Settings, Sounds.
- Don't use the Agents tab? Turn it off in Settings, Features and QNotch does not load it.