history

name	history
description	Show recently played tracks (a passive local playback log). Use when the user asks what played earlier, what song was on before, recently played music, or to clear the playback history.
argument-hint	["count | clear"]
allowed-tools	Bash

Requested: $ARGUMENTS

Recent playback history (newest first, MM-DD HH:MM title — artist (app)):

!"${CLAUDE_PLUGIN_ROOT}/scripts/media.sh" history 20

Now do the following:

1. If the request is a number (e.g. "last 50"), re-run with that count:

   "${CLAUDE_PLUGIN_ROOT}/scripts/media.sh" history <count>
   

2. If the request is to clear/delete the history, confirm intent first, then:

   "${CLAUDE_PLUGIN_ROOT}/scripts/media.sh" history clear
   

3. Otherwise present the lines above as a markdown list, newest first — **title** — *artist* (app · MM-DD HH:MM) — trimmed to what the user asked for. If the user asked about a specific track ("when did X play?"), answer just that from the list.

Notes you may need:

• Tracks are logged passively while media reads happen anyway (statusline ticks, /media:now, playback commands) — there is no background polling, so gaps are normal when Claude Code wasn't running or the statusline is off.
• The log keeps the most recent 500 tracks in history.jsonl under the plugin data directory; nothing ever leaves the machine.
• Logging is controlled by /media:config history.record on|off. If the user asks to stop/start recording, use that key.