Get notified when an agent is waiting on you across many parallel sessions
Stay responsive to agent approval requests when running multiple sessions in parallel without constantly checking each one.
- CLI
- 0.2.17
- Preview ref
- a2c45c8
When three or four agent sessions run in parallel, each on a different part of a project, it is easy to miss the moment one stops and waits for approval. By the time you notice, 20 minutes have passed.
The sessions are making progress, but you are the bottleneck.
TL;DR
- Enable push notifications in Settings → Notifications
- Enable permission request notifications
- Use the Inbox to see all pending requests in one place
- Notification actions (Allow/Deny) let you respond without opening the app
- For many sessions: check Inbox periodically, not individual sessions
The problem
Running multiple agents means:
- Each session can block on a permission prompt
- You can't watch all sessions at once
- Switching between sessions to check status wastes time
- By the time you notice a blocked session, the delay compounds
The bottleneck isn't the agents. It's you noticing they're waiting.
Common approaches and their trade-offs
- Check each session manually: tedious, and it is easy to forget which ones you already checked.
- Keep multiple terminal windows open: Hard to see which one has a pending prompt.
- SSH and run status checks: better, but you still have to remember to check.
Happier's Inbox and notifications solved this:
- One place to see all pending requests
- Push notifications when any session needs attention
- Notification actions for quick responses
If you're new to Happier
Happier is an open-source companion app for AI coding agents like Claude Code, Codex, and OpenCode.
The workflow here: run multiple agents in parallel while Happier tracks which ones need your attention and notifies you on your phone.
Get set up:
- How to run Happier from your phone
- GitHub: https://github.com/happier-dev/happier
- Install: https://github.com/happier-dev/happier#how-it-works
- Discord: https://discord.gg/W6Pb8KuHfg
Step-by-step: enable notifications for waiting agents
1) Enable push notifications
From the Happier app:
- Go to Settings → Notifications
- Enable Push notifications
- Grant notification permissions when prompted (iOS/Android)
This allows the app to send notifications even when it's not open.
2) Configure notification types
In the same settings screen, enable:
- Permission requests: Notifies when an agent asks for tool permission
- Ready notifications: Notifies when a turn finishes and the agent is idle
These are the two main "agent is waiting" states.
3) Configure notification detail level
Choose Request previews:
- On: Notifications include the command/file being requested (more context)
- Off: Generic "Permission needed" notifications (more private)
From Notifications setup docs:
With previews enabled, permission notifications include the requested command or file path and any supplied explanation.
For parallel sessions, On is the recommended setting so you can triage without opening every session.
4) Test it works
- Start a Claude Code or Codex session
- Let it hit a permission prompt
- You should receive a notification on your phone
From the notification:
- Tap to open the session
- Or press Allow / Deny to respond immediately
Use Inbox to triage multiple waiting sessions
When you have many parallel sessions, Inbox becomes your triage view.
What Inbox shows
From the Happier app:
- Tap Inbox (home screen or bottom nav)
- You'll see all items that need attention:
- Permission requests
- Approval requests
- User-action requests (like "Exit Plan Mode")
- Shared session activity
Why Inbox matters for parallel sessions
Instead of:
Session 1 → check for prompts → back
Session 2 → check for prompts → back
Session 3 → check for prompts → back
Session 4 → check for prompts → backYou do:
Inbox → see 2 pending requests → handle them → doneFrom Inbox and approvals docs:
Inbox is the action center for approval requests, pending permission requests, and incoming friend-related attention items.
Responding from Inbox
Tap an inbox item:
- Opens the session with the request in focus
- Shows the request context
- Lets you Allow/Deny/Approve
Inbox items disappear once handled.
Notification actions: respond without opening the app
On iOS and Android, permission notifications support actions:
- Allow: Approve the request immediately
- Deny: Reject the request immediately
These actions work when:
- The notification targets a server already active in the app
- Or the notification targets a saved server profile
From Notifications routing docs:
Happier only auto-sends a permission response when the notification's server is already active or already saved on the device.
If you're at your computer with Happier open, the notification setting added in 0.2.16 mutes phone pushes while Happier is focused on a computer. When computer focus can't be established, pushes still reach the phone.
For safety: if the notification targets an unknown server, Happier routes you to add/switch servers instead of silently approving.
A workflow for many parallel sessions
Morning setup
- Start all your agent sessions (Claude Code, Codex, etc.)
- Each session gets its first prompt or starts working
- Open Happier Inbox: empty (good)
During the day
- Notifications arrive when agents need decisions
- Check notification preview:
- If straightforward: press Allow or Deny
- If needs context: tap notification → open session → review → respond
- Periodically check Inbox (every hour or when switching tasks)
- For a session you've read but want back later, use Remind me on its row (shipped in 0.2.13). It leaves Needs attention until the reminder time, then comes back even if nothing new happened. Reminders change in-app attention state and don't send a push.
- Respond to pending requests in batch
End of day
- Open Inbox: see any remaining blocked sessions
- Triage: approve legitimate requests, deny exploratory ones
- Sessions continue overnight (or stop them if done)
When to use notifications vs polling Inbox
Use notifications when:
- You want real-time awareness
- Each decision is time-sensitive
- You're mobile and can't check frequently
Use Inbox polling when:
- You batch-process approvals every hour
- Notifications would be too noisy
- You prefer scheduled check-ins
Use both when:
- Notifications alert you to urgent requests
- Inbox shows the full picture when you're ready to triage
Notification routing across multiple servers
If you're running self-hosted relays or multiple relay profiles:
- Notifications include which server the request came from
- Tapping routes you to the correct server
- If the server isn't saved yet, Happier prompts you to add it
From Notifications routing docs:
If the notification targets a saved server profile that is not currently active, Happier auto-switches to that profile so the deep link works.
Troubleshooting
Symptom: Not receiving notifications
Likely cause:
- Push notifications disabled in app settings
- Notification permissions not granted to the app
- The device doesn't have an active push token
Fix:
- Check Settings → Notifications → Push notifications is enabled
- Check device settings: Notifications → Happier → Allow Notifications
- Restart the app to register a new push token
- Test with one session to verify
Symptom: Notifications arrive but actions don't work
Likely cause:
- The notification targets an unknown or inactive server
- The app version is too old to support notification actions
Fix:
- Ensure the server profile is saved in Settings → Relays
- Update the Happier app to the latest version
- Try tapping the notification instead of using actions
Symptom: Inbox is empty but I know sessions are waiting
Likely cause:
- The sessions are on a different relay/server
- You're looking at the wrong account/profile
- The requests were already handled
Fix:
- Verify which server is active: Settings → Relays
- Switch to the correct server if needed
- Open each session manually to check their status
- Requests disappear from Inbox once handled
Symptom: Too many notifications (overwhelming)
Likely cause:
- All notification types are enabled
- Many sessions hitting prompts frequently
Fix:
- In Settings → Notifications, disable less urgent types
- Set Request previews to Off to reduce lock screen noise
- Consider setting In-app notifications to Silent or Off
- Rely more on Inbox polling and less on push
Common questions
Do notifications work with self-hosted relays?
Yes. The relay routes notifications through Expo's push service.
Your self-hosted relay needs internet access to reach Expo's API, but no special firewall rules.
Can I get notifications on desktop too?
The desktop app shows in-app notifications but does not currently support system push notifications.
Use the mobile app for push, or check Inbox from desktop periodically.
What if I miss a notification?
Missed notifications don't disappear. The request remains in Inbox until you handle it.
You can also:
- Check Inbox manually
- Open the session directly
Can I send approval requests to a webhook instead?
Yes. From Settings → Notifications → Webhook notifications, you can send the same events to an HTTP endpoint.
This is useful for:
- Internal dashboards
- Slack/Discord bots
- Home automation triggers
See Notifications setup docs for webhook configuration.
Does this work when running 10+ sessions?
Yes, but consider:
- Inbox scales better than individual session checking
- Notification previews help you triage without opening each session
- You may want to tune notification types to reduce noise
Related guides
- How to approve Claude permissions from your phone
- How to fix "waiting for approval" in Claude Code, Codex, and OpenCode
- How to run multiple Claude Code, Codex, and OpenCode sessions in parallel
- How to queue messages from your phone while an agent is busy
Get Happier
Happier is an open-source app that lets you run and orchestrate Claude Code, Codex and other agents cross-device, from your phone, desktop or the web.