Mac notifications for blocked and finished tasks

#!/bin/bash
# taskhold-mac.sh: show a macOS notification when an agent blocks or finishes a Taskhold task.
# Needs curl and jq. Run: TASKHOLD_API_KEY=atd_sk_... ./taskhold-mac.sh
key=${TASKHOLD_API_KEY:?set TASKHOLD_API_KEY}
board=https://taskhold.com/dashboard/live
last=""

notify() { # kind, title, detail, agent
  if [ "$1" = blocked ]; then h="$4 needs you"; else h="$4 finished a task"; fi
  terminal-notifier -title Taskhold -subtitle "$h" -message "$2${3:+: $3}" \
    -group "taskhold-$1" -open "$board"
}

while :; do
  while IFS= read -r line; do
    case "$line" in
      "id: "*) last=${line#id: } ;;
      "data: "*)
        e=${line#data: }
        # Agents only: a task (not a step) finished, or any task or step blocked.
        jq -e '.type == "task.status" and .actor == "agent" and (.data.to == "blocked" or (.data.to == "done" and .task_id == .root_task_id))' <<<"$e" >/dev/null || continue
        kind=$(jq -r .data.to <<<"$e")
        title=$(jq -r '.task_title // "a task"' <<<"$e")
        agent=$(jq -r '.actor_name // "An agent"' <<<"$e")
        detail=$(jq -r 'if .data.to == "blocked" then .data.blocked_reason else .data.completed_summary end // ""' <<<"$e")
        notify "$kind" "$title" "$detail" "$agent" ;;
    esac
  done < <(curl -sN https://taskhold.com/api/events/stream -H "Authorization: Bearer $key" ${last:+-H "Last-Event-ID: $last"})
  sleep 3
done

TASKHOLD_API_KEY=atd_sk_... ./taskhold-mac.sh