CodexUse notifications: rate limits, auto-roll, chat replies
CodexUse is meant to live in the tray. Notifications are how it stays useful while the window is hidden: rate limit warnings before you hit 429s, auto-roll events, and chat completion alerts.
Key takeaway: Turn on notifications once, then let CodexUse watch the boring
stuff in the background.
What you can get notified about
- Rate limits: Alerts when a profile is nearing its limit.
- Auto-roll actions: Alerts when CodexUse switches profiles or needs attention.
- Chat replies: Alerts when a background chat finishes.
Enable notifications
- Open CodexUse.
- Open Settings.
- Go to Notifications.
- Click Open system settings and allow notifications for CodexUse.
- Back in CodexUse, toggle Allow notifications and pick your categories.
- Click Send test to confirm it works.
Recommended setup
- Enable Rate limits if you rely on multiple profiles to avoid 429s.
- Enable Auto-roll actions if you use auto-roll guardrails.
- Enable Chat replies if you run long tasks while working in another window.
Troubleshooting
| Symptom | Likely cause | Action |
|---|---|---|
| Send test does nothing | Notifications denied at OS level | Click Open system settings and enable notifications for CodexUse. |
| I only see alerts sometimes | The app is not running | Keep CodexUse running in the tray or menu bar. |
| Too many alerts | Categories are enabled that you do not need | Disable chat or auto-roll alerts and keep rate limits on. |
Related
Do notifications work when CodexUse is closed?
No. CodexUse must be running. Keep it in the tray or menu bar so it can show alerts while the window is hidden.
Will I get spammed with alerts?
No. You can disable categories and CodexUse uses cooldowns to avoid repeated rate limit warnings.
How do I grant notification permission on macOS?
Open Settings in CodexUse, go to Notifications, then click Open system settings and allow notifications for CodexUse.