🗣️ Claude Code Voice

Make Claude Code speak! Add personalized voice announcements to your AI coding assistant.

Features

• 🎤 Personalized Messages - Uses your name throughout all voice interactions
• 🔊 Smart Defaults - Pre-configured to avoid notification fatigue
• 🌍 Cross-Platform - Works on macOS, Windows, and Linux
• 🎛️ Granular Control - Mute/unmute specific hooks as needed
• 👋 Welcome Greetings - Time-based personalized greetings when starting Claude
• ⚡ One-Command Setup - Install and configure everything in seconds

Installation

npx claude-code-voice

That's it! The interactive wizard will guide you through setup.

What Gets Installed

The setup wizard will:

1. Ask for your name for personalized messages
2. Let you choose which voice hooks to enable
3. Configure platform-specific voice engines
4. Create the /voice command in Claude Code
5. Add a welcome greeting to your shell (optional)

Default Configuration

By default, these hooks are enabled:

• ✅ Notification - When Claude needs your attention
• ✅ Stop - When tasks are completed
• ✅ SubagentStop - When subagents finish work

And these are disabled (to reduce noise):

• ❌ PreToolUse - Before each tool runs
• ❌ PostToolUse - After each tool completes

Usage

Voice Commands in Claude Code

Once installed, you can use these commands within Claude Code:

/voice              # Toggle voice on/off
/voice status       # Show current settings
/voice help         # Show all commands

# Mute specific hooks
/voice mute pre     # Mute tool start sounds
/voice mute post    # Mute tool completion sounds
/voice mute all     # Mute everything

# Unmute specific hooks  
/voice unmute notification  # Unmute attention requests
/voice unmute all          # Unmute everything

Available Hooks

• pre/pretool - Tool start announcements
• post/posttool - Tool completion alerts
• notification - User attention requests
• stop/finish - Task completion messages
• subagent/agent - Subagent completion alerts

Examples

# First time setup
npx claude-code-voice

# Reconfigure with different settings
npx claude-code-voice reconfigure

# Uninstall
npx claude-code-voice uninstall

Platform Support

macOS

• Uses say command with Samantha voice
• System sounds from /System/Library/Sounds/

Windows

• Uses PowerShell speech synthesis
• Windows system sounds

Linux

• Uses espeak or festival for speech
• PulseAudio for sound playback

Customization

The voice system generates personalized messages like:

• "Starting Bash for John"
• "Sarah, I need your attention"
• "All done, Michael!"

Messages vary to keep interactions fresh and natural.

Troubleshooting

Voice not working?

1. Check if voice is enabled:

   /voice status

2. Make sure your system has text-to-speech:

   • macOS: Built-in (no setup needed)
   • Windows: Built-in (no setup needed)
   • Linux: Install espeak or festival

3. Verify hook configuration in ~/.claude/settings.json

Too many/few announcements?

Use /voice mute and /voice unmute to customize which events trigger voice feedback.

Author

Created by mrrxwyz

License

MIT License - see LICENSE file for details.