Reminder - Sound Notifications for Claude Code

Never miss a Claude Code event again!
Get audio and visual notifications for permission requests and task completions.

✨ Features

• 🔊 Custom Sound Effects - Play audio alerts for Claude Code events
• 🔔 Visual Notifications - Toast notifications in your editor
• 📋 Task Tracking - See completed tasks in the sidebar
• 📊 Status Bar Updates - Real-time activity indicator
• ⚙️ Fully Customizable - Use your own sound files and adjust volume

🚀 Quick Start

1. Install the extension from the VS Code/Cursor marketplace
2. Add sound files (or use defaults)
3. Configure Claude Code hooks in ~/.claude/settings.json
4. Start coding with Claude Code!

📦 Installation

From Marketplace (Recommended)

1. Open Extensions in VS Code/Cursor (Cmd+Shift+X)
2. Search for "Reminder"
3. Click Install

From VSIX File

1. Download the latest .vsix from Releases
2. Open Extensions → ... menu → Install from VSIX

⚙️ Setup

Step 1: Add Claude Code Hooks

Edit your ~/.claude/settings.json:

{
  "hooks": {
    "PermissionRequest": [{
      "hooks": [{
        "type": "command",
        "command": "node ~/.vscode/extensions/vishal2422.reminder-*/hook-bridge/claude-hook.js permission_request '{\"tool\":\"{{tool}}\",\"description\":\"{{description}}\"}'",
        "async": true
      }]
    }],
    "TaskCompleted": [{
      "hooks": [{
        "type": "command",
        "command": "node ~/.vscode/extensions/vishal2422.reminder-*/hook-bridge/claude-hook.js task_completed '{\"taskId\":\"{{id}}\",\"subject\":\"{{subject}}\"}'",
        "async": true
      }]
    }]
  }
}

Step 2: Customize Sounds (Optional)

The extension includes default sounds, but you can use your own:

1. Open Settings (Cmd+,)
2. Search for "Reminder"
3. Set custom paths for:
   • Reminder.sounds.permissionRequest
   • Reminder.sounds.taskCompleted
4. Adjust volume with Reminder.sounds.volume

🎵 Using Your Own Sounds

Want custom notification sounds?

1. Find or create MP3/WAV files
2. Go to Extension Settings
3. Set paths to your sound files:
   • Permission sound: /path/to/your/alert.mp3
   • Completion sound: /path/to/your/success.mp3

Tip: Keep sounds short (0.5-2 seconds) for best results.

🎯 How It Works

Claude Code Terminal
    ↓ (triggers hook)
Hook Bridge Script
    ↓ (sends event via Unix socket)
VS Code Extension
    ↓ (plays sound + shows notification)
You Get Notified! 🎉

🛠️ Configuration Options

📋 Available Commands

Open Command Palette (Cmd+Shift+P) and search:

• Reminder: Open Settings - Quick access to settings
• Reminder: Refresh Tasks - Manually refresh task list
• Reminder: Test Permission Sound - Preview permission sound
• Reminder: Test Complete Sound - Preview completion sound
• Reminder: Clear Completed Tasks - Remove completed tasks
• Reminder: Clear All Tasks - Clear entire task list

🐛 Troubleshooting

No sound playing?

1. Check sound files exist
2. Verify volume isn't muted: reminder.sounds.volume
3. Test sounds manually: Command Palette → "Test Permission Sound"

Tasks not appearing?

1. Verify hooks are configured in ~/.claude/settings.json
2. Check socket exists: ls -la /tmp/claude-code-vscode.sock
3. Restart VS Code/Cursor

Extension not loading?

1. Check for errors: View → Output → select "Reminder"
2. Verify Node.js is installed: node --version
3. Reload window: Command Palette → "Reload Window"

🤝 Contributing

Contributions welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

📝 License

MIT License - see LICENSE file for details.

🙏 Credits

Built with ❤️ for the Claude Code community.

Special thanks to:

• Anthropic for Claude Code
• The VS Code extension API
• Open source contributors

📞 Support

• 🐛 Report a bug
• 💡 Request a feature
• ⭐ Star on GitHub

Made for Claude Code users who want better notifications 🔔