Pushover Notification Skill

When to Use

• Job completion notifications requiring immediate attention
• Urgent alerts (errors, failures, time-sensitive events)
• High-priority status updates
• When the user needs to be notified NOW (not via email)
• Supplementing email notifications for critical messages

• Long-form reports or detailed documentation (use email instead)
• Non-urgent updates that can wait
• Bulk notifications (Pushover has rate limits)

Configuration

AGENT_LLM_

• AGENT_LLM_PUSHOVER_TOKEN

  - Your application API token (get from https://pushover.net/apps/build)

• AGENT_LLM_PUSHOVER_USER_KEY

  - Your user key (get from https://pushover.net)

Setup

1. Create a Pushover account at https://pushover.net
2. Install the Pushover app on your phone (iOS/Android)
3. Register a new application at https://pushover.net/apps/build
4. Copy your API Token and User Key
5. Set as GitHub Secrets:
   bash

   npx thepopebot set-agent-llm-secret PUSHOVER_TOKEN "your-token"
   npx thepopebot set-agent-llm-secret PUSHOVER_USER_KEY "your-user-key"

Usage

await context.tools.send_pushover({
  to: "user-key-or-device",  // Optional, defaults to PUSHOVER_USER_KEY
  message: "Job complete: Analysis finished",
  title: "PopeBot Alert",    // Optional
  priority: 0,               // -2 to 2 (see below)
  url: "https://...",        // Optional link
  urlTitle: "View Details"   // Optional URL label
});

Priority Levels

-2

-1

0

1

2

Options

• to

  - User key or device identifier (optional, defaults to configured user)

• message

  - Main notification text (required, max 1024 chars)

• title

  - App title/discrete label (optional, max 250 chars)

• priority

  - Priority level -2 to 2 (default: 0)

• url

  - Supplementary URL to attach (optional)

• urlTitle

  - Custom text for the URL button (optional)

• sound

  - Custom sound name (optional, see Pushover docs)

• device

  - Specific device to target (optional)

Examples

Simple notification

await context.tools.send_pushover({
  message: "Daily backup completed successfully"
});

High-priority alert

await context.tools.send_pushover({
  title: "⚠️ Error Alert",
  message: "Pipeline failed at step: build",
  priority: 2,
  url: "https://github.com/.../actions/runs/123",
  urlTitle: "View Logs"
});

Job completion with link

await context.tools.send_pushover({
  title: "Research Complete",
  message: "Analysis of 50 documents finished. 3 key findings.",
  priority: 1,
  url: "https://.../pr/42",
  urlTitle: "Review PR"
});

Tips

• Keep messages concise (under 200 chars for best visibility)
• Use priority

  2

  sparingly (emergency alerts only)
• Include URLs for quick access to related resources
• Use emoji in titles for visual scanning (🔔 ⚠️ ✅ ❌)
• Priority

  -1

  is good for informational updates during off-hours

Rate Limits

• 750 messages per hour per user
• 10,000 messages per month (free tier)
• Emergency priority (2) has additional limits