From unix
Configures Bark push, WeChat, and system notifications for Claude Code via .claude/claude-notification.local.md. Provides bash scripts for proactive task alerts.
npx claudepluginhub oreo992/claude-notification --plugin unixThis skill uses the workspace's default tool permissions.
This plugin supports configuration and proactive notification sending.
Configures Bark push, WeChat, and system notifications for Claude Code projects. Enables persistent alerts and proactive sending via PowerShell scripts after tasks.
Sends push notifications via Gotify server for long-running task completions, errors, or events using bash scripts with curl, jq, title, priority, and markdown support.
Manages Claude Code audio notifications: installs project, snoozes/mutes, enables/disables hooks, switches themes, tests playback, troubleshoots silence or noise.
Share bugs, ideas, or general feedback.
This plugin supports configuration and proactive notification sending.
Location: .claude/claude-notification.local.md (project root)
| Option | Type | Default | Description |
|---|---|---|---|
bark_url | string | empty | Bark push URL, e.g., https://api.day.app/your-key |
wechat_token | string | empty | WeChat Token, get from https://xtuis.cn/ |
wechat_hook_enabled | boolean | true | Enable WeChat hook auto-trigger |
bark_hook_enabled | boolean | true | Enable Bark hook auto-trigger |
system_notification_enabled | boolean | true | Enable system notifications |
always_notify | boolean | false | Set to true to always notify, even when terminal is in foreground |
---
bark_url: ""
wechat_token: ""
wechat_hook_enabled: true
bark_hook_enabled: true
system_notification_enabled: true
always_notify: false
---
AI can call notification scripts at appropriate times.
Scripts are located in scripts/ directory of this skill:
scripts/notify.sh - System notification scriptscripts/bark.sh - Bark push script with full parametersscripts/wechat.sh - WeChat push script"${CLAUDE_PLUGIN_ROOT}/skills/notification-config/scripts/notify.sh" "Title" "Content" "${CLAUDE_PROJECT_DIR}"
Use scripts/bark.sh for rich push notifications:
# View help
"${CLAUDE_PLUGIN_ROOT}/skills/notification-config/scripts/bark.sh" -h
# Simple push
"${CLAUDE_PLUGIN_ROOT}/skills/notification-config/scripts/bark.sh" -u "URL" -m "Task completed"
# With title
"${CLAUDE_PLUGIN_ROOT}/skills/notification-config/scripts/bark.sh" -u "URL" -t "Claude" -m "Code review done"
# Urgent (ring for 30s)
"${CLAUDE_PLUGIN_ROOT}/skills/notification-config/scripts/bark.sh" -u "URL" -m "Urgent!" -c
# Grouped message
"${CLAUDE_PLUGIN_ROOT}/skills/notification-config/scripts/bark.sh" -u "URL" -m "Build done" -g "build"
| Parameter | Description |
|---|---|
-u, --url | Bark server URL (required) |
-m, --message | Push content (required) |
-t, --title | Push title |
-g, --group | Message group name |
-s, --sound | Ringtone (alarm, bell, etc.) |
-c, --call | Ring for 30 seconds |
-l, --level | Level: active, timeSensitive, passive |
-i, --icon | Custom icon URL |
-b, --badge | Badge number |
--copy | Content to copy on tap |
--auto-copy | Auto copy on receive |
--archive | Save to history |
--redirect | URL to open on tap |
Use scripts/wechat.sh for WeChat notifications :
# View help
"${CLAUDE_PLUGIN_ROOT}/skills/notification-config/scripts/wechat.sh" -h
# Simple push
"${CLAUDE_PLUGIN_ROOT}/skills/notification-config/scripts/wechat.sh" -t "TOKEN" -x "Task completed"
# With description
"${CLAUDE_PLUGIN_ROOT}/skills/notification-config/scripts/wechat.sh" -t "TOKEN" -x "Claude Code" -d "Code review done"
# Detailed notification
"${CLAUDE_PLUGIN_ROOT}/skills/notification-config/scripts/wechat.sh" -t "TOKEN" -x "Build completed" -d "Project build successful, took 5 minutes"
| Parameter | Description |
|---|---|
-t, --token | Server Token (required), get from https://xtuis.cn/ |
-x, --text | Notification title (required) |
-d, --desp | Notification content/description (optional) |
Send notifications proactively in these scenarios:
-c for urgentIMPORTANT: Always check existing configuration first
Check if configuration already exists:
.claude/claude-notification.local.mdbark_url:
Ask user for Bark URL (only if needed)
Create or update configuration file:
.claude/claude-notification.local.mdCheck if CLAUDE.md needs notification configuration:
.claude/CLAUDE.md existsAsk about adding to CLAUDE.md (only if not already configured):
.claude/CLAUDE.md with the following content.{{PLUGIN_PATH}} with the actual expanded value of ${CLAUDE_PLUGIN_ROOT} when writing to CLAUDE.md.## 通知功能配置
### Bark 推送配置
* Bark URL: `<user's bark url>`
### 主动通知场景
AI 应该在以下场景主动发送通知:
1. **长时间任务完成** - 构建、测试、部署等耗时任务完成时
2. **需要用户确认** - 重要决策或需要用户介入时(使用 `-c` 参数持续响铃)
3. **重要里程碑** - 代码审查完成、PR 创建成功等
4. **错误警报** - 构建失败、测试未通过等异常情况
### 发送通知方法
使用 Bash 工具调用 bark.sh 脚本:
\```bash
# 基础通知
bash "{{PLUGIN_PATH}}/skills/notification-config/scripts/bark.sh" -u "<user's bark url>" -t "Claude Code" -m "任务完成"
# 紧急通知(持续响铃30秒)
bash "{{PLUGIN_PATH}}/skills/notification-config/scripts/bark.sh" -u "<user's bark url>" -t "Claude Code" -m "需要确认" -c
# 分组通知
bash "{{PLUGIN_PATH}}/skills/notification-config/scripts/bark.sh" -u "<user's bark url>" -t "构建完成" -m "项目构建成功" -g "build"
\```
### 使用原则
* 在用户明确要求通知时发送
* 完成重要任务后主动发送(如代码审查、PR创建、长时间构建等)
* 紧急情况使用 `-c` 参数
* 相关任务使用 `-g` 参数分组
IMPORTANT: Always check existing configuration first
Check if configuration already exists:
.claude/claude-notification.local.mdwechat_token:
Guide user to get WeChat Token (only if needed)
Create or update configuration file:
.claude/claude-notification.local.mdCheck if CLAUDE.md needs notification configuration:
.claude/CLAUDE.md existsAsk about adding to CLAUDE.md (only if not already configured):
.claude/CLAUDE.md with the following content.{{PLUGIN_PATH}} with the actual expanded value of ${CLAUDE_PLUGIN_ROOT} when writing to CLAUDE.md.## 通知功能配置
### 微信推送配置
* WeChat Token: `<user's wechat token>`
### 主动通知场景
AI 应该在以下场景主动发送通知:
1. **长时间任务完成** - 构建、测试、部署等耗时任务完成时
2. **需要用户确认** - 重要决策或需要用户介入时
3. **重要里程碑** - 代码审查完成、PR 创建成功等
4. **错误警报** - 构建失败、测试未通过等异常情况
### 发送通知方法
使用 Bash 工具调用 wechat.sh 脚本:
\```bash
# 基础通知
bash "{{PLUGIN_PATH}}/skills/notification-config/scripts/wechat.sh" -t "<user's wechat token>" -x "任务完成"
# 带详细内容
bash "{{PLUGIN_PATH}}/skills/notification-config/scripts/wechat.sh" -t "<user's wechat token>" -x "Claude Code" -d "代码审查完成"
# 详细通知
bash "{{PLUGIN_PATH}}/skills/notification-config/scripts/wechat.sh" -t "<user's wechat token>" -x "构建完成" -d "项目构建成功,耗时 5 分钟"
\```
### 使用原则
* 在用户明确要求通知时发送
* 完成重要任务后主动发送(如代码审查、PR创建、长时间构建等)
* 使用 `-x` 参数设置标题,`-d` 参数设置详细内容
When user requests notification or after completing important tasks:
bark_url and wechat_token from .claude/claude-notification.local.md