Casos de uso

Um dia com o PushWard

Um homelab, um dia de pushes. Escolha um horário para ver qual serviço envia o quê, por qual caminho chega e como aparece no iPhone.

Script do expediente

Comece o expediente com um toque

Às 7h, um pequeno script pergunta na Tela Bloqueada. Tocar em “Start” responde, e o card vira uma contagem regressiva de oito horas.

REST API
Atividade ao Vivo

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

Ler o guia

Encontre seu setup

Os mesmos fluxos, agrupados por quem os usaria. Abra um para ver a configuração.

Homelab

Servidores, monitores, downloads e backups que dão notícias sozinhos.

Gatus Webhook do Relay

Saiba quando um site cai e quando volta

Como 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

Ler o guia

Unraid Plugin do Unraid

Tarefas noturnas no NAS
Como está conectado
Plugins > Install Plugin

https://github.com/mac-lucky/pushward-unraid-plugin/raw/main/pushward-unraid.plg
Ler o guia

SABnzbd Bridge Docker

Downloads com velocidade e tempo restante

Como 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

Ler o guia

Backrest Webhook do Relay

Backups que dão notícias
Como está conectado
Backrest > Hooks > Shoutrrr

generic+https://relay.pushward.app/backrest?@authorization=Bearer+hlk_YOUR_KEY&contenttype=application/json
Ler o guia
Komodo Webhook do Relay

Alertas de contêineres do Komodo
Como está conectado
Komodo > Alerter > Custom

https://pushward:[[PUSHWARD_KEY]]@relay.pushward.app/komodo
Ler o guia

Desenvolvedores e CI

Builds, deploys e alertas na Tela Bloqueada, de qualquer forge.

GitHub Actions Bridge Docker

Acompanhe jobs de CI passo a passo

Como 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

Ler o guia

Argo CD Webhook do Relay

Acompanhe um deploy do sync até healthy

Como 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

Ler o guia

Forgejo Actions CLI

Reporte de qualquer CI com a CLI

Como 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

Ler o guia

Grafana Plugin do Grafana

Alertas com o próprio gráfico

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

Ler o guia

Casa inteligente

Impressoras, eletrodomésticos e lembretes de toda a casa.

Bambu Lab Bridge Docker

Acompanhe uma impressão 3D camada por camada

Como 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

Ler o guia

Home Assistant Integração HACS

Lembretes e temperatura dos cômodos

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

Ler o guia

Home Assistant Integração HACS

Qualquer entidade como Atividade ao Vivo
Como está conectado
Home Assistant

Settings > Devices & Services > PushWard > Add tracked entity sensor.dishwasher_status
Ler o guia

Agentes de IA

Agentes que mantêm você informado e perguntam antes de agir.

Agente de IA auto-hospedado MCP Server

Deixe um agente perguntar antes de agir

Como 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"

Ler o guia

Agente de IA auto-hospedado MCP Server

Lembretes recorrentes criados por um agente

Como está conectado

MCP

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

Ler o guia

Dashboards pessoais

Seus próprios números e rotinas na Tela de Início e na Tela Bloqueada.

Script do expediente REST API

Comece o expediente com um toque

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

Ler o guia

App de orçamento REST API

Seu orçamento na Tela de Início

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

Ler o guia

Scripts do Mac REST API

Scripts no seu Mac

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

Ler o guia

Oito formas de entrada

Cada fluxo desta página usa uma delas. A maioria leva poucos minutos para configurar.

Conecte seu primeiro serviço

Pegue uma chave de integração no app, escolha uma das formas de entrada acima e, poucos minutos depois, seu primeiro card estará na Tela Bloqueada.

Começar Playground