FAQ: Troubleshooting and Common Issues

This section helps you resolve various issues encountered when using opencode-notify, including troubleshooting and answering common questions.

Learning Path

We recommend learning the content of this section in the following order:

1. Troubleshooting

Solve technical issues when using the plugin

• 6 possible causes for notifications not displaying and troubleshooting steps
• How to fix macOS focus detection failures
• Tips for fixing configuration file errors
• Handling sound not playing and notification click-to-focus issues
• Platform feature differences

2. Common Questions

Learn about plugin performance, privacy, and compatibility

• Impact on AI context and system resources
• Privacy, security, and data handling
• Notification strategy and smart filtering mechanisms
• Plugin compatibility and platform differences
• Terminal support and configuration file management

Prerequisites

Before diving deep into this section, we recommend you have completed:

• Quick Start - Learn the basic installation and usage of the plugin

Next Steps

After completing this section, you can continue learning:

• Event Types - Deep dive into the OpenCode events monitored by the plugin
• Configuration File Example - View a complete configuration file example