ehAye Audio

Give Your AI a Real Voice

Smart voice notifications for AI coding assistants. Hear when tasks complete while you focus on other work.

Tip

⭐ Star this repo and follow @ehAyeAudio on X for updates on multi-voice support and new AI integrations.

🌟 Overview

ehAye Audio transforms your AI coding experience by adding voice notifications. When Claude Code completes a task, runs a build, or encounters an error - you'll hear it. Stay focused on other work while your AI assistant handles tasks in the background.

Think of ehAye Audio as your AI's mentor - bridging the gap between silent text output and natural voice feedback that keeps you in the flow.

📋 Table of Contents

• 🌟 Overview
• ✨ Features
• 🚀 Quick Start
  • Installation
  • Setup
  • Enable
• ⚙️ Web Portal
• 🧪 Try It
• 🧬 How It Works
• 🎮 CLI Essentials
• 🎭 Voice Management
• ⚙️ Configuration
• 🧯 Troubleshooting
• 📋 Requirements
• 🔒 Security
• 📄 License
• 🤝 Contributing
• 💖 Support

🎯 What is ehAye Audio?

ehAye (pronounced "A.I.") Audio brings real-time voice to your AI coding assistants. It provides audio feedback when your assistant completes tasks, runs commands, or needs your attention. Built for multitasking developers who want to stay productive.

✨ Features

• 🎵 Voice Notifications when your A.I. finishes tasks
• 🎭 Dual Voice System: Primary + Secondary voice options
• 🌓 Light/Dark Web UI with live config
• 🔧 Zero Config: Works out of the box
• 🚀 Lightweight & background-safe
• 🔌 Modular Provider Support for multiple A.I. tools
• 🛡️ Type-safe (built with TypeScript)

🚀 Quick Start

1. Install Globally

npm install -g @eh-aye/audio

2. Restart Claude Code

After install, restart Claude Code to activate integration.

3. Enable Notifications

/audio enable

Claude will now speak when tasks complete.

⚙️ Web Portal

Settings UI at: http://localhost:3131

🧪 Try It

Ask Claude something:

"Hey Claude, create a new React component"

You'll hear: "Task completed successfully"

🧬 How It Works

graph LR
    G[💎 Claude Code] -.->|Task Complete| B[⚙️ ehAye Engine]
    A[🤖 Gemini Code] -->|Phase II| B
    B -->|Text| C[🔊 System Voice]
    C -->|Primary Voice| D[🎧 Developer]
    C -->|Secondary Voice| D

    style G fill:#4285f4,stroke:#1a73e8,color:#ffffff,stroke-dasharray: 5 5
    style A fill:#1976d2,stroke:#0d47a1,color:#ffffff
    style B fill:#7b1fa2,stroke:#4a148c,color:#ffffff
    style C fill:#388e3c,stroke:#1b5e20,color:#ffffff
    style D fill:#f57c00,stroke:#e65100,color:#ffffff

Loading

🎮 CLI Essentials

ehaye audio test         # Check audio
ehaye claude enable      # Enable Claude integration
ehaye engine status      # Engine health

Inside Claude:

/audio enable            # Turn on voice
/audio disable           # Turn off voice

🎭 Voice Management

ehaye audio voice set primary "Nathan (Enhanced)"
ehaye audio voice set secondary "Samantha (Enhanced)"
ehaye audio voice show

# Test specific voices
ehaye audio test --voice primary --say "Testing primary"
ehaye audio test --voice secondary --say "Testing secondary"

Voice Roles:

• Primary: Default for announcements
• Secondary: Alternate for context-specific messages

Popular Voices (macOS):

• Nathan (Enhanced)
• Samantha (Enhanced)
• Alex, Victoria
• Siri Female / Siri Male (Cross-platform)

📚 Full command list →

⚙️ Configuration

• Web: http://localhost:3131
• CLI: ehaye config web

📖 Configuration system →

🧯 Troubleshooting

No Audio?

ehaye audio test
ehaye engine status
ehaye claude status

Disable ehAye Audio in current claude project?

ehaye claude disable # run within project directory
# or from Claude session: /audio disable

Temporarily Mute?

# Via Web Portal @ http://localhost:3131
# Reduce the volume

Full Uninstall

ehaye uninstall --force
npm uninstall -g @eh-aye/audio

📄 License

This project is licensed under the AGPL License - see the LICENSE file for details.

📋 Requirements

• Node.js: 20.x or 22.x
• OS: macOS, Linux, Windows (experimental)
• Claude Code
• Memory: ~60MB runtime

🔒 Security

• No telemetry or tracking
• Local-only data
• Permission-based access
• Engine isolation from daemon
• Fully open source

🤝 Contributing

Contributions welcome. See CONTRIBUTING.md.

Good First Tasks:

• 📚 Improve docs
• 🎨 UI polish
• 🐛 Bug fixes
• 🧪 Add tests
• 💰 Help fund the project

💖 Support

Made by developers, for developers.

• 🎁 Back ehAye Audio
• ⭐ Star on GitHub
• 📢 Share it

---

Made with ❤️ for multitasking developers

Report Bug · Request Feature · Join Discussions