opencode-smart-voice-notify 1.2.5 → 1.3.1

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 MasuRii
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 MasuRii
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,25 +1,35 @@
-<!-- Dynamic Header -->
-<img width="100%" src="https://capsule-render.vercel.app/api?type=waving&color=0:667eea,100:764ba2&height=120&section=header"/>
+<!-- Dynamic Header -->
+<img width="100%" src="https://capsule-render.vercel.app/api?type=waving&color=0:667eea,100:764ba2&height=120&section=header"/>
+
+# OpenCode Smart Voice Notify
+
+[![npm version](https://img.shields.io/npm/v/opencode-smart-voice-notify?color=blue&logo=npm)](https://www.npmjs.com/package/opencode-smart-voice-notify)
+[![npm downloads](https://img.shields.io/npm/dm/opencode-smart-voice-notify?color=blue&logo=npm)](https://www.npmjs.com/package/opencode-smart-voice-notify)
+[![GitHub release](https://img.shields.io/github/v/release/MasuRii/opencode-smart-voice-notify?logo=github)](https://github.com/MasuRii/opencode-smart-voice-notify/releases)
+[![CI](https://img.shields.io/github/actions/workflow/status/MasuRii/opencode-smart-voice-notify/test.yml?branch=master&logo=github&label=tests)](https://github.com/MasuRii/opencode-smart-voice-notify/actions/workflows/test.yml)
+[![License](https://img.shields.io/github/license/MasuRii/opencode-smart-voice-notify?color=green)](https://github.com/MasuRii/opencode-smart-voice-notify/blob/master/LICENSE)
+[![Node](https://img.shields.io/node/v/opencode-smart-voice-notify?color=brightgreen&logo=node.js)](https://nodejs.org)
+[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey?logo=windows-terminal)](https://github.com/MasuRii/opencode-smart-voice-notify#platform-support-matrix)
 
-# OpenCode Smart Voice Notify
 
 > **Disclaimer**: This project is not built by the OpenCode team and is not affiliated with [OpenCode](https://opencode.ai) in any way. It is an independent community plugin.
 
-A smart voice notification plugin for [OpenCode](https://opencode.ai) with **multiple TTS engines** and an intelligent reminder system.
+A smart voice notification plugin for [OpenCode](https://opencode.ai) with **multiple TTS engines**, native desktop notifications, and an intelligent reminder system.
 
 <img width="1456" height="720" alt="image" src="https://github.com/user-attachments/assets/52ccf357-2548-400b-a346-6362f2fc3180" />
 
 
 ## Features
 
-### Smart TTS Engine Selection
-The plugin automatically tries multiple TTS engines in order, falling back if one fails:
-
-1. **OpenAI-Compatible** (Cloud/Self-hosted) - Any OpenAI-compatible `/v1/audio/speech` endpoint (Kokoro, LocalAI, Coqui, AllTalk, OpenAI API, etc.)
-2. **ElevenLabs** (Online) - High-quality, anime-like voices with natural expression
-3. **Edge TTS** (Free) - Microsoft's neural voices, native Node.js implementation (no Python required)
-4. **Windows SAPI** (Offline) - Built-in Windows speech synthesis
-5. **Local Sound Files** (Fallback) - Plays bundled MP3 files if all TTS fails
+### Smart TTS Engine Selection
+The plugin automatically tries multiple TTS engines in order, falling back if one fails:
+
+1. **OpenAI-Compatible** (Cloud/Self-hosted) - Any OpenAI-compatible `/v1/audio/speech` endpoint (Kokoro, LocalAI, Coqui, AllTalk, OpenAI API, etc.)
+2. **ElevenLabs** (Online) - High-quality, anime-like voices with natural expression
+3. **Edge TTS** (Free) - Microsoft's neural voices via Python CLI (recommended) or native npm fallback
+4. **Windows SAPI** (Offline) - Built-in Windows speech synthesis
+5. **macOS Say** (Offline) - Built-in macOS speech synthesis
+6. **Local Sound Files** (Fallback) - Plays bundled MP3 files if all TTS fails
 
 ### Smart Notification System
 - **Sound-first mode**: Play a sound immediately, then speak a TTS reminder if user doesn't respond
@@ -28,6 +38,7 @@ The plugin automatically tries multiple TTS engines in order, falling back if on
 - **Sound-only mode**: Just play sounds, no TTS
 
 ### Intelligent Reminders
+- **Granular Control**: Enable or disable notifications and reminders for specific event types (Idle, Permission, Question, Error) via configuration.
 - Delayed TTS reminders if user doesn't respond within configurable time
 - Follow-up reminders with exponential backoff
 - Automatic cancellation when user responds
@@ -44,11 +55,15 @@ The plugin automatically tries multiple TTS engines in order, falling back if on
 - **Smart fallback**: Automatically falls back to static messages if AI is unavailable
 
 ### System Integration
+- **Native Desktop Notifications**: Windows (Toast), macOS (Notification Center), and Linux (notify-send) support
 - **Native Edge TTS**: No external dependencies (Python/pip) required
-- Wake monitor from sleep before notifying
-- Auto-boost volume if too low
-- TUI toast notifications
-- Cross-platform support (Windows, macOS, Linux)
+- **Focus Detection** (macOS): Suppresses notifications when terminal is focused
+- **Webhook Integration**: Receive notifications on Discord or any custom webhook endpoint when tasks finish or need attention
+- **Themed Sound Packs**: Use custom sound collections (e.g., Warcraft, StarCraft) by simply pointing to a directory
+- **Per-Project Sounds**: Assign unique sounds to different projects for easy identification
+- **Wake monitor** from sleep before notifying
+- **Auto-boost volume** if too low
+- **TUI toast** notifications
 
 ## Installation
 
@@ -106,13 +121,6 @@ If you prefer to create the config manually, add a `smart-voice-notify.jsonc` fi
 
 ```jsonc
 {
-    // ============================================================
-    // OpenCode Smart Voice Notify - Quick Start Configuration
-    // ============================================================
-    // For ALL available options, see example.config.jsonc in the plugin.
-    // The plugin auto-creates a comprehensive config on first run.
-    // ============================================================
-
     // Master switch to enable/disable the plugin without uninstalling
     "enabled": true,
 
@@ -137,22 +145,39 @@ If you prefer to create the config manually, add a `smart-voice-notify.jsonc` fi
     "edgePitch": "+50Hz",
     "edgeRate": "+10%",
     
+    // Desktop Notifications
+    "enableDesktopNotification": true,
+    "desktopNotificationTimeout": 5,
+    "showProjectInNotification": true,
+
     // TTS reminder settings
     "enableTTSReminder": true,
     "ttsReminderDelaySeconds": 30,
     "enableFollowUpReminders": true,
-    "maxFollowUpReminders": 3,
     
+    // Focus Detection (macOS only)
+    "suppressWhenFocused": true,
+    "alwaysNotify": false,
+
     // AI-generated messages (optional - requires local AI server)
     "enableAIMessages": false,
     "aiEndpoint": "http://localhost:11434/v1",
-    "aiModel": "llama3",
-    "aiApiKey": "",
-    "aiFallbackToStatic": true,
     
+    // Webhook settings (optional - works with Discord)
+    "enableWebhook": false,
+    "webhookUrl": "",
+    "webhookUsername": "OpenCode Notify",
+    
+    // Sound theme settings (optional)
+    "soundThemeDir": "", // Path to custom sound theme directory
+    
+    // Per-project sounds
+    "perProjectSounds": false,
+    "projectSoundSeed": 0,
+
     // General settings
     "wakeMonitor": true,
-    "forceVolume": true,
+    "forceVolume": false,
     "volumeThreshold": 50,
     "enableToast": true,
     "enableSound": true,
@@ -162,9 +187,9 @@ If you prefer to create the config manually, add a `smart-voice-notify.jsonc` fi
 
 For the complete configuration with all TTS engine settings, message arrays, AI prompts, and advanced options, see [`example.config.jsonc`](./example.config.jsonc) in the plugin directory.
 
-### OpenAI-Compatible TTS Setup (Kokoro, LocalAI, OpenAI API, etc.)
-
-For cloud-based or self-hosted TTS using any OpenAI-compatible `/v1/audio/speech` endpoint:
+### OpenAI-Compatible TTS Setup (Kokoro, LocalAI, OpenAI API, etc.)
+
+For cloud-based or self-hosted TTS using any OpenAI-compatible `/v1/audio/speech` endpoint:
 
 ```jsonc
 {
@@ -203,12 +228,15 @@ If you want dynamic, AI-generated notification messages instead of preset ones,
      "aiEndpoint": "http://localhost:11434/v1",
      "aiModel": "llama3",
      "aiApiKey": "",
-     "aiFallbackToStatic": true
+     "aiFallbackToStatic": true,
+     "enableContextAwareAI": false  // Set to true for personalized messages with project/task context
    }
    ```
 
 3. **The AI will generate unique messages** for each notification, which are then spoken by your TTS engine.
 
+4. **Context-Aware Messages** (optional): Enable `enableContextAwareAI` for personalized notifications that include project name, task title, and change summary (e.g., "Your work on MyProject is complete!").
+
 **Supported AI Servers:**
 | Server | Default Endpoint | API Key |
 |--------|-----------------|---------|
@@ -218,33 +246,154 @@ If you want dynamic, AI-generated notification messages instead of preset ones,
 | vLLM | `http://localhost:8000/v1` | Use "EMPTY" |
 | Jan.ai | `http://localhost:1337/v1` | Required |
 
+### Discord / Webhook Integration (Optional)
+
+Receive remote notifications on Discord or any custom endpoint. This is perfect for long-running tasks when you're away from your computer.
+
+1. **Create a Discord Webhook**:
+   - In Discord, go to **Server Settings** > **Integrations** > **Webhooks**.
+   - Click **New Webhook**, choose a channel, and click **Copy Webhook URL**.
+
+2. **Enable Webhooks in your config**:
+   ```jsonc
+   {
+     "enableWebhook": true,
+     "webhookUrl": "https://discord.com/api/webhooks/...",
+     "webhookUsername": "OpenCode Notify",
+     "webhookEvents": ["idle", "permission", "error", "question"],
+     "webhookMentionOnPermission": true
+   }
+   ```
+
+3. **Features**:
+   - **Color-coded Embeds**: Different colors for task completion (green), permissions (orange), errors (red), and questions (blue).
+   - **Smart Mentions**: Automatically @everyone on Discord for urgent permission requests.
+   - **Rate Limiting**: Intelligent retry logic with backoff if Discord's rate limits are hit.
+    - **Fire-and-forget**: Webhook requests never block local sound or TTS playback.
+
+**Supported Webhook Events:**
+| Event | Trigger |
+|-------|---------|
+| `idle` | Agent finished working |
+| `permission` | Agent needs permission for a tool |
+| `error` | Agent encountered an error |
+| `question` | Agent is asking you a question |
+
+
+### Custom Sound Themes (Optional)
+
+You can replace individual sound files with entire "Sound Themes" (like the classic Warcraft II or StarCraft sound packs).
+
+1. **Set up your theme directory**:
+   Create a folder (e.g., `~/.config/opencode/themes/warcraft2/`) with the following structure:
+   ```text
+   warcraft2/
+   ├── idle/          # Sounds for when the agent finishes
+   │   ├── job_done.mp3
+   │   └── alright.wav
+   ├── permission/    # Sounds for permission requests
+   │   ├── help.mp3
+   │   └── need_orders.wav
+   ├── error/         # Sounds for agent errors
+   │   └── alert.mp3
+   └── question/      # Sounds for agent questions
+       └── yes_milord.mp3
+   ```
+
+2. **Configure the theme in your config**:
+   ```jsonc
+   {
+     "soundThemeDir": "themes/warcraft2",
+     "randomizeSoundFromTheme": true
+   }
+   ```
+
+3. **Features**:
+   - **Automatic Fallback**: If a theme subdirectory or sound is missing, the plugin automatically falls back to your default sound files.
+   - **Randomization**: If multiple sounds are in a subdirectory, the plugin will pick one at random each time (if `randomizeSoundFromTheme` is `true`).
+   - **Relative Paths**: Paths are relative to your OpenCode config directory (`~/.config/opencode/`).
+
+
 ## Requirements
 
-### For OpenAI-Compatible TTS
-- Any server implementing the `/v1/audio/speech` endpoint
-- Examples: [Kokoro](https://github.com/remsky/Kokoro-FastAPI), [LocalAI](https://localai.io), [AllTalk](https://github.com/erew123/alltalk_tts), OpenAI API, etc.
-- Works with both local self-hosted servers and cloud-based providers.
+### Platform Support Matrix
+
+| Feature | Windows | macOS | Linux |
+|---------|:---:|:---:|:---:|
+| **Sound Playback** | ✅ | ✅ | ✅ |
+| **TTS (Cloud/Edge)** | ✅ | ✅ | ✅ |
+| **TTS (Windows SAPI)** | ✅ | ❌ | ❌ |
+| **TTS (macOS Say)** | ❌ | ✅ | ❌ |
+| **Desktop Notifications** | ✅ | ✅ | ✅ (req libnotify) |
+| **Focus Detection** | ❌ | ✅ | ❌ |
+| **Webhook Integration** | ✅ | ✅ | ✅ |
+| **Wake Monitor** | ✅ | ✅ | ✅ (X11/Gnome) |
+| **Volume Control** | ✅ | ✅ | ✅ (Pulse/ALSA) |
+
+### For OpenAI-Compatible TTS
+- Any server implementing the `/v1/audio/speech` endpoint
+- Examples: [Kokoro](https://github.com/remsky/Kokoro-FastAPI), [LocalAI](https://localai.io), [AllTalk](https://github.com/erew123/alltalk_tts), OpenAI API, etc.
+- Works with both local self-hosted servers and cloud-based providers.
 
 ### For ElevenLabs TTS
 - ElevenLabs API key (free tier: 10,000 characters/month)
 - Internet connection
 
-### For Edge TTS
-- Internet connection (No external dependencies required)
+### For Edge TTS
+- Internet connection required
+- **Recommended**: Install Python edge-tts for best reliability: `pip install edge-tts`
+- **Fallback**: Works without Python (uses bundled npm package), but may be less reliable
+- If Edge TTS fails, automatically falls back to SAPI (Windows) or Say (macOS)
+
+### For Windows SAPI
+- Windows OS (uses built-in System.Speech)
+
+### For macOS Say
+- macOS (uses built-in `say` command)
+- Serves as fallback when other TTS engines fail
+
+### For Desktop Notifications
+- **Windows**: Built-in (uses Toast notifications)
+- **macOS**: Built-in (uses Notification Center)
+- **Linux**: Requires `notify-send` (libnotify)
+  ```bash
+  # Ubuntu/Debian
+  sudo apt install libnotify-bin
 
-### For Windows SAPI
-- Windows OS (uses built-in System.Speech)
+  # Fedora
+  sudo dnf install libnotify
+
+  # Arch Linux
+  sudo pacman -S libnotify
+  ```
 
 ### For Sound Playback
 - **Windows**: Built-in (uses Windows Media Player)
 - **macOS**: Built-in (`afplay`)
 - **Linux**: `paplay` or `aplay`
 
+### For Focus Detection
+Focus detection suppresses sound and desktop notifications when the terminal is focused.
+
+| Platform | Support | Notes |
+|----------|---------|-------|
+| **macOS** | ✅ Full | Uses AppleScript to detect frontmost application |
+| **Windows** | ❌ Not supported | No reliable API available |
+| **Linux** | ❌ Not supported | Varies by desktop environment |
+
+> **Note**: On unsupported platforms, notifications are always sent (fail-open behavior). TTS reminders are never suppressed, even when focused, since users may step away after seeing the toast.
+
+### For Webhook Notifications
+- **Discord**: Full support for Discord's webhook embed format.
+- **Generic**: Works with any endpoint that accepts a POST request with a JSON body (though formatting is optimized for Discord).
+- **Rate Limits**: The plugin handles HTTP 429 (Too Many Requests) automatically with retries and a 250ms queue delay.
+
 ## Events Handled
 
 | Event | Action |
 |-------|--------|
 | `session.idle` | Agent finished working - notify user |
+| `session.error` | Agent encountered an error - alert user |
 | `permission.asked` | Permission request (SDK v1.1.1+) - alert user |
 | `permission.updated` | Permission request (SDK v1.0.x) - alert user |
 | `permission.replied` | User responded - cancel pending reminders |
@@ -282,26 +431,155 @@ To develop on this plugin locally:
    }
    ```
 
-## Updating
+### Testing
 
-OpenCode does not automatically update plugins. To update to the latest version:
+The plugin uses [Bun](https://bun.sh)'s built-in test runner for unit and E2E tests.
 
 ```bash
-# Clear the cached plugin
-rm -rf ~/.cache/opencode/node_modules/opencode-smart-voice-notify
+# Run all tests
+bun test
 
-# Run OpenCode to trigger a fresh install
-opencode
-```
+# Run tests with coverage
+bun test --coverage
 
-## License
+# Run tests in watch mode
+bun test --watch
+```
 
-MIT
+For more detailed testing guidelines and mock usage examples, see [CONTRIBUTING.md](./CONTRIBUTING.md).
 
-## Support
+## Updating
 
-- Open an issue on [GitHub](https://github.com/MasuRii/opencode-smart-voice-notify/issues)
-- Check the [OpenCode docs](https://opencode.ai/docs/plugins)
+OpenCode does not automatically update plugins. To update to the latest version:
 
-<!-- Dynamic Header -->
-<img width="100%" src="https://capsule-render.vercel.app/api?type=waving&color=0:667eea,100:764ba2&height=120&section=header"/>
+```bash
+# Clear the cached plugin
+rm -rf ~/.cache/opencode/node_modules/opencode-smart-voice-notify
+
+# Run OpenCode to trigger a fresh install
+opencode
+```
+
+<!--
+LLM-AGENT-INSTRUCTIONS (Hidden from rendered markdown, visible to AI assistants scanning raw file)
+
+## LLM Instructions
+
+> This section provides structured guidance for AI assistants (Claude, GPT, Cursor, Copilot, etc.) helping users set up and configure this plugin.
+
+### Quick Setup (Execute These Steps)
+
+When a user asks you to set up this plugin, follow these steps:
+
+1. **Add plugin to OpenCode config** - Edit `~/.config/opencode/opencode.json`:
+   ```json
+   {
+     "$schema": "https://opencode.ai/config.json",
+     "plugin": ["opencode-smart-voice-notify@latest"]
+   }
+   ```
+
+2. **Run OpenCode once** - This auto-generates the configuration file at `~/.config/opencode/smart-voice-notify.jsonc`
+
+3. **Configure based on user's TTS preference**:
+   - **Free/No API key**: Use Edge TTS (default, works out of box)
+   - **High quality**: Use ElevenLabs (requires API key)
+   - **Self-hosted**: Use OpenAI-compatible endpoint (Kokoro, LocalAI, etc.)
+   - **Offline Windows**: Use Windows SAPI
+   - **Offline macOS**: Use macOS Say (built-in fallback)
+
+### Configuration Tasks
+
+#### Task: Enable ElevenLabs TTS
+```jsonc
+// In ~/.config/opencode/smart-voice-notify.jsonc
+{
+  "ttsEngine": "elevenlabs",
+  "elevenLabsApiKey": "USER_API_KEY_HERE",
+  "elevenLabsVoiceId": "cgSgspJ2msm6clMCkdW9"
+}
+```
+**Note**: User must get API key from https://elevenlabs.io/app/settings/api-keys
+
+#### Task: Enable OpenAI-Compatible TTS (Kokoro, LocalAI, etc.)
+```jsonc
+{
+  "ttsEngine": "openai",
+  "openaiTtsEndpoint": "http://localhost:8880",
+  "openaiTtsVoice": "af_heart",
+  "openaiTtsModel": "kokoro"
+}
+```
+**Note**: User must have a compatible TTS server running locally or remotely.
+
+#### Task: Enable Discord Webhook Notifications
+```jsonc
+{
+  "enableWebhook": true,
+  "webhookUrl": "https://discord.com/api/webhooks/...",
+  "webhookEvents": ["idle", "permission", "error", "question"],
+  "webhookMentionOnPermission": true
+}
+```
+
+#### Task: Enable AI-Generated Messages (requires local AI server)
+```jsonc
+{
+  "enableAIMessages": true,
+  "aiEndpoint": "http://localhost:11434/v1",
+  "aiModel": "llama3"
+}
+```
+**Note**: Requires Ollama, LM Studio, or similar running locally.
+
+#### Task: Set Up Custom Sound Theme
+```jsonc
+{
+  "soundThemeDir": "themes/warcraft2",
+  "randomizeSoundFromTheme": true
+}
+```
+**Directory structure**: `~/.config/opencode/themes/warcraft2/{idle,permission,error,question}/*.mp3`
+
+### Common Issues & Fixes
+
+| Issue | Solution |
+|-------|----------|
+| No sound playing | Check `"enableSound": true` and verify audio files exist in `~/.config/opencode/assets/` |
+| TTS not working | Try fallback: change `"ttsEngine"` to `"edge"` (free, no API key) |
+| ElevenLabs quota exceeded | Plugin auto-falls back to Edge TTS; or set `"ttsEngine": "edge"` |
+| Notifications too frequent | Increase `"ttsReminderDelaySeconds"` (default: 30) |
+| Want to disable completely | Set `"enabled": false` in config |
+| Edge TTS not speaking | Install Python edge-tts: `pip install edge-tts` |
+
+### Platform-Specific Notes
+
+- **Windows**: All features supported, SAPI as offline fallback
+- **macOS**: Focus detection available, `say` command as offline fallback
+- **Linux**: Requires `libnotify-bin` for desktop notifications, no offline TTS fallback
+
+### TTS Fallback Chain
+
+Primary Engine → Edge TTS → Windows SAPI → macOS Say → Sound File
+
+### Done When
+
+The plugin is successfully configured when:
+- [ ] `~/.config/opencode/opencode.json` contains the plugin entry
+- [ ] `~/.config/opencode/smart-voice-notify.jsonc` exists with user's settings
+- [ ] Running `opencode` produces audio notification when agent finishes a task
+
+END LLM-AGENT-INSTRUCTIONS
+-->
+
+## License
+
+MIT
+
+## Support
+
+- Open an issue on [GitHub](https://github.com/MasuRii/opencode-smart-voice-notify/issues)
+- Check the [OpenCode docs](https://opencode.ai/docs/plugins)
+
+<!-- Dynamic Header -->
+<img width="100%" src="https://capsule-render.vercel.app/api?type=waving&color=0:667eea,100:764ba2&height=120&section=header"/>