Instant drama the second your code breaks. Audio alerts for terminal errors and editor diagnostics, with one-click status bar controls.
For more: Faah Official Docs
Faah is a lightweight IDE extension that listens for errors and plays a meme sound when they appear.
Default sound is faah, and you can optionally upload/select a custom sound file.
No more silent failures. No more unnoticed broken builds. No more cursed error output.
If your errors get dramatic — Faah gets louder.
Looking for standalone terminal alerts outside VS Code?
Check out the native CLI package:npm install -g faahh
- Plays
faahby default, with optional uploaded custom sound override - Lightweight and fast, with regex-based error detection and configurable patterns/excludes
- Separate cooldown controls for terminal and di 8E3A agnostics sources
- Terminal and editor diagnostics source toggles with diagnostics severity mode
- Terminal detection mode control: output match, non-zero exit code, or either
- Snooze controls (
15m,30m,1h,2h) and clear snooze action - Quiet hours presets plus custom
HH:mmranges - Visual alerts (warning popups) plus audio for every alert
- Quick presets (Balanced, Quiet, Aggressive) to snap into a mood
- Built-in false-positive preset packs for common noisy output
- Settings import/export (JSON) for backups or sharing
- Compatibility status command with full/partial/unavailable terminal host reporting
- Workspace-aware settings (
faah.*) with auto-save Control Room UI - Status bar indicator with source-aware quick actions
Use Faah from the status bar quick actions or Command Palette.
- In your editor, click
Faah Off,Faah T,Faah E, orFaah T+Ein the bottom bar. - Choose what you want: turn Faah on/off, select terminal/editor/both, switch error mode, snooze alerts, set quiet hours, play test sound, or open full settings.
- Settings auto-save instantly in the Control Room; use the schedule presets, compatibility button, or import/export buttons for explicit actions.
Faah also applies a tiny shared cross-source guard window so a terminal error and a diagnostics error fired at nearly the same moment do not double-play two alerts back-to-back. In Control Room, you can also switch terminal detection mode and enable built-in false-positive preset packs.
Command Palette commands:
Faah: Show Quick ActionsFaah: Open SettingsFaah: Play Test SoundFaah: Snooze AlertsFaah: Clear SnoozeFaah: Set Quiet HoursFaah: Show Compatibility Status(raises host compatibility info)Faah: Install Faah CLI (alerts outside the IDE)(opens the CLI install guide)
Faah monitors terminal output and exit codes using the VS Code Terminal Shell Integration API.
Zsh setups (especially with Oh My Zsh, Powerlevel10k, or custom themes) may block automatic shell integration injection.
-
Verify Shell Integration Setting: In VS Code settings, make sure
terminal.integrated.shellIntegration.enabledis checked (true). -
Use Faah CLI instead: The extension only covers terminals inside the IDE. The CLI covers every terminal, sets up zsh, bash or fish for you, and needs no shell integration:
npm i -g faahh faah init faah verify
Run
Faah: Install Faah CLI (alerts outside the IDE)from the Command Palette for the install guide. -
Powerlevel10k Instant Prompt: If using Powerlevel10k, open
~/.p10k.zsh(or~/.zshrc) and set:typeset -g POWERLEVEL9K_INSTANT_PROMPT=quiet(or
off). Instant prompt suppresses VS Code's script injection sequences if left verbose. -
Verify: Open a new terminal. Look for a blue circle decoration in the gutter next to your prompt. That indicates Shell Integration is active.
Faah is perfect when you:
- Run long tasks
- Work with noisy logs
- Switch tabs while working
- Miss subtle error messages
- Want dramatic feedback while coding 😄
Coding is already dramatic.
Faah just makes sure you hear it.
- Md Shoaib Taimur (Idea)
- Toufiq Hasan Kiron (Developer)
MIT License
Contributions are welcome! Please feel free to submit an issue or a pull request.
If you have any questions or feedback, please feel free to contact me at hello@kiron.dev.