- Home
- Skills
- Productivity
- Claude Ping – Mac reminder when Claude is done
More screenshots
Works with the AI Agents you already use
Claude Ping – Mac reminder when Claude is done
A hard-to-miss screen border and card when Claude Code is done or needs you, plus a 5-hour usage meter in your menu bar. Claude installs, tests and fixes it for you.
$5
Claude Ping – Mac reminder when Claude is done
Example session with this skill installed
Set up Claude Ping on my Mac, and make the reminder sound "Ping" instead of "Glass".
- Read your context and instructions
- Compiled the claude ping
You're on macOS (Darwin), so Claude Ping can run here. Before installing, here's what will change:
- Hammerspoon will be installed with Homebrew (it's missing)
claude_ping.luagoes to~/.hammerspoon/, and a few lines are added toinit.lua- Two scripts go to
~/.claude/hooks/ - Hooks are added to
~/.claude/settings.json(backed up first, your other hooks stay) - The usage meter reads Claude Code's login from your Keychain, only to call Anthropic's usage endpoint
Note: Claude Ping is unofficial and not affiliated with Anthropic. OK to go ahead?
You: yes
Install report
| Step | Result |
|---|---|
| Platform check | ✅ macOS |
| Hammerspoon | ✅ Installed with Homebrew |
| Module | ✅ ~/.hammerspoon/claude_ping.lua, loaded from init.lua |
| Hook scripts | ✅ ~/.claude/hooks/claude-ping.sh, claude-usage.sh |
| Settings | ✅ Backup: settings.json.backup-20261113-143210, 6 hooks added |
| Server | ✅ curl 127.0.0.1:47823 → claude-ping is running |
| Usage meter | ✅ 23% · 3h 41m |
Sound changed
In ~/.hammerspoon/claude_ping.lua:
sound = "Ping", -- was "Glass"
Hammerspoon reloaded.
Two things only you can do
- When Hammerspoon asks for Accessibility access, turn it on in System Settings.
- Click ◌ in the menu bar → Show a test reminder. A green border and a "Ping" sound mean everything works.
If an open Claude Code session doesn't react, restart it once.
Connects securely to your tools. The creator never sees your data.
About this skill
You ask Claude something, switch windows, and forget to come back. Claude Ping fixes that.
What you get
A thick colored border around every screen: green when Claude is done, orange when it needs your input, red on error. Click-through, so it never blocks your work. A card listing every waiting session. Click a row to jump straight to that window. A menu bar count that re-reminds you every 5 minutes until you respond. A usage meter like 65% · 2h 10m: how much of your 5-hour limit is used and when it resets. What the skill does Just tell Claude "set up Claude Ping". It explains what will change, asks first, installs everything, and verifies it works. Later you can ask it to change the sound, border or shortcuts, troubleshoot, or uninstall cleanly.
Works with Claude Code in VS Code and the terminal, Claude Desktop, and claude.ai in Safari/Chrome (optional userscript).
Requirements: macOS + Claude Code. Uses Hammerspoon (free, installed for you). Not for Windows/Linux or other agents.
Unofficial, not affiliated with Anthropic.
Find more skills like this on the Claude Skills Marketplace, the Codex Skills Marketplace and the Gemini Skills Marketplace, or browse Claude Skills for Productivity.
macOS only. Requires Hammerspoon. Usage meter requires active Claude Code login in Keychain. Does not support Windows or Linux.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before buying a skill.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Money-back guarantee
Doesn't do what its page promises? You get your money back.
Trust & safety
Security scan
Security scan passed 4 days ago
Mac only
- Accounts
Anthropic
- Software
- Claude CodeHomebrew
- Optional
- Userscripts (Safari)orTampermonkey (Chrome), for claude.ai reminders
When asked, allow Hammerspoon Accessibility access in System Settings. It is needed to detect Claude Desktop and to jump to the right window.
Permissions
Allowed Hosts
File Scopes
Shell runs the installer and checks. Write Files copies the hook scripts and Hammerspoon module and adds hooks to settings.json (backed up first). Network: Homebrew installs Hammerspoon, and the usage meter calls api.anthropic.com with Claude Code's own login. The token is never stored or sent anywhere else.