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 ·

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.

It reads the logs Claude Code keeps in ~/.claude on your Mac. There’s nothing to configure, and nothing is sent anywhere. 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.