Skip to content

openamer/openamer / skills/system/notification-engine

notification-engine

Unverified

'Use for alerting: desktop, sound, log, webhook, daemon.'

Notification Engine — Multi-Channel Alerting

Use this skill when you need to send alerts, configure the notification engine, start/stop the daemon, or check alert history.

Files

  • Script: scripts/notification-engine.py im OpenAmer-Repo
  • Config: ~/.notification-engine/config.json
  • Incoming: ~/.notification-engine/incoming/ (JSON-Alarm-Dateien)
  • Log: ~/.notification-engine/logs/engine.log
  • History: ~/.notification-engine/history/history.json

CLI Usage

# Sofort eine Benachrichtigung senden
python scripts/notification-engine.py --send "Backup abgeschlossen"
python scripts/notification-engine.py --send "Kritischer Fehler" --priority critical --channel sound
python scripts/notification-engine.py --send "Warnung" --priority warning --channel desktop --channel logfile

# Daemon starten (überwacht incoming/ alle 30s)
python scripts/notification-engine.py --daemon

# Daemon mit eigenem Intervall
python scripts/notification-engine.py --daemon --interval 10

# History anzeigen
python scripts/notification-engine.py --history

# Status anzeigen
python scripts/notification-engine.py --status

# Incoming-Datei anlegen (für andere Skripte)
python scripts/notification-engine.py --send-incoming "Nachricht"

# Alle wartenden Incoming-Dateien verarbeiten
python scripts/notification-engine.py --process-incoming

# Cooldown ignorieren
python scripts/notification-engine.py --send "Dringend!" --force

Priority-Level

LevelDesktopSoundLogfileWebhook
info✓—✓—
warning✓—✓✓
critical✓✓✓✓

(Sound nur bei critical, es sei denn die Config wird angepasst)

Channels

  • desktop: Windows Toast-Notification via PowerShell Burst
  • sound: PowerShell Console.Beep (Frequenz abhängig von Priority)
  • logfile: Text-Log in ~/.notification-engine/logs/engine.log
  • webhook: HTTP-POST (Generic JSON) — muss in Config aktiviert werden

Config (~/.notification-engine/config.json)

{
  "channels": {
    "desktop": { "enabled": true, "min_priority": "info" },
    "sound":   { "enabled": true, "min_priority": "critical" },
    "logfile": { "enabled": true, "min_priority": "info" },
    "webhook": { "enabled": false, "min_priority": "warning", "url": null }
  },
  "cooldown_minutes": 60,
  "history_max": 50,
  "webhook_default_url": null
}

Cooldown

Identische Nachrichten werden nicht öfter als alle cooldown_minutes (Default 60) gesendet. Mit --force kann der Cooldown umgangen werden.

Incoming-Datei-Format (für andere Skripte)

Andere Skripte legen einfach eine JSON-Datei in ~/.notification-engine/incoming/ ab:

{
  "message": "Deine Nachricht",
  "priority": "critical",
  "channels": ["desktop", "sound"],
  "force": false
}

Der Daemon oder --process-incoming verarbeitet sie dann automatisch.

Cron-Job

Der Notification-Daemon läuft als Cron-Job (notification-engine-daemon) alle 1 Minute. Er startet den Daemon, falls er nicht läuft, oder lässt ihn laufen.

Integration in andere Skripte

# Direkt in einem anderen Skript:
import subprocess
subprocess.run(["python", "scripts/notification-engine.py",
    "--send", "Backup fehlgeschlagen!", "--priority", "critical"])

Oder:

# Incoming-Datei anlegen:
from pathlib import Path
import json
(Path.home() / ".notification-engine/incoming/alert.json").write_text(
    json.dumps({"message": "Test", "priority": "info"}), encoding="utf-8")
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 192kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 192kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 192kUpdated Claude CodeCodexVerifiedInstall