Overview Version History Q & A Rating & Review
AI Task Notifier
Get notified on your iPhone / Apple Watch when long-running terminal commands finish in VS Code.
Perfect for Claude Code CLI, builds, tests, deployments, or any command that takes a while.
Features
Detects terminal command completion via VS Code Shell Integration API
Sends push notifications to iPhone / Apple Watch via Pushover
Plays a local macOS system sound
Configurable minimum duration threshold (default: 30 seconds)
Only notifies when VS Code is not focused (you're away)
Requirements
VS Code 1.100.0 or later
Terminal Shell Integration enabled (default in recent VS Code versions)
Pushover account and app for iPhone / Apple Watch notifications
Setup
1. Install Pushover
Create a free account at pushover.net
Install the Pushover app on your iPhone (one-time purchase of $5)
Note your User Key from the Pushover dashboard
Create a new application and note the API Token
Open VS Code Settings and search for "AI Task Notifier":
Pushover User Key : Your Pushover user keyPushover API Token : Your Pushover application API tokenMinimum Duration : Only notify for commands running longer than this (seconds)Sound Enabled : Play a local macOS sound on completionOnly When Unfocused : Only notify when VS Code window is not focused
3. Test
Run the command "AI Task Notifier: Send Test Notification" from the Command Palette (Cmd+Shift+P) to verify your Pushover setup.
Commands
Command
Description
AI Task Notifier: EnableEnable notifications
AI Task Notifier: DisableDisable notifications
AI Task Notifier: Send Test NotificationSend a test push notification
Settings
Setting
Default
Description
aiTaskNotifier.pushoverUserKey""Pushover user key
aiTaskNotifier.pushoverApiToken""Pushover API token
aiTaskNotifier.minimumDurationSeconds30Minimum command duration to trigger notification
aiTaskNotifier.soundEnabledtruePlay local macOS sound
aiTaskNotifier.localSoundNameGlassmacOS system sound name
aiTaskNotifier.pushoverSoundpushoverPushover notification sound
aiTaskNotifier.pushoverPriority0Priority: -2 (lowest) to 1 (high)
aiTaskNotifier.enabledtrueMaster enable/disable
aiTaskNotifier.onlyWhenUnfocusedtrueOnly notify when VS Code is not focused
How It Works
The extension uses VS Code's Terminal Shell Integration API to detect when commands start and finish. When a command completes:
Checks if the execution duration exceeds the minimum threshold
Checks if VS Code is not focused (if configured)
Plays a local macOS system sound
Sends a push notification via Pushover with the command name, exit status, and duration
Troubleshooting
No notifications received
Ensure Shell Integration is enabled: check the "AI Task Notifier" output channel (View > Output) for "Shell integration activated" messages
Verify Pushover credentials with the "Send Test Notification" command
Check that minimumDurationSeconds is not set too high
If onlyWhenUnfocused is enabled, switch away from VS Code before the command finishes
Shell Integration not activating
Shell Integration requires VS Code 1.100.0+ and a compatible shell (bash, zsh, pwsh). Check VS Code's terminal settings to ensure it's not disabled.
License
MIT
