MeerkatIO is the personal notification tool that fits your workflow. This one extension immediately opens the door to any notification method you need to stop watching your code run and save time in your day. MeerkatIO integrates with all of the built in tools already at your fingertips including Jupyter, Terminal, Run+Debug, VS Code Tasks, and Copilot.
Available Integrations
- Terminal command monitoring for Mac, Windows, and Linux! MeerkatIO keeps track of all running terminal processes inside of VS Code and alerts you when a process completes according to your workspace settings.
- Jupyter Extension support out of the box. Just run your cell(s) like normal and MeerkatIO will keep an eye out and alert you when your code completes.
- VS Code Run and Debug monitoring. Alert yourself after long-running processes complete from VS Code's built in Run and Debug Tool.
- VS Code Task monitoring. Monitor long running tasks defined in
.vscode/launch.json without any extra configuration.
- VS Code AI Copilot integration for summarizing and analyzing task output
Available Notification Channels
The MeerkatIO VS Code Extension supports the following notification channels:
- Ping (sound)
- System Notification
- Slack
- Microsoft Teams
- Google Chat
- SMS
- Email
Use Cases
- Ping yourself when your terminal command completes
- Send your phone an SMS text message when your long running Jupyter Notebook cell completes
- Generate a system notification when your test suite completes while you have a different window open
- Slack yourself an update on your build pipeline while you are taking your dog for a walk so you know when to head back
- Quickly summarize long running task output using your personal AI setup
Quickstart
No setup is required to use the Ping or System commands with this extension, but in order to access Slack, Microsoft Teams, Google Chat, SMS, and Email notification channels a MeerkatIO account is required. Get started for free today!
MeerkatIO notifications will automatically (after a window reload) execute for all task, debug, terminal, and Jupyter cell executions. The communication channel can be quickly changed and notifications can easily be toggled on and off to fit your current workflow!
Additional Pro Features!
📜 Notification History
- Easily access your execution history to review detailed records of past executions.
- Quickly find out how long an execution took and conveniently copy the execution details for further use.
🔍 Summarize Task Output
- Save valuable dev time by getting instant, AI-powered summaries of your build logs, test results, and task outputs - no more scrolling through walls of text to find what matters.
- Accelerate your debugging workflow by quickly understanding what went wrong without having to parse through lengthy console logs manually - get straight to problem-solving
Extension Settings
After creating your account, set the following Extension Settings to unlock the full MeerkatIO Platform command set:
meerkat.token: Your MeerkatIO account token which can be found at https://meerkatio.com/accountmeerkat.meerkatNotification: the notification channel you would like to be alerted with. Available notification options:
- ping
- system
- slack
- teams
- google_chat
- email
- sms
meerkat.enabled: Toggle MeerkatIO notifications on and offmeerkat.triggerMinDurationSeconds: The minimum duration in seconds code must run to cause an alert to be triggered. This avoids noisy alerts on short tasks.
Tips For Success
- Be sure to configure notification duration in the MeerkatIO sidebar to match your workflow. Noisy alerts get ignored, so customize this setting to improve your personal workflow.
- Use the MeerkatIO sidebar to easily toggle notifications on and off as you need them and quickly change the notification method
System Notifications
- On macOS make sure you have notifications enabled for
terminal-notifier in order to have notifications show up in your system's notification center
- On Linux, make sure you have
notify-osd or libnotify-bin installed. (Installed by default on Ubuntu)
Remote Development
- MeerkatIO is a workspace extension, meaning all code runs wherever the workspace is hosted. As a result, Ping and System notifications will not function properly on remote development or Docker containers without extra configuration because they are host system notification methods. Below is a workaround solution to use the Ping notification from a Docker dev container:
- Install Pulseaudio on your local machine
- Run
pulseaudio --load="module-native-protocol-tcp" --exit-idle-time=-1 --daemon to start a pulseaudio daemon on your local machine
- Add Docker runtime arguments to devcontainer.json
"runArgs": [
"-e", "PULSE_SERVER=host.docker.internal"
]
- Add a postCreateCommand to devcontainer.json to install the Pulseaudio tool inside of the Docker container
"postCreateCommand": "apt-get install -y pulseaudio"
Telemetry
The MeerkatIO extension collects telemetry data to help build a better VS Code experience. This extension does not send any telemetry from notification trigger sources including commands, paths, output, files, or personally identifiable information. The extension respects the telemetry.enableTelemetry setting which you can learn more about in the Visual Studio Code FAQ.
Release Notes
1.11.1
Fix bug where Jupyter Notebook notifications were being triggered twice
1.11.0
New Pro Feature: Summarize task output using the VS Code AI integration. Allows users to quickly analyze the output of their long running tasks to save valuable dev time and accelerate debugging to improve productivity.
1.10.0
Added VS Code Walkthrough steps with guides on configuring notification channels, trigger duration, and notification history tools. Improved notification configuration in the MeerkatIO sidebar menu.
1.9.0
New Pro feature: MeerkatIO Notification History in the bottom panel allows users to search their history to see past notifications, and details about execution time.
1.8.0
Added Google Chat notifications integration. Improved sign in experience using VS Code authentication sessions with GitHub.
Thank you for your support!
