bark-notify

Name: bark-notify
Author: caopulan

37installs1forks

How to install bark-notify?

caopulan/notification-skill/bark-notify

$npx -y skills add caopulan/Notification-Skill --skill bark-notify

Installs into the current project.

Summary

Send Bark (day.app) push notifications after Codex completes a task. Use when one Codex or Claude run is finished, or when you need to notify on task completion with device name, project name, status, and summary.

Files · 1

View on GitHub

SKILL.md

1	# Bark Notify
2
3	## Overview
4
5	Send a Bark push notification after each Codex task. Use the helper script to resolve the project name and post to the Bark API.
6
7	## User Preparation
8
9	### 1) Configure environment variables
10
11	You can add the following lines to `~/.bashrc` (Linux) or `~/.zshrc` (macOS) to set environment variables:
12	```
13	export CODEX_MACHINE_NAME="Machine-name" # e.g., Macbook
14	export CODEX_BARK_KEY="" # https://api.day.app/<CODEX_BARK_KEY>/
15	export CODEX_BARK_BASE_URL="https://api.day.app"
16	```
17
18	### 2) Add instruction in project AGENTS.md
19
20	For example, you can add this instruction to AGENTS.md:
21	> Use skill bark-notify to notify users when each agent run is finished or when any notifications would be sent to users.
22
23	## Workflow
24
25	### 1) Provide a project name source (optional)
26
27	- To override the folder name, define a project name in `AGENTS.md` using one of:
28	- YAML frontmatter: `project_name: My Project` (or `name:`)
29	- A plain line: `Project Name: My Project` or `项目名称：我的项目`
30	- If no name is found, the script uses the project folder name.
31
32	### 2) Send the notification at task completion
33
34	- Generate a short task title (3-8 words).
35	- Pick an execution status: `success`, `failed`, `partial`, `blocked`, etc.
36	- Write a brief result summary; avoid secrets.
37
38	Run:
39
40	```bash
41	python3 ~/.codex/skills/bark-notify/scripts/send_bark_notification.py \
42	--task-title \"...\" \
43	--status \"success\" \
44	--summary \"...\" \
45	--project-name \"...\"
46	```
47
48	## Resources
49
50	- `scripts/send_bark_notification.py`: Send the Bark notification and resolve the project name.

People who liked this also viewed

6 picks

Type