macos-say

Use macOS text-to-speech via the `say` command for voice feedback, audio narration, and spoken output.

⭐0stars🔀0forks📁View on GitHub🕐Updated Dec 27, 2025⬇️1downloads

When & Why to Use This Skill

The macos-say skill integrates the native macOS text-to-speech engine into the Claude environment, allowing for seamless conversion of text into spoken audio. It solves the need for eyes-free feedback and automated audio generation by providing a programmable interface for the system's 'say' command, supporting multiple voices, adjustable speech rates, and direct audio file export.

Use Cases

  • Task Completion Alerts: Set up spoken notifications to alert you when long-running background processes, such as code builds or data processing, are finished.
  • Accessibility & Multitasking: Convert long text blocks or documentation into speech, allowing you to listen to information while performing other visual tasks.
  • Audio Content Creation: Generate high-quality voiceovers and narration for scripts or presentations by exporting text directly to AAC or audio files using various system voices.
  • Interactive Debugging: Implement voice feedback in scripts to announce status updates or error states without needing to constantly monitor the terminal output.
namemacos-say
descriptionUse macOS text-to-speech via the `say` command for voice feedback, audio narration, and spoken output.

macOS Say Command

Provide voice feedback using macOS's built-in say command.

Basic Usage

say "Hello, world"

Key Options

  • -v <voice> - Select voice (e.g., Samantha, Alex, Daniel)
  • -r <rate> - Words per minute (default ~175)
  • -o <file> - Output to audio file
  • -f <file> - Read text from file

Common Patterns

say "Task complete" & # Non-blocking notification say -v Daniel "Build finished" # Specific voice say -o out.m4a --data-format=aac "Save as audio"

List voices: say -v ?