Agent notifications
If you run Claude Code or Codex for any real length of time, you know the pattern: the agent works for twenty minutes, then stops dead on a permission prompt and waits — possibly forever, if you’ve walked away.
TermBridge watches for that pause and sends a push notification the instant it happens — even when the app is closed.
Tap to jump back in
Tap the notification and TermBridge opens to the agent that’s waiting, so you can approve or redirect without digging through a session list. (Today the tap opens the app at the waiting agent; landing directly inside that exact terminal pane is rolling out next.)
This is the feature that makes it comfortable to kick off a long run and actually close the laptop.
What triggers a notification
Notifications fire when an AI coding agent — currently Claude Code — appears to be waiting on you: a permission prompt, a question, or a request for input. TermBridge detects this by watching the agent’s own state, not by guessing at arbitrary shell prompts. So a plain read in a bash script won’t ping you; a Claude Code approval prompt will. A process that’s simply running doesn’t notify you — only one that’s blocked waiting for a human.
Enabling notifications
- In TermBridge, open Settings → Notifications & approvals and turn them on.
- Allow notifications when iOS prompts you (or later in iOS Settings → Notifications → TermBridge).
Pushing is handled over Apple’s Push Notification service. The notification content is minimal — it tells the app which agent is waiting, not what it’s doing — and your terminal data stays end-to-end encrypted on the same secure path as everything else.
Next
Curious how the secure path works? Read the Security model.