terminal-notifier
brew install terminal-notifier
v2.0.0
MIT
Command-line tool to send macOS User Notifications from shell scripts and automation.
Why you might care
Integrate native macOS notification center alerts into bash scripts, cron jobs, and CI/CD workflows without GUI dependencies. Useful for build completion notifications, deployment alerts, or any long-running task that needs to notify when done. Lightweight single-purpose tool that just sends notifications—nothing more.
10.2k
30-day installs · #353
30.1k
90-day · #393
84.6k
365-day · #473
7.2k
★ GitHub stars · updated 7mo ago
GitHub topics
command-line
notifications
objective-c
osx
ruby
Links
- https://github.com/julienXX/terminal-notifier
- GitHub: julienXX/terminal-notifier
- Brew formula source: Formula/t/terminal-notifier.rb
Blurb generated by claude-haiku-4-5 on today.
Raw metadata
{
"aliases": [],
"alternatives": [
"alerter",
"growl"
],
"build_dependencies": [],
"categories": [
"terminal-utility",
"notification"
],
"caveats": null,
"conflicts_with": [],
"dependencies": [],
"deprecated": 0,
"deprecation_reason": null,
"desc": "Send macOS User Notifications from the command-line",
"disable_reason": null,
"disabled": 0,
"enrichment_fetched_at": "2026-06-20T23:40:49+00:00",
"first_seen": "2026-06-20T23:34:18+00:00",
"full_name": "terminal-notifier",
"github_default_branch": "master",
"github_last_commit_at": "2025-11-02T14:24:58Z",
"github_readme_excerpt": "# terminal-notifier\n\n[](https://github.com/julienXX/terminal-notifier/releases)\n\nterminal-notifier is a command-line tool to send macOS User Notifications,\nwhich are available on macOS 10.10 and higher.\n\n\n## News\n\n[alerter](https://github.com/vjeantet/alerter) features were merged in terminal-notifier 1.7. This led to some issues and even more issues in the 1.8 release. We decided with [Val\u00e8re Jeantet](https://github.com/vjeantet) to rollback this merge.\n\nFrom now on terminal-notifier won\u0027t have the sticky notification feature nor the actions buttons. If you need them please use [alerter](https://github.com/vjeantet/alerter). I also want to follow [semver](http://semver.org) hence this latest version starts at 2.0.0.\n\nSticking to two smaller specialized tools will hopefully make them easier to maintain and less error prone.\n\n\n## Caveats\n\n* It is currently packaged as an application bundle, because `NSUserNotification`\n does not work from a \u2018Foundation tool\u2019. [radar://11956694](radar://11956694)\n\n* If you intend to package terminal-notifier with your app to distribute it on the Mac App Store, please use 1.5.2; version 1.6.0+ uses a private method override, which is not allowed in the App Store Guidelines.\n\n* If you\u0027re using macOS \u003c 10.10 you should use terminal-notifier 1.6.3.\n\n* If you\u0027re looking for sticky notifications or more actions on a notification please use [alerter](https://github.com/vjeantet/alerter)\n\n## Download\n\nPrebuilt binaries are available from the\n[releases section](https://github.com/julienXX/terminal-notifier/releases).\n\nOr if you want to use this from\n[Ruby](https://github.com/julienXX/terminal-notifier/tree/master/Ruby), you can\ninstall it through RubyGems:\n\n```\n$ [sudo] gem install terminal-notifier\n```\n\nYou can also install it via [Homebrew](https://github.com/mxcl/homebrew):\n```\n$ brew install terminal-notifier\n```\n\n## Usage\n\n```\n$ ./terminal-notifier.app",
"github_repo": "julienXX/terminal-notifier",
"github_stars": 7227,
"github_topics": [
"command-line",
"notifications",
"objective-c",
"osx",
"ruby"
],
"homepage": "https://github.com/julienXX/terminal-notifier",
"homepage_og_description": null,
"homepage_og_image": null,
"homepage_title": null,
"installs_30d": 10208,
"installs_365d": 84574,
"installs_90d": 30142,
"keg_only": 0,
"keg_only_reason": null,
"last_seen": "2026-06-20T23:34:18+00:00",
"license": "MIT",
"llm_generated_at": "2026-06-20T23:44:21+00:00",
"llm_model": "claude-haiku-4-5",
"name": "terminal-notifier",
"oldnames": [],
"one_liner": "Command-line tool to send macOS User Notifications from shell scripts and automation.",
"optional_dependencies": [],
"rank_30d": 353,
"rank_365d": 473,
"rank_90d": 393,
"raw_hash": "ff1a47f4fa319264",
"recommended_dependencies": [],
"revision": 0,
"ruby_source_path": "Formula/t/terminal-notifier.rb",
"tap": "homebrew/core",
"test_dependencies": [],
"uses_from_macos": [],
"version_head": "HEAD",
"version_stable": "2.0.0",
"versioned_formulae": [],
"why_use_this": "Integrate native macOS notification center alerts into bash scripts, cron jobs, and CI/CD workflows without GUI dependencies. Useful for build completion notifications, deployment alerts, or any long-running task that needs to notify when done. Lightweight single-purpose tool that just sends notifications\u2014nothing more."
}