/volume

name: volume
description: Show or set the Mac's system output volume (0-100). Use when the user asks how loud the volume is, wants it louder/quieter, sets a specific level, or asks to mute.
argument-hint: [0-100]
allowed-tools: Bash

Requested volume: $ARGUMENTS

1. Work out the target:

• no argument → just read the current volume
• a number 0-100 → set that level
• relative ("louder", "quieter", "볼륨 올려/내려", "a bit louder") → read the

current level first, then add/subtract 10 (clamp to [0, 100])

• "mute" → set 0; "unmute" without a remembered level → suggest 50

2. Run with Bash:

"${CLAUDE_PLUGIN_ROOT}/scripts/media.sh" volume            # read
"${CLAUDE_PLUGIN_ROOT}/scripts/media.sh" volume <0-100>    # set, then reads back

The command prints `{"volume":N,"muted":bool}`. Confirm in one short markdown line, e.g. `🔊 Volume **45%**` (append `*(muted)*` when `muted` is true). This is the system output volume — it does not change per-app sliders.

Tip: the statusline can show the volume as icon + level bar + percent (`🔉 ▄ 45%`) — check "Volume" in the `/media:statusline` Items tab, or place it anywhere with a numeric pattern (digit 3).