What you need
- Multimeter for macOS 13 or later, $19.99 once.
- Claude Code, any plan or sign-in.
Set it up
- Add these hooks to
~/.claude/settings.json(merge thehookspart with what’s already there). Claude Code picks them up for new sessions:settings.json{ "hooks": { "UserPromptSubmit": [ { "hooks": [{ "type": "command", "command": "open -g 'multimeter://set?key=claude&value=1&min=0&max=2&label=CLAUDE&formatted=working'" }] } ], "PostToolUse": [ { "hooks": [{ "type": "command", "command": "open -g 'multimeter://set?key=claude&value=1&min=0&max=2&label=CLAUDE&formatted=working'", "async": true }] } ], "Notification": [ { "matcher": "permission_prompt", "hooks": [{ "type": "command", "command": "open -g 'multimeter://set?key=claude&value=2&min=0&max=2&label=CLAUDE&formatted=needs%20you'" }] } ], "Stop": [ { "hooks": [{ "type": "command", "command": "open -g 'multimeter://set?key=claude&value=0&min=0&max=2&label=CLAUDE&formatted=done'" }] } ] } } - In Multimeter, add a meter with the Sent Value source and the key
claude. - Pick the Traffic Light face. Set alerts to High values: warning at 1, critical at 2, and turn on Notify me when it goes critical to get a Mac notification when Claude asks for permission. The hooks send the range (0 to 2), the label and a word for the meter’s menu.
Multimeter settings
In Customize This Meter… (from the meter’s menu):
| Setting | Value |
|---|---|
| Source | Sent Value |
| Key | claude |
| Range | 0 to 2, sent by the hooks |
| Alerts | High values: warning 1, critical 2, notify on critical |
| Label | CLAUDE, sent by the hooks |
| Face | Traffic Light, Mood or Label & Value |
Tested: Run on November 18, 2026 with Claude Code in headless mode (claude -p) and these hooks writing their numbers to a file: sending a prompt gave 1, running a tool gave 1, finishing gave 0. A permission prompt can’t happen in headless mode, so the red step wasn’t part of that run.
More on this source, including every format it reads, in the Sent Value guide.
Limits
- Multimeter sends at most one notification per meter every 15 minutes, and only when the meter turns red.
- One meter follows every Claude Code session on your Mac: the last session to change state sets the light.
- The hooks open a multimeter:// link in the background (
open -g), which takes a few milliseconds and doesn’t bring Multimeter forward.
Variations
A notification when it finishes instead
Swap the numbers: send value=2 from the Stop hook and value=0 from Notification. The light then turns red when Claude is done, and the critical alert tells you.
One meter per project
Put the hooks in a project’s .claude/settings.json with its own key, like key=claude-api, and give each project its own meter.
Usage too
Pair it with the Claude Code usage recipe to keep your 5-hour limit next to the light.
Troubleshooting
| Symptom | Cause | Fix |
|---|---|---|
| The light never changes | The hooks aren’t loaded: they apply to sessions started after you saved settings.json, or the JSON has a typo. | Start a new session and run /hooks in Claude Code to see them. Check the file with jq . ~/.claude/settings.json. |
| The meter says to give it a key | The meter’s key doesn’t match the hooks. | In Customize, set the key to claude exactly. |
| It stays red after you approved | The next hook hasn’t run yet. | It turns yellow after the next tool finishes, and green when Claude stops. |
Questions
Does this need the direct download version of Multimeter?
No. Sent Value meters work in every version, and nothing here uses the Script source.
Does it slow Claude Code down?
No. Each hook opens one multimeter:// link in the background, and the hook after each tool runs asynchronously, so Claude doesn’t wait for it.
Can I get a sound instead?
Multimeter posts a regular Mac notification when the meter goes critical; its sound follows your notification settings for Multimeter in System Settings.