robertoecf

Agentic Coding Notify — Communication skill for Claude Code

Communication community

macOS notification plugin for Claude Code + iTerm2. Sound alerts with session identification by profile name.

How to install Agentic Coding Notify

This entry records only its repository, not the path inside it, so there is no exact command to give. Open robertoecf/agentic-coding-notify and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Agentic Coding Notify does

macOS notification plugin for Claude Code + iTerm2. Sound alerts with session identification by profile name.

Alternatives in Communication

  • HolaOS — Open-source agentic workspace enterprises can make their own 10.9k ★
  • Lark Coding Agent Bridge — Bot that bridges Feishu/Lark messenger with a local Claude Code or Codex CLI 2.4k ★
  • Notifications Init — Alias for init — Download notification binary 806 ★

README

agentic-coding-notify

agentic-coding-notify retro N64 header

macOS notification preferences for local agent apps and CLIs.

This repo ships one shared notification layer with four entrypoints:

  • Claude Code through the backwards-compatible claude-code-notify plugin.
  • Codex through the notify = [...] hook in ~/.codex/config.toml.
  • OpenCode through a dedicated adapter script.
  • Pi through a dedicated adapter script.

The repo name is `agentic-coding-notify`; the Claude plugin name intentionally remains `claude-code-notify` so existing Claude installs keep working.

Quick start

Install the macOS notification dependency:

brew install terminal-notifier

Run the local preferences UI:

python3 web/notify_ui.py --open

Open `http://127.0.0.1:8765`, choose the voice/sounds/text templates, test samples, then save or export the config.

Install the adapter you use:

Environment Install path Details
Claude Code claude plugin install claude-code-notify@agentic-coding-notify docs/adapters.md#claude-code
Codex bash adapters/codex/install.sh --print-config docs/adapters.md#codex
OpenCode bash adapters/opencode/install.sh docs/adapters.md#opencode
Pi bash adapters/pi/install.sh docs/adapters.md#pi

What it does

When an adapter fires, you get:

  1. a desktop notification via terminal-notifier when available;
  2. a configurable notification sound;
  3. an optional start sound;
  4. a short spoken label using macOS say;
  5. an optional end sound.

The spoken text is context-aware:

  • app sessions can say just the app name, e.g. Codex App;
  • CLI sessions can combine the service plus a short tab/profile label, e.g. Codex One;
  • Codex App is detected explicitly and speaks as