cc-hooks-plugin

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 (cld command)
• ✅ Configure status line
• ✅ Set up API keys for premium features
• ✅ Choose preset configurations
• ✅ Test your installation

Quick setup modes: