Unified Notifications.
Native Rust Performance.
Dispatch Slack messages, Gmail REST API emails, native desktop toast banners, and modal GUI dialogs from your terminal and autonomous AI agent workflows.
$ notify system --title "Deploy Ready" --description "All test suites green" status: ok type: system_notification title: Deploy Ready description: All test suites green delivered: true $ notify slack alerts --message "Build v1.0.0 released" --json { "status": "ok", "provider": "slack", "profile": "alerts", "webhookUrl": "https://hooks.slack.com/...X00", "delivered": true }
Why Developers & Agents Choose Notify CLI
Engineered for deterministic terminal automation, maximum security, and instant feedback.
Slack Webhooks
Send text alerts, custom JSON payloads, and Slack Block Kit components directly to incoming webhooks with optional channel/bot overrides.
Gmail REST API
Deliver emails with automatic HTML detection, plain-text fallbacks, multi-recipient routing (To, CC, BCC), attachments, and draft creation.
Native Desktop Alerts
Trigger non-blocking toast notifications on macOS (osascript), Linux (notify-send), or Windows balloon alerts via PowerShell.
Modal Message Boxes
Prompt operators for critical confirmation with modal dialogs on macOS, Linux (zenity), and Windows (System.Windows.Forms.MessageBox).
Native OS Keystores
Secrets never touch plaintext files without explicit opt-in. Saved securely into Apple Keychain, Windows DPAPI, or Linux Secret Service.
Agentic Architecture
Emits YAML by default for human terminals, raw JSON with --json, structured stderr error envelopes, and self-documenting agent-readme.
Command Reference
Comprehensive command syntax across all notification providers.
| Command | Description | Example Usage |
|---|---|---|
notify system |
Display native OS desktop notification toast | notify system --title "Done" --description "Tests passed" |
notify message-box |
Show a modal dialog message box (blocks until dismissed) | notify message-box --title "Confirm" --message "Deploy now?" |
notify slack |
Send message or Block Kit payload to Slack webhook | notify slack alerts --message "Build green" |
notify email |
Send email or create draft via Gmail API with attachments | notify email work --to "team@ex.com" --subject "Report" |
notify accounts list |
List configured notification accounts & profile credentials | notify accounts list --check |
notify accounts add |
Store new Slack or Email profile credentials in OS keystore | notify accounts add alerts --type slack --webhook-url "..." |
notify agent-readme |
Print embedded agent operating manual in markdown or JSON | notify agent-readme --json |