Operating System Alerts

Sypha utilizes native system notifications to keep you updated on progress, even when your focus is outside of VS Code. These alerts appear in your OS's standard notification center, ensuring visibility during long-running background tasks.

Notification Triggers

• Task Finalization: Alerts you the moment a complex or time-intensive operation completes.
• System Warnings: Provides immediate feedback regarding critical failures or configuration issues.
• Progress Updates: Tracks significant milestones during multi-step background workflows.

Environment Requirements

macOS

• Default integration: Automatically utilizes AppleScript for standard system messages.
• Enhanced Visuals: For custom icons and audible alerts, install the terminal-notifier package:

  brew install terminal-notifier

Windows

Requires a simple adjustment to the PowerShell execution policy:

1. Launch PowerShell as an Administrator.
2. Execute the following: Set-ExecutionPolicy RemoteSigned -Scope CurrentUser.
3. Fully compatible with Windows 10/11 environments.

Linux

Relies on standard libnotify utilities:

• Debian / Ubuntu: sudo apt install libnotify-bin
• Fedora: sudo dnf install libnotify
• Arch: sudo pacman -S libnotify

Troubleshooting Notification Issues

• macOS: Ensure VS Code is permitted to send alerts under System Settings -> Notifications.
• Windows: Confirm that "Focus Assist" (or "Do Not Disturb") is inactive and verify the PowerShell policy mentioned above.
• Linux: Verify that a notification daemon (such as dunst or your DE's standard handler) is active.