An audible alert for VS Code — get notified the moment a terminal command fails, without having to watch the screen.
Faah monitors your integrated terminals in the background. When a command fails, it plays a sound. It triggers on two conditions:
- Exit code — the command exits with a non-zero status
- Error output — the output contains words like
error,failed,fatal,exception,traceback, orpanic
A short cooldown prevents repeated playback for the same failure.
Linux only. One of the following audio players must be installed:
| Player | Install |
|---|---|
| mpg123 | sudo apt install mpg123 |
| ffplay | sudo apt install ffmpeg |
| cvlc | sudo apt install vlc |
The extension tries them in order and uses the first one found. If none are available, a notification will guide you.
No sound plays
- Ensure at least one audio player from the list above is installed
- Check that your system volume is not muted
Errors not detected
Faah uses VS Code's built-in shell integration, which is active by default for bash, zsh, fish, and PowerShell. It does not work with cmd.exe. If the circle indicator is missing from the terminal toolbar, shell integration is not active in that session.
Issues and pull requests are welcome at github.com/saidurpulok/faah-for-error.