Run a script when a recording finishes.

#!/bin/zsh
# recordcue hooks — run every action in ~/.config/recordcue/actions once per
# finished recording. launchd starts this every minute; when nothing is new
# it exits at once. Read-only towards RecordCue: it only asks the app's CLI
# what has finished.                 https://www.recordcue.app/automate/hooks/
set -u
export PATH="/opt/homebrew/bin:/usr/local/bin:$HOME/.local/bin:$PATH"

rc="${RECORDCUE_APP:-/Applications/RecordCue.app}/Contents/MacOS/RecordCue"
actions="$HOME/.config/recordcue/actions"
seen="$HOME/.config/recordcue/seen"
mkdir -p "$actions"

# Exit 3 means "no recordings yet"; treat every non-zero exit as "nothing to do".
json=$("$rc" --agent-cli list --since 1d --json 2>/dev/null) || exit 0

# First run: remember what already exists so old calls are not replayed.
if [[ ! -e "$seen" ]]; then
  jq -r '.recordings[] | .id // .media.path' <<<"$json" >"$seen"
  exit 0
fi

jq -c '.recordings[]' <<<"$json" | while IFS= read -r rec; do
  id=$(jq -r '.id // .media.path' <<<"$rec")
  grep -qxF -- "$id" "$seen" && continue
  transcript=$(jq -r '.transcript.path // empty' <<<"$rec")

  if [[ -z "$transcript" ]]; then
    # No text yet. Wait while transcription is still working. If nothing is
    # working on it (turned off, or it failed), give the app two minutes to
    # queue one before treating the recording as final.
    state=$(jq -r '.transcription.state // "none"' <<<"$rec")
    [[ "$state" == queued || "$state" == running ]] && continue
    if [[ "$state" == none ]]; then
      settled=$(jq -r '(now - ((.endedAt // .updatedAt) | fromdateiso8601)) > 120' <<<"$rec")
      [[ "$settled" == true ]] || continue
    fi
  fi

  # What every action can rely on. RC_JSON is the full record, as printed by
  # `latest --json`; the rest are the fields a shell script reaches for.
  export RC_JSON="$rec"
  export RC_ID="$id"
  export RC_TRANSCRIPT="$transcript"
  export RC_MEDIA=$(jq -r '.media.path' <<<"$rec")
  export RC_SERVICE=$(jq -r '.service // "Recording"' <<<"$rec")
  export RC_TITLE=$(jq -r '.title // empty' <<<"$rec")
  export RC_MINUTES=$(jq -r '((.durationMs // 0) / 60000) | round' <<<"$rec")
  export RC_STARTED_AT=$(jq -r '.startedAt // empty' <<<"$rec")
  export RC_WHEN=$(jq -r '(.startedAt // .updatedAt) | fromdateiso8601 | localtime | strftime("%Y-%m-%d %H:%M")' <<<"$rec")
  export RC_DATE="${RC_WHEN%% *}"

  # Each action runs once per recording. One that fails is retried on the
  # next round without re-running the ones that succeeded.
  for action in "$actions"/*(N.x); do
    key="$id	${action:t}"
    grep -qxF -- "$key" "$seen" && continue
    if "$action" <<<"$rec"; then
      print -r -- "$key" >>"$seen"
    else
      print -u2 -- "$(date '+%F %T') ${action:t} failed for ${RC_MEDIA:t}; will retry"
    fi
  done
done

#!/bin/zsh
# ~/.config/recordcue/actions/10-notify.sh
# The smallest useful action: a notification that the transcript is ready.
osascript -e "display notification \"$RC_SERVICE · $RC_MINUTES min · transcript ready\" \
  with title \"RecordCue\""

chmod +x ~/.config/recordcue/actions/10-notify.sh

# Run the hook now instead of waiting for the next minute:
launchctl kickstart -k gui/$(id -u)/app.recordcue.hooks

# Make one recording, stop it, wait for the transcript. Then:
tail ~/.config/recordcue/hooks.log
cat  ~/.config/recordcue/seen

#!/bin/zsh
# Hazel rule on ~/Movies/RecordCue (with "Run rules on folder contents" so
# the per-service subfolders count). Condition: Extension is "txt".
# Action: Run shell script — embedded script, passed the file as $1.
rc='/Applications/RecordCue.app/Contents/MacOS/RecordCue'
media="${1%.txt}.m4a"; [[ -e "$media" ]] || media="${1%.txt}.mp4"
json=$("$rc" --agent-cli inspect "$media" --json) || exit 0
# ...the same actions as above, with the JSON in $json and the text in $1.

brew install fswatch
fswatch -0 -r --event Created --event Renamed ~/Movies/RecordCue |
  while read -d '' path; do
    # Any change under the folder — a new recording, a transcript landing,
    # a companion file being rewritten — runs the same runner at once.
    ~/.config/recordcue/hooks.sh
  done

launchctl bootout gui/$(id -u)/app.recordcue.hooks
rm ~/Library/LaunchAgents/app.recordcue.hooks.plist
# Keep or delete ~/.config/recordcue as you like.