What is agentping?

AgentPing is a small Windows tool that sends desktop notifications when Claude Code, an AI coding assistant, finishes responding, needs permission to run something, or is waiting for your input. It is built as a single PowerShell script that hooks into Claude Code's own event system, so there is nothing else to install or run in the background. The project is an independent community effort and is not made or endorsed by Anthropic. It requires Windows 10 or 11 along with either the built-in Windows PowerShell or PowerShell 7 or later, plus a version of Claude Code that supports plugins. Installation is done entirely through Claude Code's own plugin commands, adding the marketplace and installing the plugin, after which notifications begin appearing on the very next turn. Removing it is just as simple through an uninstall command. Under the hood, AgentPing registers two hooks with Claude Code. One fires when Claude needs permission to do something or is waiting for input, and the other fires when Claude finishes responding. Both trigger a script that reads event details, shows a native Windows toast notification, and falls back to a tray balloon notification if toasts are not available on that system. The script is written so that it always exits cleanly and never blocks Claude Code, even if it receives malformed input. There is no configuration needed to get started, though anyone can edit the notification wording or which events trigger it directly in the script and hook definition files. The project includes a test suite that runs the real notification script in a dry-run mode so tests never actually pop up a visible notification, and there is also a way to manually trigger a single real notification to confirm everything works as expected. The project is released under the MIT license.