How to get notified when Claude Code needs you or finishes
Commission sends a push notification to your iPhone when a Claude Code session on any of your machines needs approval, asks a question, has a plan for you or fails, and when a machine goes offline. Turn on Response ready in Settings › Notifications to also hear when Claude finishes a turn. On an approval, you can Allow once with Face ID, or Deny, from the lock screen.
What notifies you
Settings › Notifications in the iPhone app has one switch per kind. Each phone keeps its own choices.
- Needs approval or a question (on by default). Claude wants to run something, asks you a question, or has a plan for you to review.
- Failed run (on). A session stopped with an error. Runs you stopped yourself don't count.
- Machine offline or out of disk (on). A machine stayed unreachable for a minute, once per outage, or its disk is almost full.
- Low battery (on). A machine reached 10% on battery while sessions run there.
- Response ready (off). Claude finished a turn. The notification shows the start of its reply.
A reminder you set with Remind me always comes through, whatever these switches say.
They come from sessions on every machine you've added, not only the hub, and each one names the machine.
What each notification does
- An approval: Allow once (needs Face ID or your passcode), Deny and Open. Approving Claude Code commands remotely explains each answer.
- A question or a plan: Open, which takes you to the request to answer.
- A failed run: Open and Retry, which runs it again.
- Response ready: Open.
- Machine offline: tapping it opens Machines.
- A reminder: Open and Snooze 1 hour.
Tapping any session's notification opens that session on its machine.
Turn them on
The app never asks for notification permission on first launch. The first time something needs you, it shows a banner offering to turn notifications on. You can also turn them on in Settings › Notifications, where Send test notification checks they reach the phone. If you said no to iOS earlier, the app sends you to iOS Settings to change it.
What a notification contains
A title, such as "Fix login bug needs approval · Server", and a short preview of at most 100 characters:
- for an approval, what Claude wants to do, such as "Run: pnpm db:migrate --env staging";
- for a question, the question;
- for a failed run, the first line of the error;
- for Response ready, the start of Claude's reply.
The preview is built only from text the host has already redacted. It goes through the
secret redactor again, loses the value of anything that looks like
NAME=value, and is folded onto one line. Code and diffs are never
included.
Your hub sends notifications through Expo's push service, which passes them to Apple, over outbound HTTPS. Nothing listens on the internet. Expo and Apple see the title, the preview and when it was sent. A session title or a question can still say something private, so turn off any kind you'd rather keep on your tailnet.
Fewer interruptions
- While the app is open, you get an in-app banner instead of a system one, and nothing at all for the session on screen.
- A session's notifications stack together, and a newer one replaces the older.
- A request answered within a moment of being asked is never sent.
- A burst of more than four arrives as one summary, such as "6 updates in Commission".
On the Mac, the browser and Android
Push notifications go only to the iPhone app. In the Mac app or a desktop browser, choose Notify me when Claude needs me in Settings › You › Notifications, and Commission shows a system notification when something needs you and its window isn't in front. The Mac app also bounces its Dock icon once. These only work while Commission is open: close the window and they stop.
Push on Android comes with the Android app, which is on the way. Safari on the iPhone doesn't get push either. Using Claude Code on Android covers what works in the browser.
Commission or Claude Code hooks
Claude Code's own hooks can run a script when it needs input or stops, and many people use them to send themselves a message. That works for one machine and one terminal. Commission covers every session on every machine in one place, and lets you answer an approval from the notification instead of walking back to the desk.
Questions
Related
Hear from Claude only when it matters
Set up the hub, connect your iPhone, and turn on the kinds you want. Commission is free while it's in beta.