Casos de uso

Un día con PushWard

Un homelab, un día de envíos. Elige una hora para ver qué servicio envía qué, por qué vía llega y cómo aparece en el iPhone.

Script de jornada

Empieza la jornada con un toque

A las 7:00 un pequeño script pregunta en la pantalla de bloqueo. Al tocar «Start» respondes, y la tarjeta se convierte en una cuenta atrás de ocho horas.

REST API
Actividad en directo

Cómo está conectado

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"
          }
        ]
      }
    }'

Leer la guía

Encuentra tu configuración

Los mismos flujos, agrupados según quién los usaría. Abre uno para ver su configuración.

Homelab

Servidores, monitores, descargas y copias de seguridad que informan por su cuenta.

Gatus Webhook de Relay

Entérate de cuándo cae un sitio y de cuándo vuelve

Cómo está conectado

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

Leer la guía

Unraid Plugin de Unraid

Tareas nocturnas en el NAS
Cómo está conectado
Plugins > Install Plugin

https://github.com/mac-lucky/pushward-unraid-plugin/raw/main/pushward-unraid.plg
Leer la guía

SABnzbd Puente Docker

Descargas con velocidad y tiempo restante

Cómo está conectado

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

Leer la guía

Backrest Webhook de Relay

Copias de seguridad que dan señales
Cómo está conectado
Backrest > Hooks > Shoutrrr

generic+https://relay.pushward.app/backrest?@authorization=Bearer+hlk_YOUR_KEY&contenttype=application/json
Leer la guía
Komodo Webhook de Relay

Alertas de contenedores desde Komodo
Cómo está conectado
Komodo > Alerter > Custom

https://pushward:[[PUSHWARD_KEY]]@relay.pushward.app/komodo
Leer la guía

Desarrolladores y CI

Builds, despliegues y alertas en la pantalla de bloqueo, desde cualquier forja.

GitHub Actions Puente Docker

Sigue los jobs de CI paso a paso

Cómo está conectado

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

Leer la guía

Argo CD Webhook de Relay

Sigue un despliegue de la sincronización a healthy

Cómo está conectado

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

Leer la guía

Forgejo Actions CLI

Informa desde cualquier CI con la CLI

Cómo está conectado

.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

Leer la guía

Grafana Plugin de Grafana

Alertas con su propio gráfico

Cómo está conectado

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.

Leer la guía

Domótica

Impresoras, electrodomésticos y recordatorios de toda la casa.

Bambu Lab Puente Docker

Sigue una impresión 3D capa a capa

Cómo está conectado

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

Leer la guía

Home Assistant Integración de HACS

Recordatorios y temperatura de las habitaciones

Cómo está conectado

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, ...

Leer la guía

Home Assistant Integración de HACS

Cualquier entidad como actividad en directo
Cómo está conectado
Home Assistant

Settings > Devices & Services > PushWard > Add tracked entity sensor.dishwasher_status
Leer la guía

Agentes de IA

Agentes que te mantienen al tanto y preguntan antes de actuar.

Agente de IA autoalojado Servidor MCP

Deja que un agente pregunte antes de actuar

Cómo está conectado

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"

Leer la guía

Agente de IA autoalojado Servidor MCP

Recordatorios periódicos que crea un agente
Cómo está conectado
MCP

# "Remind me every Friday at 16:00 to do the weekly review" create_scheduled_notification cron "0 16 * * 5" "Weekly review"
Leer la guía

Paneles personales

Tus propias cifras y rutinas en la pantalla de inicio y la pantalla de bloqueo.

Script de jornada REST API

Empieza la jornada con un toque

Cómo está conectado

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"
          }
        ]
      }
    }'

Leer la guía

App de presupuesto REST API

Tu presupuesto en la pantalla de inicio

Cómo está conectado

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"
      }
    }'

Leer la guía

Scripts del Mac REST API

Scripts en tu Mac

Cómo está conectado

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%"
          }
        ]
      }
    }'

Leer la guía

Ocho formas de conectarse

Cada flujo de esta página usa una de ellas. La mayoría se configura en pocos minutos.

Conecta tu primer servicio

Consigue una clave de integración en la app, elige una de las formas de conectarse de arriba y tu primera tarjeta estará en la pantalla de bloqueo pocos minutos después.

Empezar Playground