cc-hooks
Give Claude Code a voice! Transform your coding experience with intelligent audio feedback, multilingual TTS announcements, and AI-powered contextual messages.
Why cc-hooks?
Working with Claude Code is powerful, but it can feel silent and disconnected. cc-hooks brings your coding sessions to life:
- 🎯 Stay in the flow - Audio cues keep you informed without breaking focus
- 🔊 Instant feedback - Know when tools start, complete, or when Claude needs your attention
- 🗣️ Smart announcements - Context-aware messages that understand what you're working on
- 🌍 Your language - TTS support for multiple languages (English, Indonesian, Spanish, and more)
- ⚡ Zero config - Works out of the box, customize when you need it
- 🎛️ Flexible control - From complete silence to premium AI voices, you choose
Quick Demo
Watch cc-hooks in action with premium ElevenLabs text-to-speech
Features
🎵 Audio Feedback System
- Sound effects for different events (tool execution, notifications, completions)
- Voice announcements for session lifecycle and task completions
- Multiple TTS providers: Prerecorded sounds (offline), Google TTS (free), ElevenLabs (premium)
- Smart fallback chain - automatically tries next provider if one fails
🤖 AI-Powered Intelligence (Optional)
- Contextual completion messages - "I've successfully implemented the authentication system you requested"
- Smart tool announcements - Understands what Claude is doing and why
- Automatic translation - AI messages in your preferred language
- Cost optimized - Disabled by default, enable per session when needed
⚙️ Advanced Capabilities
- Multi-instance support - Run multiple Claude sessions with different audio configs
- Granular silent modes - Disable just announcements or just sound effects
- Per-session configuration - Change settings without editing config files
- Auto-cleanup - Smart session management prevents resource leaks
- Status line integration - See current session info in Claude Code UI
Installation
Choose Your Installation Mode
| Feature | Plugin Mode ⭐ Recommended | Standalone Mode |
|---|---|---|
| Setup Complexity | ✅ Simple (3 commands) | ⚠️ Manual hooks configuration |
| Updates | ✅ One command | ⚠️ Git pull + restart |
| Slash Commands | ✅ Built-in | ❌ Not available |
| Hooks Config | ✅ Automatic | ⚠️ Manual (settings.json) |
| Installation Path | Fixed location | ✅ User-defined |
| For Contributors | ⚠️ Limited | ✅ Full source access |
| Recommended for | Most users | Developers, testers |
→ Continue with Plugin Installation | → Standalone Installation
Plugin Installation (Recommended)
Prerequisites
- Python 3.12+ (recommended: 3.12.7)
- uv package manager
- Claude Code CLI installed
Quick Install
Option 1: CLI (Recommended - No REPL needed)
# Add marketplace
claude plugin marketplace add https://github.com/husniadil/cc-hooks.git
# Install plugin
claude plugin install cc-hooks-plugin@cc-hooks-plugin
# Done! Start Claude to use
claude
Option 2: Inside Claude REPL
# Start Claude first
claude
# Then in the REPL:
/plugin marketplace add https://github.com/husniadil/cc-hooks.git
/plugin install cc-hooks-plugin@cc-hooks-plugin
# Restart Claude Code
Start using! Audio feedback works immediately with default prerecorded sounds. 🎉
Post-Installation Setup (Recommended)
After installation, use the interactive setup wizard:
# Inside Claude REPL
/cc-hooks-plugin:setup
This wizard helps you:
- ✅ Check system requirements (uv installation)
- ✅ Set up convenient shell aliases (
cldcommand) - ✅ Configure status line
- ✅ Set up API keys for premium features
- ✅ Choose preset configurations
- ✅ Test your installation
Quick setup modes: