Insta CID - AB BlackPlays an audio alert when your terminal or editor detects errors. Supports custom sounds, quiet hours, snooze, and volume control. Installation Launch VS Code Quick Open ( Ctrl+P), paste the following command, and press enter.Copied to clipboard |
CID — Error Sound Alerts
Get yelled/cursed at by ACP/CID/AB-Black every time your terminal throws an error.
What is CID?ACP/CID monitors your terminal output and editor diagnostics in real time. The moment it detects an error, it plays a random audio clip — so you stop staring at the screen waiting for things to fail. ✨ Features
📦 InstallationFrom the VS Code Marketplace
From a
|
| Command | Description |
|---|---|
CID: Show Quick Actions |
One-stop menu for all controls |
CID: Open Settings |
Open the full settings dashboard |
CID: Play Test Sound |
Verify your audio is working |
CID: Snooze Alerts |
Temporarily silence alerts |
CID: Clear Snooze |
Resume alerts immediately |
CID: Set Quiet Hours |
Configure a daily quiet window |
⚙️ Configuration
All settings live under cid.* in VS Code settings, or use CID: Open Settings for the UI.
| Setting | Default | Description |
|---|---|---|
cid.enabled |
true |
Master on/off switch |
cid.monitorTerminal |
true |
Monitor terminal shell output |
cid.monitorDiagnostics |
true |
Monitor editor diagnostics |
cid.diagnosticsSeverity |
"error" |
"error" or "warningAndError" |
cid.volumePercent |
70 |
Playback volume (0–100) |
cid.customSoundPath |
"" |
Path to a custom sound file |
cid.cooldownMs |
1500 |
Min ms between any two alerts |
cid.terminalCooldownMs |
1500 |
Cooldown for terminal alerts |
cid.diagnosticsCooldownMs |
1500 |
Cooldown for diagnostics alerts |
cid.quietHoursEnabled |
false |
Enable quiet hours |
cid.quietHoursStart |
"22:00" |
Quiet hours start (24h HH:mm) |
cid.quietHoursEnd |
"07:00" |
Quiet hours end (24h HH:mm) |
cid.patternMode |
"override" |
"override" replaces built-ins; "append" adds to them |
cid.patterns |
(built-in list) | Regex patterns that trigger terminal alerts |
cid.excludePatterns |
(built-in list) | Regex patterns that suppress false positives |
Using a custom sound
"cid.customSoundPath": "/Users/you/sounds/my-alert.mp3"
Supports .mp3, .wav, .ogg. Falls back to bundled sounds if the file isn't found.
Adding your own sounds to the rotation
Drop any .mp3, .wav, or .ogg file into the media/ folder inside the extension directory. CID will automatically include it in the random rotation — no config needed.
🛠️ Development Setup
# Clone the repo
git clone https://github.com/rohitramteke1/cid.git
cd cid
# Install dependencies
npm install
# Compile TypeScript
npm run compile
# Watch mode (auto-recompile on save)
npm run watch
# Run tests
npm test
Press F5 in VS Code to launch the Extension Development Host with CID loaded.
📦 Packaging & Publishing
# Install vsce
npm install -g @vscode/vsce
# Build a .vsix package
npm run package
# Login and publish
vsce login rohitramteke
vsce publish
🤝 Contributing
Contributions are welcome!
- Fork the repo
- Create a branch:
git checkout -b feature/your-feature - Make your changes
- Run
npm run lintandnpm test - Open a Pull Request against
main
Ideas: new bundled sounds, framework-specific error patterns, UI improvements to the settings webview.
📄 License
MIT © Rohit M. Ramteke