Skip to content
Automation
Skill

/output

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.

From plugin
media
416 skills1 hook

Claude Code

$ npx -y skills add Bangs00/claude-media-control --skill output --agent claude-code

SKILL.md

output.SKILL.md
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:

1. **No argument** → present the devices as a short markdown list, marking the current one, e.g. `🔊 **MacBook Pro Speakers** (current)`, then offer to switch.

2. **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.

3. 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).

Read more
@bangs00
Ships withmedia

The current track, live in your Claude Code statusline — ticking every second, ⌘+clickable, styleable down to the bar characters: And whatever your Mac is playing — Spotify, Apple Music, a browser tab, VLC — you can control it from the chat too: "what song is

Stars on GitHub

Momentum

stars in total
4
Star history of Bangs00/claude-media-control on GitHub, a chart by star-history.com

Other skills on media.

verify

verify

How to verify media.sh changes end-to-end on a real Mac — isolated data dir, real native build, and a controllable fake…

@bangs00@bangs00Install Skill
artwork

artwork

Show the album artwork (cover art) of the currently playing track. Use when the user asks to see the album art, cover image, or…

@bangs00@bangs00Install Skill
config

config

Quick media settings — turn the now-playing statusline, the /media:now progress bar, or the playback history on/off, or reset the…

@bangs00@bangs00Install Skill
doctor

doctor

Diagnose the media plugin — native build, read/control paths, fallbacks, permissions — and suggest fixes. Use when media commands…

@bangs00@bangs00Install Skill
history

history

Show recently played tracks (a passive local playback log). Use when the user asks what played earlier, what song was on before,…

@bangs00@bangs00Install Skill
menu

menu

Interactive media remote — control playback via a selectable menu (toggle, next, previous, seek, volume, artwork). Use when the…

@bangs00@bangs00Install Skill

More skills from other plugins.

agent-builder

agent-builder

Load immediately after an Agent intent, before the first agent_builder_* call. Governs how you create, configure, test, and…

n8n10d209k
@n8n-io@n8n-ioInstall Skill
browser-use

browser-use

Direct browser control via CDP for web interaction: automation, scraping, testing, screenshots, and site/app work. Also covers…

browser-usetoday120k
@browser-use@browser-useInstall Skill
agent-browser

agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling…

@vercel-labs-2@vercel-labs-2Install Skill
add-anydoc

add-anydoc

Add local office-document-to-Markdown conversion to NanoClaw agent containers with the pinned Firecrawl AnyDoc CLI. Use when…

@nanocoai@nanocoaiInstall Skill

Questions about output.

Which coding agents can use output?
output installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.