Voice Wake Say

Overview

Use macOS say to read the assistant's response out loud whenever the conversation came from Voice Wake/voice recognition. Do not use the tts tool (it calls cloud providers).

When to Use say (CHECK EVERY MESSAGE INDIVIDUALLY)

IF the user message STARTS WITH: User talked via voice recognition - Step 1: Acknowledge with say first (so the user knows you heard them) - Step 2: Then perform the task - Step 3: Optionally speak again when done if it makes sense

IF the user message does NOT start with that exact phrase - THEN: Do NOT use say. Text-only response only.

Critical: - Check EACH message individually — context does NOT carry over - The trigger phrase must be at the VERY START of the message - For tasks that take time, acknowledge FIRST so the user knows you're working

Workflow

1) Detect Voice Wake context - Trigger ONLY when the latest user/system message STARTS WITH User talked via voice recognition - If the message instructs "repeat prompt first", keep that behavior in the response.

2) Prepare spoken text - Use the final response text as the basis. - Strip markdown/code blocks; if the response is long or code-heavy, speak a short summary and mention that details are on screen.

3) Speak with say (local macOS TTS) bash printf '%s' "$SPOKEN_TEXT" | say

Optional controls (use only if set): bash printf '%s' "$SPOKEN_TEXT" | say -v "$SAY_VOICE" printf '%s' "$SPOKEN_TEXT" | say -r "$SAY_RATE"

Failure handling

• If say is unavailable or errors, still send the text response and note that TTS failed.