notify

name	notify
description	Send a macOS notification to alert the user. Use when a task is complete, an intern finishes work, something needs attention, or when explicitly asked to notify. Interns should use this when they finish significant work.

Notify

Send a macOS desktop notification that stays on screen until dismissed.

Usage

Use terminal-notifier to send a sticky alert:

terminal-notifier -title "TITLE" -message "MESSAGE" -sound Glass -type alert

Replace MESSAGE with a brief description of what happened, and TITLE with a short label.

Fallback — if terminal-notifier is not available, use osascript (auto-dismisses):

osascript -e 'display notification "MESSAGE" with title "TITLE" sound name "Glass"'

Examples

Task complete:

terminal-notifier -title "Squad: gateway-core done" -message "Gateway UI build finished — 4 commits on gateway-abstraction" -sound Glass -type alert

Needs attention:

terminal-notifier -title "Squad: review ready" -message "PR #7126 review found 2 critical issues" -sound Glass -type alert

Error/stuck:

terminal-notifier -title "Squad: gateway-core stuck" -message "Build failed — missing dependency in Cargo.toml" -sound Glass -type alert

Guidelines

• Title: Keep short. Use format Squad: <intern-name> <status> (e.g., Squad: gateway-core done)
• Message: One line, include key details (what finished, what's needed, commit count, etc.)
• Sound: Always use Glass for consistency
• Type: Always use alert so it stays on screen until dismissed
• When to notify:
  • Task/intern finished significant work
  • Something needs user attention
  • Error or blocker encountered
  • When explicitly asked to notify
• Don't spam: One notification per completed task, not per commit