/claude-music-library

name: claude-music-library
description: >
  Browses, searches, and manages generated music in ~/Music/claude-music-output/.
  Lists recent generations, searches by date, checks disk usage, plays files,
  and cleans up old output.
when_to_use: >
  Use when the user asks to browse the music library, list songs, see recent
  generations, check disk usage, play a file, or clean up old output.
allowed-tools:
  - Bash
  - Read

claude-music-library — Output Management

List Recent Generations

# Last 10 files, sorted by date
ls -lht ~/Music/claude-music-output/ | head -20

# Only FLAC files
ls -lht ~/Music/claude-music-output/*.flac 2>/dev/null | head -10

# With file sizes
du -sh ~/Music/claude-music-output/*  2>/dev/null | sort -rh | head -20

Search by Date

# Today's generations
find ~/Music/claude-music-output/ -name "*.flac" -newermt "today" -ls

# This week
find ~/Music/claude-music-output/ -name "*.flac" -mtime -7 -ls

Disk Usage

du -sh ~/Music/claude-music-output/

Play a File

ffplay -nodisp -autoexit "/path/to/file.flac"

File Info

ffprobe -v quiet -print_format json -show_format "/path/to/file.flac" | jq '{duration: .format.duration, size: .format.size, format: .format.format_name}'

Cleanup

Always confirm before deleting:

# Show what would be deleted (files older than 30 days)
find ~/Music/claude-music-output/ -mtime +30 -ls

# Delete after user confirmation
find ~/Music/claude-music-output/ -mtime +30 -delete