pushover

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Pushover Notification Skill

Pushover 通知技能

Send instant push notifications to your mobile phone and desktop via the Pushover API.

通过Pushover API向你的手机和桌面端发送即时推送通知。

When to Use

使用场景

✅ USE this skill when:

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

❌ DON'T use this skill when:

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

✅ 适合使用此技能的场景：

需要立即关注的任务完成通知
紧急警报（错误、故障、时效性事件）
高优先级状态更新
需要立即通知用户的情况（而非通过邮件）
为关键消息补充邮件通知之外的推送

❌ 不适合使用此技能的场景：

长篇报告或详细文档（建议使用邮件）
可延迟的非紧急更新
批量通知（Pushover存在速率限制）

Configuration

配置

Pushover requires two credentials (set as GitHub Secrets with

AGENT_LLM_

prefix):

```
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)

Pushover需要两个凭证（设置为带有

AGENT_LLM_

前缀的GitHub Secrets）：

```
AGENT_LLM_PUSHOVER_TOKEN
```
- 你的应用API令牌（从https://pushover.net/apps/build获取）
```
AGENT_LLM_PUSHOVER_USER_KEY
```
- 你的用户密钥（从https://pushover.net获取）

Setup

设置步骤

Create a Pushover account at https://pushover.net
Install the Pushover app on your phone (iOS/Android)
Register a new application at https://pushover.net/apps/build
Copy your API Token and User Key

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"

在https://pushover.net创建Pushover账户
在你的手机上安装Pushover应用（iOS/Android）
在https://pushover.net/apps/build注册新应用
复制你的API令牌和用户密钥

设置为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

使用方法

javascript

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
});

javascript

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

优先级等级

Priority	Behavior
`-2`	No notification, always silent
`-1`	Quiet notification (no sound/vibration)
`0`	Normal priority (default)
`1`	High priority (bypasses quiet hours)
`2`	Emergency (repeats every 60s until acknowledged)

优先级	行为
`-2`	无通知，始终静音
`-1`	安静通知（无声音/震动）
`0`	普通优先级（默认）
`1`	高优先级（绕过静音时段）
`2`	紧急级别（每60秒重复通知直至被确认）

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)

```
to
```
- 用户密钥或设备标识符（可选，默认使用已配置的用户）
```
message
```
- 通知主文本（必填，最多1024字符）
```
title
```
- 应用标题/离散标签（可选，最多250字符）
```
priority
```
- 优先级等级-2至2（默认：0）
```
url
```
- 附加的补充链接（可选）
```
urlTitle
```
- 链接按钮的自定义文本（可选）
```
sound
```
- 自定义通知音效名称（可选，详见Pushover文档）
```
device
```
- 目标特定设备（可选）

Examples

示例

Simple notification

简单通知

javascript

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

javascript

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

High-priority alert

高优先级警报

javascript

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"
});

javascript

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

带链接的任务完成通知

javascript

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"
});

javascript

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

保持消息简洁（200字符以内以获得最佳可读性）
谨慎使用优先级
```
2
```
（仅用于紧急警报）
包含链接以便快速访问相关资源
在标题中使用表情符号以便快速识别（🔔 ⚠️ ✅ ❌）
优先级
```
-1
```
适合在非工作时段发送信息性更新

Rate Limits

速率限制

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

For bulk notifications, consider batching or using the email skill instead.

每个用户每小时750条消息
免费版每月10,000条消息
紧急优先级（2）有额外限制

如需批量通知，建议采用分批发送或使用邮件技能替代。