DEV Community

Great Work
Great Work

Posted on Originally published at multimeterapp.com

See when Claude Code is done or needs you, in your Mac menu bar

This guide first appeared on multimeterapp.com. Multimeter is a Mac menu bar app that turns any number into a live meter.

Start a long task, switch to something else, and stop checking the terminal. Claude Code runs hooks at fixed moments: when you send a prompt, after each tool, when it asks for permission and when it finishes. Four one-line hooks send a number to Multimeter at those moments, and the Traffic Light face shows it: yellow while Claude is working, green when it’s done, red when it’s waiting for you.

What you need

  • Multimeter for macOS 13 or later, $19.99 once.
  • Claude Code, any plan or sign-in.

Set it up

  1. Add these hooks to ~/.claude/settings.json (merge the hooks part with what’s already there). Claude Code picks them up for new sessions:
   {
     "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'" }] }
       ]
     }
   }
Enter fullscreen mode Exit fullscreen mode
  1. In Multimeter, add a meter with the Sent Value source and the key claude.
  2. 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):

Settings for this meter

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

What the meter says, why, and what to do

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

No. Sent Value meters work in every version, and nothing here uses the Script source.

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.

Multimeter posts a regular Mac notification when the meter goes critical; its sound follows your notification settings for Multimeter in System Settings.

Related

Top comments (0)