| name | output |
| description | Show or switch the Mac's audio output device (built-in speakers, AirPods, external displays, DACs). Use when the user asks where sound is playing, which output device is active, or wants audio routed to a different device. |
| argument-hint | ["device name or number"] |
| allowed-tools | Bash |
Requested device: $ARGUMENTS
Current output device and everything available (JSON):
!"${CLAUDE_PLUGIN_ROOT}/scripts/media.sh" output
Now do the following:
-
No argument → present the devices as a short markdown list, marking the
current one, e.g. 🔊 **MacBook Pro Speakers** (current), then offer to
switch.
-
With a device request → map what the user said to one entry in the
devices list above (they may use loose words: "에어팟"/"earbuds" → the
AirPods entry, "speakers" → the built-in speakers, "monitor"/"TV" → the
display device). Then run:
"${CLAUDE_PLUGIN_ROOT}/scripts/media.sh" output "<device name>"
The script itself accepts an exact name, a unique case-insensitive
substring, or the 1-based list position, and prints the updated list.
-
Confirm in one styled line: 🔊 Output → **AirPods Pro**.
Error handling:
- Exit 4 — no match or ambiguous; stderr names the candidates. Show them
and ask which one (AskUserQuestion is not available here — just ask in
text).
- Exit 1 with "native helper" — the feature needs the compiled helper;
point to
/media:doctor.
- A device that is not connected (e.g. AirPods in the case) does not appear
in the list — switching cannot connect it; the user must connect it first.
Tip: the statusline can show the current output device (icon by device kind —
🎧 Bluetooth/headphones, 📺 HDMI/DisplayPort, 📶 AirPlay, 🔊 speakers) —
check "Output device" in the /media:statusline Items tab, or place it
anywhere with a numeric pattern (digit 6).
