This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
This is a Claude Code voice integration project that provides text-to-speech functionality for Claude Code interactions. The repository contains Claude Code hooks and scripts that enable voice feedback during development sessions.
The project implements voice feedback through macOS say command with:
- Multilingual support: Automatically detects Korean text (Hangul) and uses "Yuna" voice, defaults to "Daniel" voice for other languages
- Assistant responses: Spoken feedback when Claude Code completes tasks (Stop hook)
- User input echo: Spoken repetition of user prompts (UserPromptSubmit hook)
The .claude/settings.json file configures hooks that trigger voice feedback:
- Stop hook: Triggers
assistant-say.shwhen Claude Code completes responses - UserPromptSubmit hook: Triggers
user-say.shwhen users submit prompts - Logging: All hooks log activity to
~/.claude/hooks.log
- assistant-say.sh: Extracts and speaks the latest assistant message from transcripts
- user-say.sh: Extracts and speaks the latest user message from transcripts
- Both scripts parse JSON transcripts using
jqand handle language detection
- No package.json or build system detected - this appears to be a shell script-based project
- Scripts depend on
jqfor JSON parsing and macOSsaycommand for text-to-speech - Hook system integrates with Claude Code's transcript functionality to provide contextual voice feedback