Agent Alert 🎵⚡
The ultimate auditory notification & gamified streak tracking system for AI-assisted coding.
Never stare blankly at a screen waiting for AI code generation, background builds, or long terminal commands again!
Agent Alert keeps you in flow state with instant auditory cues when your AI finishes generating code, plays the viral "Fahh" sound when tasks or terminal commands fail, and keeps you motivated with an in-IDE Daily Coding Streak & "Touch Grass" Badge Tracker right in your status bar.
🔥 Key Features at a Glance
1. 🎵 Auditory Notifications for AI Code Generation
- Intelligent Heuristics: Automatically detects when background AI agents (Gemini, Copilot, Antigravity, Claude, Cursor) finish streaming large code blocks and immediately plays your success chime.
- Task & Build Integration: Plays sounds the instant your background tasks, compilation steps, or test runs complete.
- Built-in System Sound Presets:
- macOS: Glass, Hero, Ping, Submarine, Funk, Morse, Tink, Sosumi
- Windows: Tada, Chimes, Ding, Notify
- Custom Audio Files: Supply your own path to any local
.mp3, .wav, or .aiff file for personalized alert sounds.
- Playback Duration Control: Cut off long audio files cleanly after a set duration (e.g., 1500ms).
2. 🚨 Viral "Fahh" Failure & Error Sound Alert
- Terminal Command Failure: Automatically triggers the iconic "Fahh" error sound whenever a terminal command exits with a non-zero exit code (
exitCode ≠ 0).
- Build & Task Failures: Plays the failure sound whenever background npm scripts, test runners, or compilation tasks fail.
- Compiler Diagnostic Checks: Alerts you if incoming AI code insertions trigger compiler error diagnostics.
- Interactive Test: Trigger
Agent Alert: Play Error Sound Now (Fahh) from the Command Palette anytime to test your audio setup!
3. 🎮 Daily Coding Streak & "Touch Grass" Badge System
- Real-Time Status Bar Widget: Keep track of your active coding streak and daily line count live in the bottom status bar (
🔥 3d | 📜 1.2k/5k lines | 🌱 Touch Grass).
- Interactive Streak Dashboard: Click the status bar widget or run
Agent Alert: Show Coding Streak & Badges to view your detailed stats and unlocked achievements.
- Unlockable Badges:
- 👶 Baby Steps: First day coding with Agent Alert.
- 🔥 On Fire: 3-day consecutive coding streak.
- 🛡️ Week Warrior: 7-day coding streak.
- 🚀 Unstoppable: 30-day coding marathon.
- 🌱 Touch Grass: Generated 5,000+ lines in a single day (triggers a celebratory popup reminding you to step outside and take a healthy break!).
- 🏃 Code Marathoner: Generated 10,000+ lines in a single day.
🚀 Quick Start Guide
- Install the extension from the VS Code Marketplace or Open VSX.
- Open Settings: Press
Cmd + , (macOS) or Ctrl + , (Windows/Linux) and search for "Agent Alert".
- Pick your sounds: Choose your preferred success chime (
agentAlert.presetSound) and error alert (agentAlert.errorPresetSound).
- Code with AI: As soon as your AI agent finishes generating code or a terminal command fails, you'll hear your sound alert!
⚙️ Configuration Settings
Customize every aspect of Agent Alert in VS Code Settings:
| Setting |
Type |
Default |
Description |
agentAlert.presetSound |
string |
"Glass" / "Tada" |
Built-in sound preset to play on successful AI generation or task completion. |
agentAlert.customSoundPath |
string |
"" |
Absolute file path to a custom .mp3, .wav, or .aiff file for success alerts. |
agentAlert.playbackDuration |
number |
0 |
Sound cut-off duration in milliseconds (0 = play complete sound). |
agentAlert.heuristicTimeout |
number |
2500 |
Milliseconds of silence after AI generation before triggering alert. |
agentAlert.enableErrorAlert |
boolean |
true |
Enable playing sound alerts when terminal commands, tasks, or builds fail. |
agentAlert.errorPresetSound |
string |
"Fahh" |
Preset sound effect to play on errors and failures. |
agentAlert.customErrorSoundPath |
string |
"" |
Absolute file path to a custom sound file to play on errors. |
agentAlert.enableStreakStatusBar |
boolean |
true |
Show the live coding streak and line counter widget in the status bar. |
agentAlert.dailyLineGoal |
number |
5000 |
Daily line generation threshold to unlock the "Touch Grass" badge. |
agentAlert.enableTouchGrassAlert |
boolean |
true |
Show a congratulatory notification when reaching your daily line goal. |
⌨️ Command Palette Reference
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) and type Agent Alert:
| Command |
Identifier |
Description |
| Agent Alert: Play Sound Now |
agentAlert.playSound |
Immediately plays your configured success sound effect. |
| Agent Alert: Play Error Sound Now (Fahh) |
agentAlert.playErrorSound |
Immediately plays the viral "Fahh" error sound effect. |
| Agent Alert: Show Coding Streak & Badges |
agentAlert.showStreakDashboard |
Opens the interactive dashboard displaying your streaks and badges. |
Agent Alert utilizes native system audio players for zero latency and minimal resource usage:
- 🍏 macOS: Built-in
afplay engine with native macOS system presets.
- 🪟 Windows: Native background PowerShell audio engine supporting
.wav and .mp3.
- 🐧 Linux: Native
paplay / aplay audio support.
❓ Frequently Asked Questions
How does Agent Alert know when AI finishes generating?
Agent Alert listens to high-throughput document change events and heuristic buffer timeouts. When rapid continuous additions (characteristic of LLM token streams) settle, the notification triggers precisely as generation completes.
Can I use my own custom sound effects?
Yes! Open VS Code Settings, look for agentAlert.customSoundPath (or agentAlert.customErrorSoundPath), and paste the absolute path to any local .mp3 or .wav file on your computer.
Does streak tracking send any code or data to external servers?
No. All streak statistics, line counts, and achievements are stored 100% locally in your VS Code Global Storage. No data ever leaves your computer.
🔗 Links & Resources
| |
