Meme CLI
Terminal meme audio alerts for VS Code.
When your build fails, a command is missing, tests pass, or the server starts — Meme CLI plays a sound (or speaks) so you notice without staring at the terminal.
Install: VS Marketplace — abh1jeet.meme-cli
Requirements
- VS Code 1.95+ (or Cursor)
- Terminal › Integrated: Shell Integration enabled (default in modern VS Code)
- macOS recommended for custom MP3 playback (
afplay) and speech (say)
Quick start
- Install Meme CLI from the Marketplace
- Open a terminal in VS Code
- Run:
echo "Build failed"
You should hear your failure sound (or speech if no MP3 is mapped).
Open the Voice Console icon in the Activity Bar to see alert history.
Test every scenario
Run these one at a time (wait ~1 second between each):
Failures
echo "zsh: command not found: foobar"
echo "Permission denied"
echo "Could not resolve host: github.com"
echo "Authentication failed"
echo "compilation failed"
echo "Tests failed"
echo "Build failed"
echo "Merge conflict in file.js"
echo "No such file or directory"
Warning / progress / waiting
echo "WARNING: something looks odd"
echo "Downloading package... 45% complete"
echo "Installing dependencies"
echo "Compiling sources"
echo "Waiting for input"
Success / ready / server / git
echo "Already up to date"
echo "Listening on http://localhost:3000"
echo "Port 8080 is already in use"
echo "Application is ready"
echo "All tests passed"
echo "BUILD SUCCESS"
Real shell commands
this_command_does_not_exist_xyz
cd /path/that/does/not/exist
Scenario → example cheat sheet
| Scenario |
Example |
command_not_found |
echo "zsh: command not found: foobar" |
permission_denied |
echo "Permission denied" |
network_error |
echo "Could not resolve host: github.com" |
auth_failure |
echo "Authentication failed" |
compile_error |
echo "compilation failed" |
test_failure |
echo "Tests failed" |
build_failure |
echo "Build failed" |
git_conflict |
echo "Merge conflict in file.js" |
file_not_found |
echo "No such file or directory" |
warning |
echo "WARNING: something looks odd" |
download_progress |
echo "Downloading package... 45% complete" |
install_progress |
echo "Installing dependencies" |
compile_progress |
echo "Compiling sources" |
waiting_input |
echo "Waiting for input" |
git_success |
echo "Already up to date" |
server_ready |
echo "Listening on http://localhost:3000" |
server_error |
echo "Port 8080 is already in use" |
app_ready |
echo "Application is ready" |
test_success |
echo "All tests passed" |
build_success |
echo "BUILD SUCCESS" |
Custom audio
Edit media/audio/scenario-audio.json inside the extension (or fork the repo):
{
"build_failure": "media/audio/khel-khatam-beta.mp3",
"build_success": "media/audio/So-Beautiful.mp3",
"command_not_found": "media/audio/Are-kehna-kya-chahte-ho.mp3"
}
- Put MP3/WAV files under
media/audio/
- Leave a value as
"" to use speech instead
- Add more scenario ids anytime — missing keys are fine
Commands
- Voice Console: Test Alert
- Voice Console: Test Failure Alert
- Voice Console: Demo Alert
- Voice Console: Toggle Monitoring
- Voice Console: Clear Alert History
Settings
| Setting |
Purpose |
voiceConsole.enabled |
Turn monitoring on/off |
voiceConsole.speechEnabled |
Speak when no MP3 is mapped |
voiceConsole.notificationsEnabled |
Show toast messages |
voiceConsole.voiceName |
macOS say voice (default Samantha) |
voiceConsole.successPhrase |
Custom success speech text |
voiceConsole.failurePhrase |
Custom failure speech text |
voiceConsole.readyPhrase |
Custom ready speech text |
voiceConsole.notificationDelayMs |
Throttle between alerts |
Develop / publish
npm test
npm run compile
vsce package --no-yarn
vsce publish --no-yarn
Repo: github.com/abh1jeet-007/Meme-CLI
License
MIT
