config

name	config
description	Quick media settings — turn the now-playing statusline, the /media:now progress bar, or the playback history on/off, or reset the statusline to its default look. `config <key> [on|off|value]` changes any key directly. Use when the user wants to enable, disable, or reset a media display feature. (Arranging and styling the statusline lives in /media:statusline.)

Requested change (may be empty): $ARGUMENTS

Current settings:

!"${CLAUDE_PLUGIN_ROOT}/scripts/media.sh" config

---

Pick the mode from $ARGUMENTS:

Mode A — a key was given ($ARGUMENTS is NOT empty)

The user named a specific key (e.g. display.statusline on, statusline.marquee off). Apply it directly and report the result:

"${CLAUDE_PLUGIN_ROOT}/scripts/media.sh" config $ARGUMENTS

Valid keys:

• display.progressbar — progress bar in the /media:now reply
• display.statusline — the statusline now-playing segment
• statusline.multiline — layout: on = each group on its own line, off = one line (unused when statusline.fields has / breaks)
• statusline.color — ANSI colors/bold/italic in the statusline (default on; the NO_COLOR env var also disables it)
• statusline.marquee — scroll statusline titles wider than 30 cells, one char/second (default on)
• statusline.links — which parts of the statusline segment are cmd+clickable, each switchable on its own (default on = all four): toggle (the ▶︎/⏸ icon toggles playback), track (title/artist jump to the playing media — the playing browser tab or Music's current track when the app is scriptable, plain app activation otherwise), app (the same jump from the app name), and seek (each progress-bar cell seeks). Takes on (all), off (none), or a comma/space list of parts — config statusline.links toggle,seek leaves the text plain and keeps the icon and bar clickable. Any part left on builds + registers the local claude-media-control:// handler app, and is refused (exit 3) when that build fails; parts switched off render exactly as they would with links off. Works in hyperlink-capable terminals (iTerm2, Ghostty, WezTerm, Kitty, VS Code)
• history.record — log played tracks to the local history (default on; view with /media:history)
• statusline.fields — which items the statusline shows, as an ordered comma/space list of track app volume progressbar time output with optional / line breaks (interactive: /media:statusline)
• style.<part> — per-item statusline styles (15 string-valued keys; config style lists them, the value reset restores one, config style reset restores all). Guided styling lives in /media:statusline.
• statusline reset — restore the whole statusline appearance to defaults: arrangement, explicit lines, colors, marquee, and every style.* key. Does not touch display.statusline or the non-statusline toggles.

Rules you must follow:

• Enabling runs a preflight. Exit code 3 means the feature cannot work right now and the enable was refused (fail-closed by design). Explain the reason from stderr, point to /media:doctor, and do NOT retry or work around the refusal.
• Enabling display.statusline also wires the segment into ~/.claude/settings.json automatically (wrapper + backup of the previous statusLine; details in docs/statusline.md). Relay the wiring line the command prints — it says whether it wired, refreshed, or found a manual setup it left alone. The segment shows up on the next statusline tick, no restart needed.
• A wish to unwire the statusline (remove it from settings.json, "배선 해제", "settings에서 빼줘") maps to "${CLAUDE_PLUGIN_ROOT}/scripts/media.sh" statusline uninstall — it restores the backed-up statusLine, removes the wrapper + backup, and turns display.statusline off. (Plain display.statusline off only hides the segment and keeps the wiring for a fast re-enable. Uninstalling the plugin reverts the wiring by itself.)
• Disabling always succeeds.
• Afterwards show the resulting state (re-run config with no key if helpful).

Mode B — no key given ($ARGUMENTS is empty) → quick settings

Ask ONE AskUserQuestion call with exactly ONE question (single-select, header "Settings"): "Which setting do you want to change?" — exactly these four options, with the CURRENT value from the settings table above baked into each label so the user sees the state before picking:

1. Statusline: <on|off> — description: the now-playing segment rendered into Claude Code's statusline (enabling wires it into settings.json automatically and it appears on the next tick); selecting flips it.
2. /media:now progress bar: <on|off> — description: the progress bar drawn under the /media:now reply; selecting flips it.
3. Playback history: <on|off> — description: passively log played tracks (view with /media:history); selecting flips it.
4. Reset statusline settings — description: restore the statusline's default look — arrangement, lines, colors, marquee, and all per-item styles. The three toggles above are not touched.

Then apply the selection with one Bash call:

"${CLAUDE_PLUGIN_ROOT}/scripts/media.sh" config display.statusline on   # option 1 (flip)
"${CLAUDE_PLUGIN_ROOT}/scripts/media.sh" config display.progressbar on  # option 2 (flip)
"${CLAUDE_PLUGIN_ROOT}/scripts/media.sh" config history.record on       # option 3 (flip)
"${CLAUDE_PLUGIN_ROOT}/scripts/media.sh" config statusline reset        # option 4

If enabling display.statusline is refused (exit 3), no now-playing read path works right now; relay the stderr reason and point to /media:doctor — fail-closed by design, never bypass it. An "Other" answer names a key or a wish — map it onto Mode A (arrangement or styling wishes belong to /media:statusline; run that flow instead of guessing keys here).

Show the result

"${CLAUDE_PLUGIN_ROOT}/scripts/media.sh" config

Report the changed key (old → new) in one line. After a reset, mention the statusline is back to its stock look. Close with one pointer: arranging items and lines, and styling any part (colors, bold/italic, bar characters, icons) live in /media:statusline.