활용 사례

PushWard와 함께하는 하루

하나의 홈랩, 하루 동안의 푸시. 시간을 선택하면 어떤 서비스가 무엇을 보내고, 어떤 경로로 들어오며, iPhone에 어떻게 표시되는지 볼 수 있습니다.

업무 시작 스크립트

탭 한 번으로 업무 시작

오전 7시에 작은 스크립트가 잠금 화면에서 묻습니다. ‘Start’를 탭하면 응답이 되고, 카드는 8시간 카운트다운으로 바뀝니다.

REST API
실시간 현황

연결 방식

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

가이드 읽기

나에게 맞는 구성 찾기

같은 흐름을 사용하는 사람별로 묶었습니다. 하나를 열어 구성을 확인하세요.

홈랩

서버, 모니터링, 다운로드, 백업이 스스로 상황을 알려 줍니다.

Gatus Relay 웹훅

사이트가 다운되고 복구되는 순간 파악

연결 방식

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

가이드 읽기

Unraid Unraid 플러그인

NAS의 야간 작업
연결 방식
Plugins > Install Plugin

https://github.com/mac-lucky/pushward-unraid-plugin/raw/main/pushward-unraid.plg
가이드 읽기

SABnzbd Docker 브리지

속도와 남은 시간이 보이는 다운로드

연결 방식

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

가이드 읽기

Backrest Relay 웹훅

스스로 보고하는 백업
연결 방식
Backrest > Hooks > Shoutrrr

generic+https://relay.pushward.app/backrest?@authorization=Bearer+hlk_YOUR_KEY&contenttype=application/json
가이드 읽기
Komodo Relay 웹훅

Komodo의 컨테이너 경보
연결 방식
Komodo > Alerter > Custom

https://pushward:[[PUSHWARD_KEY]]@relay.pushward.app/komodo
가이드 읽기

개발자와 CI

어떤 포지에서든 빌드, 배포, 경보를 잠금 화면에서 확인하세요.

GitHub Actions Docker 브리지

CI 작업을 단계별로 확인

연결 방식

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

가이드 읽기

Argo CD Relay 웹훅

동기화부터 healthy까지 배포 추적

연결 방식

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

가이드 읽기

Forgejo Actions CLI

어떤 CI에서든 CLI로 보고

연결 방식

.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

가이드 읽기

Grafana Grafana 플러그인

그래프가 함께 오는 경보

연결 방식

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.

가이드 읽기

스마트홈

집안 곳곳의 프린터, 가전, 리마인더.

Bambu Lab Docker 브리지

3D 프린트를 레이어별로 추적

연결 방식

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

가이드 읽기

Home Assistant HACS 연동

리마인더와 방 온도

연결 방식

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

가이드 읽기

Home Assistant HACS 연동

모든 엔티티를 실시간 현황으로
연결 방식
Home Assistant

Settings > Devices & Services > PushWard > Add tracked entity sensor.dishwasher_status
가이드 읽기

AI 에이전트

진행 상황을 알려 주고 행동하기 전에 먼저 묻는 에이전트.

셀프 호스팅 AI 에이전트 MCP Server

행동하기 전에 묻는 에이전트

연결 방식

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"

가이드 읽기

셀프 호스팅 AI 에이전트 MCP Server

에이전트가 설정하는 반복 리마인더
연결 방식
MCP

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

개인 대시보드

나만의 숫자와 루틴을 홈 화면과 잠금 화면에.

업무 시작 스크립트 REST API

탭 한 번으로 업무 시작

연결 방식

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

가이드 읽기

가계부 앱 REST API

홈 화면에 내 예산을

연결 방식

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

가이드 읽기

Mac 스크립트 REST API

내 Mac의 스크립트

연결 방식

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

가이드 읽기

8가지 연결 방법

이 페이지의 모든 흐름은 이 중 하나를 사용합니다. 대부분 몇 분이면 설정할 수 있습니다.

첫 서비스를 연결하세요

앱에서 연동 키를 받고 위의 연결 방법 중 하나를 고르면, 몇 분 뒤 첫 카드가 잠금 화면에 나타납니다.

시작하기 플레이그라운드