mcpField
B
bark-notify

bark-notify

github.com/caopulanAgent workflows1644 installsUpdated 42w ago
Repository

About bark-notify

bark-notify is a skill for Codex agents that sends a Bark push notification when a task finishes. It can resolve the project name from AGENTS.md and accepts a task title, status, and summary.

Key features

  1. 01Send Bark pushes at task completion
  2. 02Resolve project names from AGENTS.md
  3. 03Set task title, status, and summary

Use cases

  1. 01Notify users when Codex tasks finish
  2. 02Distinguish notifications by project

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/caopulan/notification-skill --skill bark-notify

After installing, type/bark-notifyin Claude Code to confirm it loaded.

Bundled filesscripts/send_bark_notification.py

Details

From the project README

Bark Notify

Overview

Send a Bark push notification after each Codex task. Use the helper script to resolve the project name and post to the Bark API.

User Preparation

1) Configure environment variables

You can add the following lines to ~/.bashrc (Linux) or ~/.zshrc (macOS) to set environment variables:

export CODEX_MACHINE_NAME="Machine-name" # e.g., Macbook
export CODEX_BARK_KEY="" # https://api.day.app/<CODEX_BARK_KEY>/
export CODEX_BARK_BASE_URL="https://api.day.app"
2) Add instruction in project AGENTS.md

For example, you can add this instruction to AGENTS.md:

Use skill bark-notify to notify users when each agent run is finished or when any notifications would be sent to users.

Workflow

1) Provide a project name source (optional)
  • To override the folder name, define a project name in AGENTS.md using one of:
    • YAML frontmatter: project_name: My Project (or name:)
    • A plain line: Project Name: My Project or 项目名称：我的项目
  • If no name is found, the script uses the project folder name.
2) Send the notification at task completion
  • Generate a short task title (3-8 words).
  • Pick an execution status: success, failed, partial, blocked, etc.
  • Write a brief result summary; avoid secrets.

Run:

python3 ~/.codex/skills/bark-notify/scripts/send_bark_notification.py \
  --task-title \"...\" \
  --status \"success\" \
  --summary \"...\" \
  --project-name \"...\"

Resources

  • scripts/send_bark_notification.py: Send the Bark notification and resolve the project name.

Comments

Markdown supported