CodexUse notifications and sound alerts
CodexUse 2.5 adds real notification support: system alerts when a chat needs your input, and audible success/error sounds so you know what happened without staring at the screen.
Key takeaway: System notifications and sound alerts are now built in. Combined with in-app rate-limit radar and auto-roll, you have multiple layers of awareness.
What signals exist in 2.5
- System notifications: OS-level alerts fire when a running chat needs your response (approval request, user input) and when long-running turns finish.
- Notification sounds: A success sound plays on task completion, an error sound plays on failures. Volume is normalized at a comfortable level (gain: 0.05) using the Web Audio API.
- Sound test button: Go to Settings to preview both sounds before relying on them.
- Rate-limit radar (Pro): Live usage snapshots per profile in the Profiles dashboard.
- Auto-roll status (Pro): In-app messages when auto-roll is armed or switching profiles.
Setting up notifications
System notifications
- Make sure your OS allows notifications from CodexUse. On macOS, check System Settings → Notifications.
- Notifications trigger automatically when a chat needs your response or when a turn completes.
- No manual configuration needed inside CodexUse — they work out of the box.
Sound alerts
- Sound alerts are enabled by default in 2.5.
- Go to Settings → Display & Sound to test the success and error sounds.
- Sounds use the Web Audio API with normalized volume, so they stay consistent regardless of system volume.
When each signal fires
| Event | System notification | Sound |
|---|---|---|
| Chat needs approval (exec, patch) | Yes | No |
| Long-running turn completes | Yes | Success |
| Turn fails with error | No | Error |
| Rate limit approaching (Pro) | No (in-app radar) | No |
| Auto-roll switches profile (Pro) | No (in-app status) | No |
Troubleshooting
| Symptom | Likely cause | Action |
|---|---|---|
| No system notification appears | OS notifications disabled for CodexUse | Check System Settings → Notifications on macOS. On Linux, make sure a notification daemon is running. |
| No sound plays | System volume muted or audio output misconfigured | Check system volume. Use the test button in Settings → Display & Sound to verify. |
| No rate-limit info | Pro not active or no recent usage | Activate Pro and run a Codex session to refresh data. |
| Auto-roll never switches | Active chat running or no alternate profile | Finish the active chat or add another profile. |
Related
Does CodexUse send system notifications?
Yes. Starting with 2.5.0, CodexUse sends system notifications when a chat needs your response and when long-running turns complete.
How do I know when rate limits are close?
Use the rate-limit radar cards in the Profiles dashboard (Pro). You can also enable auto-roll so CodexUse switches profiles before limits block you.
Is there any audible alert?
Yes. CodexUse 2.5 plays a success sound when tasks complete and an error sound when something fails. Volume is normalized and you can test sounds from Settings.