ClaudeFlow

Sound notifications for Claude Code - plays sounds when Claude starts, exits, or asks for permission.

Features

Smart Sound Notifications

• Startup Sound: Plays when Claude starts in terminal
• Exit Sound: Plays when Claude exits the session
• Permission Sound: Plays when Claude asks for permission
• Clean, non-intrusive audio feedback

Simple Configuration

• Enable/disable sound notifications with a single setting
• Test sound functionality with built-in command
• Minimal configuration - works out of the box

Terminal Detection

• Monitors for claude command execution
• Detects when Claude creates its own terminal
• Automatic sound triggers without manual setup

User-Friendly

• No complex setup required
• Lightweight and performant
• Works with standard Claude Code installation
• Clean console-free operation

Installation

From VS Code Marketplace

1. Open VS Code
2. Press Ctrl+Shift+X (Windows/Linux) or Cmd+Shift+X (Mac)
3. Search for ClaudeFlow or HimanshuRamchandani.claudeflow
4. Click Install

Direct Install: ClaudeFlow on VS Code Marketplace

Manual Installation

1. Download the latest VSIX file from the Releases page
2. Open VS Code
3. Press Ctrl+Shift+P (Windows/Linux) or Cmd+Shift+P (Mac)
4. Type Extensions: Install from VSIX
5. Select the downloaded VSIX file

Getting Started

After installation, ClaudeFlow automatically starts monitoring your Claude Code activity. Here's how to use it:

Basic Usage

1. Start working with Claude Code in VS Code
2. ClaudeFlow will automatically detect and notify you of:
   • Task completion
   • Permission requests
   • Attention requirements
   • Status changes

Available Commands

Access these commands through the Command Palette (Ctrl+Shift+P or Cmd+Shift+P):

• ClaudeFlow: Test Sound - Test sound functionality to ensure audio works properly

Configuration

Customize ClaudeFlow through VS Code Settings. Search for "ClaudeFlow" or navigate to Settings > Extensions > ClaudeFlow.

Sound Settings

• claudeflow.enableSounds (boolean, default: true)
  • Enable sound notifications for Claude Code activity

Troubleshooting

Common Issues

Notifications Not Appearing

1. Check if claudeflow.enableDesktopNotifications is enabled in settings
2. Verify system notification permissions for VS Code
3. Try the test notification command

Sounds Not Playing

1. Ensure claudeflow.enableSounds is enabled
2. Check system volume and sound settings
3. Verify sound volume is not set to 0.0
4. Test different sound options in settings

Extension Not Detecting Claude Activity

1. Make sure you're actively using Claude Code
2. Check that Claude Code is properly integrated with VS Code
3. Restart VS Code and try again

Getting Help

• Report issues on our GitHub Issues page
• Check the FAQ for common questions
• Read our Contributing Guide to help improve the project

Contributing

We welcome contributions to ClaudeFlow! This project is open source and community-driven.

How to Contribute

1. Fork the Repository: Click the "Fork" button on GitHub and clone your fork locally
2. Create a Branch: Make a new branch for your feature or bug fix
3. Make Changes: Implement your changes with clean, readable code
4. Test Your Changes: Ensure everything works properly
5. Submit Pull Request: Open a pull request with a clear description

Development Setup

1. Clone the repository:

   git clone https://github.com/hemansnation/ClaudeFlow.git
   cd ClaudeFlow
   

2. Install dependencies:

   npm install
   

3. Compile TypeScript:

   npm run compile
   

4. Run in development mode:

   • Open VS Code
   • Press F5 to launch Extension Development Host
   • Test the extension

Contribution Guidelines

• Follow the existing code style and conventions
• Keep changes minimal and focused
• Test your changes thoroughly
• Update documentation if needed
• Be respectful and constructive in discussions

Areas for Contribution

• Bug Reports: Help us identify and fix issues
• Feature Requests: Suggest new functionality
• Sound Customization: Add more sound options
• Platform Support: Improve compatibility across operating systems
• Documentation: Help improve documentation and examples

License

This project is licensed under the MIT License. See the LICENSE file for details.

Changelog

Version 1.0.1

• Added extension icon
• Improved package structure
• Enhanced marketplace visibility

Version 1.0.0

• Initial release
• Smart notifications for Claude Code
• Cross-platform sound support
• Status bar integration
• Comprehensive configuration options

Support ClaudeFlow Development

If you find ClaudeFlow useful, please consider:

• Rating the extension on the VS Code Marketplace
• Reporting bugs and feature requests
• Contributing to the project on GitHub
• Sharing with other Claude Code users

Extension Page: ClaudeFlow on VS Code Marketplace

ClaudeFlow is not officially affiliated with Anthropic or Claude Code. It is an independent extension designed to enhance the Claude Code experience.