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

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.

Recipe tested November 18, 2026 with Multimeter 1.1. Source: Sent Value.

Preview: the Traffic Light face and two alternatives, with sample values like the ones this recipe returns.

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:
    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'" }] }
        ]
      }
    }
  2. In Multimeter, add a meter with the Sent Value source and the key claude.
  3. 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
SettingValue
SourceSent Value
Keyclaude
Range0 to 2, sent by the hooks
AlertsHigh values: warning 1, critical 2, notify on critical
LabelCLAUDE, sent by the hooks
FaceTraffic 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
SymptomCauseFix
The light never changesThe 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 keyThe meter’s key doesn’t match the hooks.In Customize, set the key to claude exactly.
It stays red after you approvedThe 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.

Related

Put it in your menu bar

$19.99 one-time. No subscription. Needs macOS 13 Ventura or later.