An open API service indexing awesome lists of open source software.

https://github.com/hb0730/bark-skill

Use when sending push notifications to iPhone via Bark app, including simple alerts, time-sensitive reminders, encrypted messages, or notification grouping scenarios.
https://github.com/hb0730/bark-skill

bark claude-code-skill openclaw-skill skills

Last synced: 5 days ago
JSON representation

Use when sending push notifications to iPhone via Bark app, including simple alerts, time-sensitive reminders, encrypted messages, or notification grouping scenarios.

Awesome Lists containing this project

README

          

# bark-skill

> An [Agent Skill](https://agentskills.io) for sending iPhone push notifications via [Bark](https://github.com/Finb/Bark).
>
> 通过 [Bark](https://github.com/Finb/Bark) 向 iPhone 推送通知的 Agent Skill。

## Requirements / 环境要求

- Bark iOS app installed, with `BARK_KEY` obtained from the app home screen
- 已安装 Bark iOS App,并从首页获取 `BARK_KEY`
- Internet access to `https://api.day.app` (or a self-hosted Bark server)
- 可访问 `https://api.day.app`(或自托管 Bark 服务器)

## Usage / 使用方法

### Quick Start / 快速开始

```bash
export BARK_KEY="your_device_key"

# Body only / 仅正文
./scripts/send-bark.sh "Hello from agent"

# Title + body / 标题 + 正文
./scripts/send-bark.sh "Title" "Body"

# Time-sensitive, bypass Do Not Disturb / 时效性通知,穿透勿扰
./scripts/send-bark.sh "Reminder" "Meeting in 5 minutes" --level timeSensitive

# Persistent ring + group / 持续响铃 + 分组
./scripts/send-bark.sh "Alert" "Service down" --call 1 --group monitor

# Auto-copy to clipboard / 自动复制到剪贴板
./scripts/send-bark.sh "OTP" "123456" --copy 123456
```

### Script Parameters / 脚本参数

| Parameter / 参数 | Description / 说明 |
|---|---|
| `--subtitle` | Subtitle / 副标题 |
| `--level` | `active`(default) / `timeSensitive` / `passive` |
| `--sound` | Notification sound / 铃声名称 |
| `--group` | Notification group / 通知分组 |
| `--url` | URL to open on tap / 点击跳转链接 |
| `--badge` | App icon badge number / 角标数字 |
| `--icon` | Notification icon URL (iOS 15+) / 通知图标 |
| `--copy` | Text to copy to clipboard / 复制到剪贴板的内容 |
| `--call` | `1` = ring for 30s / 持续响铃 30 秒 |
| `--archive` | `1` = save to history (default) / 保存到历史记录 |

### Environment Variables / 环境变量

| Variable / 变量 | Required / 必填 | Default / 默认值 | Description / 说明 |
|---|---|---|---|
| `BARK_KEY` | Yes / 是 | — | Device key from Bark app / Bark App 设备 Key |
| `BARK_SERVER` | No / 否 | `https://api.day.app` | Bark server URL / 服务器地址 |

## As an Agent Skill / 作为 Agent Skill 使用

This repository follows the [Agent Skills specification](https://agentskills.io/specification). Place it in your agent's skills directory and the agent will automatically use it when push notifications are needed.

本仓库遵循 [Agent Skills 规范](https://agentskills.io/specification)。将其放入 agent 的 skills 目录后,agent 会在需要推送通知时自动调用。

```
~/.claude/skills/
└── bark-skill/
├── SKILL.md
└── scripts/
└── send-bark.sh
```

## License

[MIT](LICENSE) © 2026 hb0730