# @heroku-cli/notifications

> display notifications in Heroku CLI commands

Latest version **1.2.9** (published 2026-08-21) · MIT license · 0 weekly downloads

## Install

```sh
npm install @heroku-cli/notifications
pnpm add @heroku-cli/notifications
yarn add @heroku-cli/notifications
bun add @heroku-cli/notifications
```

## Health

**Score 70/100 (B)** — status: active.

Positive: has types; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score.

Warnings: low downloads; no esm support.

## Facts

| | |
|---|---|
| Version | 1.2.9 |
| Published | 2026-08-21 |
| First published | 2018-04-06 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Node | >=20 |
| Dependencies | 0 |
| Unpacked size | 148.8 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 2 |
| Author | Heroku |
| Maintainers | sbosio_sf, eblack, mars, heroku-johnny, michael.malave, erika.wallace |
| Keywords | oclif |

## Links

- npm: https://www.npmjs.com/package/@heroku-cli/notifications
- Repository: https://github.com/heroku/heroku-cli-notifications
- Issues: https://github.com/heroku/heroku-cli-notifications/issues
- npm.io page: https://npm.io/package/@heroku-cli/notifications

## Alternatives

- [@salesforce/cli](https://npm.io/package/@salesforce/cli.md) — 389.7K weekly downloads
- [@mintlify/cli](https://npm.io/package/@mintlify/cli.md) — 208.9K weekly downloads
- [@grafana/e2e-selectors](https://npm.io/package/@grafana/e2e-selectors.md) — 128.7K weekly downloads
- [mintlify](https://npm.io/package/mintlify.md) — 112.0K weekly downloads
- [@intlayer/cli](https://npm.io/package/@intlayer/cli.md) — 22.8K weekly downloads

## Recent versions

- 1.2.9 (latest) — 2026-08-21
- 1.2.8 — 2026-07-17
- 1.2.7 — 2026-06-09
- 1.2.6 — 2026-02-05
- 1.2.5 — 2025-02-24
- 1.2.4 — 2024-03-21
- 1.2.3 — 2022-12-12
- 1.2.2 — 2018-08-21
- 1.2.1 — 2018-05-15
- 1.2.0 — 2018-04-06
- 1.1.0 — 2018-04-06
- 1.0.3 — 2018-04-06
- 1.0.2 — 2018-04-06
- 1.0.1 — 2018-04-06
- 1.0.0 — 2018-04-06

## README

# Heroku CLI Notifications
=========================

display notifications in Heroku CLI commands. Based on [node-notifier](https://github.com/mikaelbr/node-notifier).

[![Version](https://img.shields.io/npm/v/@heroku-cli/notifications.svg)](https://npmjs.org/package/@heroku-cli/notifications)
[![GH CI](https://github.com/heroku/heroku-cli-notifications/actions/workflows/ci.yml/badge.svg)](https://github.com/heroku/heroku-cli-notifications/actions/workflows/ci.yml)
[![License](https://img.shields.io/npm/l/@heroku-cli/notifications.svg)](https://github.com/heroku/heroku-cli-notifications/blob/master/package.json)


<!-- toc -->

# Usage

If `HEROKU_NOTIFICATIONS=0|false` then this will not be displayed.

```typescript
import {notify} from '@heroku-cli/notifications'
notify({
  title: 'notification title',
  message: 'notification message',
})
```

See the [node-notifier](https://github.com/mikaelbr/node-notifier) docs for more information.

## Note

On macOS Apple Silicon (M1/M2/M3/M4), desktop notifications may not appear without Rosetta 2.

---
_Source: https://npm.io/package/@heroku-cli/notifications · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._