How to know when Claude Code is done (without watching the terminal)

Get told when Claude Code finishes or needs you: terminal notifications, Claude Code hooks, and a Done alert in the MacBook notch.

By Rudra Satani, maker of NotchMind · · Updated

Give Claude Code a task, switch to something else, and the hard part is noticing when it’s finished or waiting for your answer. A few ways to get a nudge:

Claude Code’s own notifications

Claude Code can notify you when it needs input. In a session, open /config and look for the notification setting; depending on your terminal, it can use the terminal’s own notifications or a bell. Some terminals, like iTerm2, also show a badge or bounce the Dock icon.

Hooks

Claude Code supports hooks: commands it runs at moments like when it stops or sends a notification. A hook can play a sound or post a macOS notification, for example with osascript -e 'display notification "Claude is done"'. Check Claude Code’s documentation on hooks for the exact setup.

The notch

NotchMind, which I make, shows Claude Code in the MacBook notch while it works: the project, the task, its latest steps and the lines it changed. When it ends its turn, the notch shows Done for a minute, above everything else, so you notice even if you’re in another app. If you run several sessions, it shows the most relevant one and how many more there are.

Set it up in NotchMind

  1. Open Settings → Coding Agents and turn on Coding agents live activity.
  2. Turn on Tell me when an agent finishes if you want the Done alert.
  3. Start a Claude Code session in your terminal and give it a task. The notch reads the session logs in ~/.claude on your Mac; no API key or additional login is needed.

The activity also supports Codex, using its local ~/.codex logs. These session logs are only read, never changed or uploaded. This describes coding-agent monitoring; optional Smart Mode is a separate feature.

With several sessions running, the notch chooses the most relevant one. The Done alert marks the end of an agent’s turn, not proof that its code is correct or its tests passed. For setup details and switching back to Home while an agent works, see coding agents in the notch.

About the author

Rudra Satani makes NotchMind, a notch app for Mac, so read anything about notch apps here with that in mind. Spotted a mistake? Email support@notchmind.com, or reach out at @rudraxx13.