pp-pushover

What this skill does

<!-- 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:
   ```bash
   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.3 or newer):

```bash
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._

  ```bash
  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._

  ```bash
  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._

  ```bash
  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._

  ```bash
  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._

  ```bash
  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:

```bash
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.

## Recipes


### Send a low-priority test

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

Uses env/config credentials and records a local ledger row.

### Check quota before a batch

```bash
pushover-pp-cli quota --json --select remaining,reset
```

Reads the dedicated app limits endpoint.

### Validate a destination

```bash
pushover-pp-cli users validate --user-key "$PUSHOVER_USER_KEY" --json
```

Confirms the key is valid before relying on it in scripts.

### Watch an emergency receipt

```bash
pushover-pp-cli emergency watch --receipt <receipt> --json
```

P