# vjeantet/alerter

Send User Alert Notification on MacOS from the command-line.

Repository: https://github.com/vjeantet/alerter
Canonical: https://ross.abutalabs.com/products/vjeantet-alerter
Language: HTML
License: MIT
License Family: permissive
Last push: 2026-07-22T07:08:05+00:00

## Health v2 (maintenance only)
Score: 87/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 93, release rhythm 71, longevity 100
- inputs: {"age_days": 3909, "days_push": 42, "days_rel": 195, "gap_med": 0, "n_releases_24m": 4}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1230, forks 74 (observed 2026-08-28T04:04:03.822704+00:00)

## What it is
Alerter is a Swift-based command-line tool for sending persistent alert notifications on macOS, with support for reply inputs, action buttons, scheduling, and timeouts. It exits when the user interacts with the alert and prints the result to stdout as plain text or JSON.

## Use cases
- send a macos notification from a shell script
- show an alert with action buttons and capture the user's choice
- prompt the user for a text reply from the command line
- schedule a reminder notification at a specific time
- get script feedback when a notification is dismissed or times out
- notify me when a long-running deploy finishes

## When to choose
- you need interactive macOS notifications (reply or action buttons) from scripts or CI-like workflows
- you want machine-readable (JSON) output of how the user responded to an alert
- you need scheduled or delayed notifications from the terminal

## When to avoid
- you need cross-platform desktop notifications (Linux or Windows)
- you only need transient banners rather than alerts that stay until dismissed
- you target macOS versions older than 13.0

## Facets
- artifact type: cli-tool
- maturity: active
- function: cli, developer-tools, workflow-automation
- domain: developer-tools, apple-ecosystem
- platform: cli
- tags: macos-notifications, user-alerts, swift, homebrew, interactive-notifications, notification, command-line, automation, macos

## Member repositories
- vjeantet/alerter (main) score 87

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:03.822704+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:15:04.006651+00:00, confidence not recorded.
  - readme: https://github.com/vjeantet/alerter (fetched 2026-08-28T04:04:03.822704+00:00, sha f2365ea662a5)
- Data as of 2026-08-30T08:39:29.467469+00:00.