pr-e/personal-finish-notifier

Personal Finish Notifier

Use this skill to wire agent completion events into a simple notification channel.

Principles

• Treat notifications like a person checking back in, not a machine event log.
• Keep the routing layer engine-agnostic.
• Prefer a user-configured target and transport over hardcoded routing.
• Prefer OpenClaw transports over engine-specific delivery logic.

Layout

• scripts/notify.sh - core formatter + transport adapter
• scripts/install-claude-hook.sh - install/update Claude hook wiring
• scripts/test-openclaw.sh - send a live self-test through OpenClaw
• references/architecture.md - rationale and extension points

Default setup

For Claude Code on this machine:

./scripts/install-claude-hook.sh

For a live delivery check:

./scripts/test-openclaw.sh

Inputs

The notifier reads hook JSON from stdin and settings from ~/.claude/mac-notify.env.

Required routing values:

• OPENCLAW_NOTIFY_CHANNEL
• OPENCLAW_NOTIFY_TARGET

Optional safety value:

• OPENCLAW_NOTIFY_SELF_TARGET

If OPENCLAW_NOTIFY_SELF_TARGET is set, the script refuses to send when the target differs.

Adapters

• Claude Code: Stop, TaskCompleted
• OpenClaw transport: WhatsApp now
• Future adapters: Codex completion hooks, native node notify, webhook, APNs

Message style

Human tone rules:

• short
• specific
• reads like a teammate checking back in
• avoid raw event names like Stop or end_turn

If you need architecture context or to add a new transport, read references/architecture.md.