See when Claude Code or Codex is waiting for you

Updated

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

  1. Install QNotch and open it.
  2. Open Settings, Agents and click Connect next to Claude Code or Codex.
  3. If you connected Codex, it asks you to trust the hooks once. Say yes.
  4. 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.