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:

text

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:

bash

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.