v0.3.5 - Audio Notifications & Configuration Wizard

Release v0.3.5 - Audio Notifications & Configuration Wizard

🎉 New Features

🔊 Audio Notifications

Play a sound when the agent completes a turn to know when responses are ready!

• Configurable: Enable/disable via audio.enabled config (default: enabled)
• Customizable: Use your own WAV file with audio.notification_sound config
• Cross-platform: Works on macOS (afplay), Linux (aplay/paplay), and Windows (winsound)
• Bundled sound: Includes a pleasant notification sound out of the box
• Per-agent control: Override audio settings for specific agents

🧙 Interactive Configuration Wizard

New --wizard / -w flag to interactively configure your .chatrc settings!

• Guided setup: Walk through all available settings section by section
• Smart defaults: Shows your current values when editing existing configs
• Input validation: Validates all input types (bool, int, float, string)
• Dual scope: Create global (~/.chatrc) or project-level (./.chatrc) configs
• Well-formatted: Generates clean YAML with helpful comments
• Secure: Creates config files with secure permissions (0o600)

🔧 Improvements

• Enhanced type annotations for platform-specific imports
• Code quality improvements with ruff formatting
• Fixed type checking issues with winsound and yaml imports

📦 Installation

pip install basic-agent-chat-loop==0.3.5

🚀 Quick Start

Configure your settings interactively:

chat_loop --wizard

Disable audio notifications:

# ~/.chatrc
audio:
  enabled: false

Use a custom notification sound:

# ~/.chatrc
audio:
  enabled: true
  notification_sound: ~/my-sounds/ding.wav

📊 Stats

• ✅ All 181 tests passing
• 📝 Full type coverage with mypy
• 🎨 Code formatted with ruff
• 📚 Comprehensive documentation

🙏 Feedback

Found a bug or have a feature request? Please open an issue!