Pp Pushover

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/social-and-messaging/pushover/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

Pushover — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the pushover-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows:

   npx -y @mvanhorn/printing-press-library install pushover --cli-only

2. Verify: pushover-pp-cli --version
3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer):

go install github.com/mvanhorn/printing-press-library/library/social-and-messaging/pushover/cmd/pushover-pp-cli@latest

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

When to Use This CLI

Use pushover-pp-cli for agent or ops workflows that need mobile push notifications, emergency receipt tracking, quota-aware sends, group delivery management, or Open Client message retrieval.

Unique Capabilities

These capabilities aren't available in any other tool for this API.

Agent-native plumbing

• notify — Send a notification from an argument or stdin with env/config defaults, named priorities, and emergency validation.

  Lets agents send test or operational notifications without leaking token values or remembering the raw endpoint shape.

  pushover-pp-cli notify "Printing Press test" --priority low --json

Receipt operations

• emergency watch — Send or monitor an emergency notification receipt, polling acknowledgement status and supporting cancellation.

  Turns emergency notifications from fire-and-forget sends into an auditable on-call workflow.

  pushover-pp-cli emergency watch --receipt <receipt> --poll-interval 30s --cancel-on-timeout --json

Operational safety

• quota — Show monthly send limit, remaining sends, and reset time from the app limits endpoint.

  Agents can check send budget before fanout or repeated test sends.

  pushover-pp-cli quota --json

Local state that compounds

• history — Search and export a local redacted ledger of notifications sent by this CLI and receipt outcomes.

  Shows what this CLI sent, when, with which priority, without storing raw user keys or tokens.

  pushover-pp-cli history list --since 24h --json

• inbox sync — Download Open Client messages into local SQLite before optional server-side delete-through.

  Makes Pushover usable as both send channel and retrievable inbox for agents that own an Open Client device.

  pushover-pp-cli inbox sync --device-id <device-id> --json

Command Reference

notify — Send an agent-safe notification from an argument, --message, or stdin

• pushover-pp-cli notify — Send with env defaults, named priorities, emergency validation, and redacted local history

emergency — Watch emergency-priority receipts

• pushover-pp-cli emergency watch — Poll an emergency receipt at a safe cadence until terminal state

quota — Check application send quota

• pushover-pp-cli quota — Show monthly limit, remaining sends, and reset time

history — Inspect the local redacted notification ledger

• pushover-pp-cli history — List locally recorded notification sends
• pushover-pp-cli history show — Show one local history row

inbox — Sync Open Client messages locally

• pushover-pp-cli inbox sync — Store downloaded Open Client messages in local SQLite
• pushover-pp-cli inbox list — List locally synced Open Client messages

apps — Inspect application-level message quotas

• pushover-pp-cli apps — Check monthly message limit, remaining sends, and reset time

devices — Manage Open Client devices

• pushover-pp-cli devices create — Register a new Open Client desktop device
• pushover-pp-cli devices delete-through — Delete downloaded Open Client messages up to a highest message id

glances — Update Pushover Glances widgets

• pushover-pp-cli glances — Update Glances widget fields

groups — Create, inspect, and manage Pushover delivery groups

• pushover-pp-cli groups add-user — Add a user to a delivery group
• pushover-pp-cli groups create — Create a delivery group
• pushover-pp-cli groups disable-user — Temporarily disable a group user
• pushover-pp-cli groups enable-user — Re-enable a disabled group user
• pushover-pp-cli groups get — Get a delivery group's name and users
• pushover-pp-cli groups list — List delivery groups owned by the account
• pushover-pp-cli groups remove-user — Remove a user from a delivery group
• pushover-pp-cli groups rename — Rename a delivery group

licenses — Assign and inspect Pushover license credits

• pushover-pp-cli licenses assign — Assign a pre-paid license credit to a user or email
• pushover-pp-cli licenses credits — Check remaining license credits

messages — Send application notifications and download Open Client messages

• pushover-pp-cli messages download — Download pending messages for an Open Client device
• pushover-pp-cli messages send — Send a Pushover notification

receipts — Inspect and cancel emergency-priority message receipts

• pushover-pp-cli receipts cancel — Cancel retries for one emergency-priority receipt
• pushover-pp-cli receipts cancel-by-tag — Cancel active emergency-priority retries matching a tag
• pushover-pp-cli receipts get — Get emergency-priority receipt status

sounds — Discover notification sounds

• pushover-pp-cli sounds — List built-in and account custom notification sounds

subscriptions — Manage Pushover subscription migrations

• pushover-pp-cli subscriptions — Migrate an existing user key into a subscription user key

teams — Manage Pushover for Teams membership

• pushover-pp-cli teams add-user — Add a user to a team
• pushover-pp-cli teams get — Show team information and users
• pushover-pp-cli teams remove-user — Remove a user from a team

users — Validate users and log in for Open Client sessions

• pushover-pp-cli users login — Log in a user for Open Client and return a user key plus session secret
• pushover-pp-cli users validate — Validate a user or group key and optional device

Finding the right command

When you know what you want to do but not which command does it, ask the CLI directly:

pushover-pp-cli which "<capability in your own words>"

which resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code 0 means at least one match; exit code 2 means no confident match — fall back to --help or use a narrower query.