Anwendungsfälle

Ein Tag mit PushWard

Ein Homelab, ein Tag voller Pushes. Wähle eine Uhrzeit und sieh, welcher Dienst was sendet, auf welchem Weg es ankommt und wie es auf dem iPhone landet.

Arbeitstag-Skript

Den Arbeitstag mit einem Tipp starten

Um 7:00 Uhr fragt ein kleines Skript auf dem Sperrbildschirm nach. Ein Tipp auf „Start“ beantwortet die Frage, und die Karte wird zu einem Acht-Stunden-Countdown.

REST API
Live-Aktivität

So ist es verkabelt

workday.sh

# 07:00 from cron or launchd
curl -X POST https://api.pushward.app/activities \
  -H "Authorization: Bearer hlk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "slug": "approval-request",
      "name": "Workday"
    }'

curl -X PATCH https://api.pushward.app/activities/approval-request \
  -H "Authorization: Bearer hlk_YOUR_KEY" \
  -H "Content-Type: application/merge-patch+json" \
  -d '{
      "state": "ongoing",
      "content": {
        "template": "approval",
        "state": "Start your workday?",
        "source": "Script",
        "icon": "calendar",
        "accent_color": "blue",
        "details": [
          {
            "label": "Calendar",
            "value": "3 meetings, first at 9:30"
          }
        ],
        "options": [
          {
            "id": "start",
            "title": "Start",
            "style": "primary"
          },
          {
            "id": "later",
            "title": "Later",
            "style": "secondary"
          }
        ]
      }
    }'

Zur Anleitung

Finde dein Setup

Dieselben Abläufe, gruppiert danach, wer sie betreiben würde. Öffne einen, um seine Konfiguration zu sehen.

Homelab

Server, Monitoring, Downloads und Backups, die sich von selbst melden.

Gatus Relay-Webhook

Wissen, wann eine Seite ausfällt und wann sie wieder da ist

So ist es verkabelt

gatus/config.yaml

alerting:
  custom:
    url: "https://relay.pushward.app/gatus"
    method: "POST"
    headers:
      Content-Type: "application/json"
      Authorization: "Bearer hlk_YOUR_KEY"
    # body: see the Gatus entry in the Relay guide

Zur Anleitung

Unraid Unraid-Plugin

Nachtjobs auf dem NAS
So ist es verkabelt
Plugins > Install Plugin

https://github.com/mac-lucky/pushward-unraid-plugin/raw/main/pushward-unraid.plg
Zur Anleitung

SABnzbd Docker-Bridge

Downloads mit Tempo und Restzeit

So ist es verkabelt

compose.yaml

services:
  pushward-sabnzbd:
    image: ghcr.io/mac-lucky/pushward-sabnzbd:latest
    environment:
      PUSHWARD_URL: https://api.pushward.app
      PUSHWARD_API_KEY: hlk_YOUR_KEY
      PUSHWARD_SABNZBD_URL: http://sabnzbd:8080/api
      PUSHWARD_SABNZBD_API_KEY: your-sabnzbd-api-key
    restart: unless-stopped

Zur Anleitung

Backrest Relay-Webhook

Backups, die sich melden
So ist es verkabelt
Backrest > Hooks > Shoutrrr

generic+https://relay.pushward.app/backrest?@authorization=Bearer+hlk_YOUR_KEY&contenttype=application/json
Zur Anleitung
Komodo Relay-Webhook

Container-Alerts von Komodo
So ist es verkabelt
Komodo > Alerter > Custom

https://pushward:[[PUSHWARD_KEY]]@relay.pushward.app/komodo
Zur Anleitung

Entwickler und CI

Builds, Deploys und Alerts auf dem Sperrbildschirm, aus jeder Forge.

GitHub Actions Docker-Bridge

CI-Jobs Schritt für Schritt verfolgen

So ist es verkabelt

compose.yaml

services:
  pushward-github:
    image: ghcr.io/mac-lucky/pushward-github:latest
    environment:
      PUSHWARD_URL: https://api.pushward.app
      PUSHWARD_API_KEY: hlk_YOUR_KEY
      PUSHWARD_GITHUB_TOKEN: github_pat_YOUR_TOKEN
      PUSHWARD_GITHUB_OWNER: your-username
    restart: unless-stopped

Zur Anleitung

Argo CD Relay-Webhook

Einen Deploy von Sync bis Healthy verfolgen

So ist es verkabelt

argocd-notifications-cm.yaml

data:
  service.webhook.pushward: |
    url: https://relay.pushward.app/argocd
    headers:
    - name: Authorization
      value: Bearer $pushward-key
  # plus the sync-running / sync-succeeded / deployed
  # templates and triggers from the Argo CD guide

Zur Anleitung

Forgejo Actions CLI

Aus jeder CI mit der CLI berichten

So ist es verkabelt

.forgejo/workflows/release.yml

env:
  PUSHWARD_API_TOKEN: ${{ secrets.PUSHWARD_API_TOKEN }}
steps:
  - run: pushward activity start release --name "Release v2.4.0" --template steps --step 1/3 --step-labels Build,Test,Ship --text Building
  - run: make build
  - run: pushward activity update release --step 2/3 --text Testing && make test
  - run: pushward activity update release --step 3/3 --text Shipping && make publish
  - run: pushward activity end release --status success

Zur Anleitung

Grafana Grafana-Plugin

Alerts mit eigenem Diagramm

So ist es verkabelt

grafana.ini

[plugins]
allow_loading_unsigned_plugins = pushward-alerts-app

# Then Apps > PushWard: paste the key, pick alert rules
# for timelines and PromQL queries for widgets.

Zur Anleitung

Smart Home

Drucker, Haushaltsgeräte und Erinnerungen aus dem ganzen Haus.

Bambu Lab Docker-Bridge

Einen 3D-Druck Schicht für Schicht verfolgen

So ist es verkabelt

compose.yaml

services:
  pushward-bambulab:
    image: ghcr.io/mac-lucky/pushward-bambulab:latest
    environment:
      PUSHWARD_URL: https://api.pushward.app
      PUSHWARD_API_KEY: hlk_YOUR_KEY
      PUSHWARD_BAMBULAB_HOST: your-printer-ip
      PUSHWARD_BAMBULAB_ACCESS_CODE: your-access-code
      PUSHWARD_BAMBULAB_SERIAL: your-printer-serial
    restart: unless-stopped

Zur Anleitung

Home Assistant HACS-Integration

Erinnerungen und Raumtemperaturen

So ist es verkabelt

Home Assistant

HACS > search "PushWard" > Download > restart
Settings > Devices & Services > Add Integration > PushWard

PushWard > Add tracked to-do list   todo.reminders
PushWard > Add tracked widget        sensor.living_room_temperature, ...

Zur Anleitung

Home Assistant HACS-Integration

Jede Entität als Live-Aktivität
So ist es verkabelt
Home Assistant

Settings > Devices & Services > PushWard > Add tracked entity sensor.dishwasher_status
Zur Anleitung

KI-Agenten

Agenten, die dich auf dem Laufenden halten und fragen, bevor sie handeln.

Selbst gehosteter KI-Agent MCP Server

Einen Agenten fragen lassen, bevor er handelt

So ist es verkabelt

MCP

# Connect the agent once
claude mcp add --transport http pushward https://mcp.pushward.app/mcp

# What it calls before it orders
create_activity      approval card "Place the grocery order?"  [Approve] [Not now]
wait_for_answer      blocks until a button is tapped -> "approve"
create_notification  "Order placed"

Zur Anleitung

Selbst gehosteter KI-Agent MCP Server

Wiederkehrende Erinnerungen, die ein Agent anlegt
So ist es verkabelt
MCP

# "Remind me every Friday at 16:00 to do the weekly review" create_scheduled_notification cron "0 16 * * 5" "Weekly review"
Zur Anleitung

Eigene Dashboards

Deine eigenen Zahlen und Routinen auf dem Home-Bildschirm und dem Sperrbildschirm.

Arbeitstag-Skript REST API

Den Arbeitstag mit einem Tipp starten

So ist es verkabelt

workday.sh

# 07:00 from cron or launchd
curl -X POST https://api.pushward.app/activities \
  -H "Authorization: Bearer hlk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "slug": "approval-request",
      "name": "Workday"
    }'

curl -X PATCH https://api.pushward.app/activities/approval-request \
  -H "Authorization: Bearer hlk_YOUR_KEY" \
  -H "Content-Type: application/merge-patch+json" \
  -d '{
      "state": "ongoing",
      "content": {
        "template": "approval",
        "state": "Start your workday?",
        "source": "Script",
        "icon": "calendar",
        "accent_color": "blue",
        "details": [
          {
            "label": "Calendar",
            "value": "3 meetings, first at 9:30"
          }
        ],
        "options": [
          {
            "id": "start",
            "title": "Start",
            "style": "primary"
          },
          {
            "id": "later",
            "title": "Later",
            "style": "secondary"
          }
        ]
      }
    }'

Zur Anleitung

Budget-App REST API

Dein Budget auf dem Home-Bildschirm

So ist es verkabelt

budget-sync.sh

curl -X POST https://api.pushward.app/widgets \
  -H "Authorization: Bearer hlk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "slug": "budget-trend",
      "name": "Spending",
      "content": {
        "template": "trend",
        "icon": "chart.line.uptrend.xyaxis",
        "label": "Budget used",
        "subtitle": "October",
        "value": 68,
        "unit": "%",
        "min_value": 0,
        "points": [
          4,
          9,
          12,
          18,
          21,
          27,
          30,
          34,
          41,
          44,
          49,
          53,
          58,
          61,
          64,
          68
        ],
        "trend": "up",
        "accent_color": "mint"
      }
    }'

Zur Anleitung

Mac-Skripte REST API

Skripte auf deinem Mac

So ist es verkabelt

ai-limits.sh

# every 30 minutes from launchd
curl -X POST https://api.pushward.app/widgets \
  -H "Authorization: Bearer hlk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "slug": "ai-limits",
      "name": "AI usage",
      "content": {
        "template": "stat_list",
        "icon": "sparkles",
        "label": "AI usage",
        "accent_color": "purple",
        "stat_rows": [
          {
            "label": "Work account",
            "value": "5h 38% · 7d 61%"
          },
          {
            "label": "Personal",
            "value": "5h 0% · 7d 12%"
          }
        ]
      }
    }'

Zur Anleitung

Acht Wege hinein

Jeder Ablauf auf dieser Seite nutzt einen davon. Die meisten sind in wenigen Minuten eingerichtet.

Verbinde deinen ersten Dienst

Hol dir in der App einen Integrationsschlüssel, wähle oben einen der Wege hinein, und wenige Minuten später ist deine erste Karte auf dem Sperrbildschirm.

Loslegen Playground