Send macOS notifications to communicate with users outside the terminal.
When to Use
Use for:
- Task completion (build done, tests passed, deploy finished)
- Errors requiring attention
- Confirmation before destructive operations
- Collecting text input (release notes, commit messages)
- Status updates during long operations
Don't use for:
- Routine progress updates (use terminal)
- Information user is actively watching
- Rapid-fire notifications (spam)
Quick Reference
| Pattern | Command |
|---|
| Alert | cb -t "Done" -m "Build complete" |
| Alert with sound | cb -t "Done" -m "Build complete" --sound Glass |
| Yes/No | cb -t "Deploy?" -a "Yes,No" --default "No" |