ni-shiliu/neil-control

Limitar el control de música solo a Spotify por ahora

music-control

Controla KuGou Music o Spotify en macOS mediante CLI. Úsalo para mejorar la sesión de trabajo del usuario con música, de forma proactiva y receptiva.

Configuración

Requisitos: macOS, Python 3.10+, aplicación de escritorio KuGou Music o Spotify instalada.

No se necesita clave de API de Spotify ni configuración OAuth: la búsqueda usa la API anónima del reproductor web.

CLI

MUSIC="python3 ~/.claude/skills/music-control/scripts/music_cli.py"
$MUSIC [--provider kugou|spotify] <comando>

Comando	Descripción
status	Información de la pista actual (JSON)
play	Alternar reproducción/pausa
next	Saltar a la siguiente
prev	Pista anterior
play-by <título>...	Buscar y reproducir inmediatamente; varias canciones con |||
search <consulta> [--page N]	Buscar con paginación
recommend <estado_de_ánimo>	Elegir por estado de ánimo y reproducir
queue-show	Mostrar la cola actual
queue-add <título>...	Agregar canciones a la cola; varias canciones con |||
queue-play [índice]	Empezar a reproducir desde la cola
queue-next	Saltar a la siguiente en la cola
queue-clear	Vaciar la cola

--provider por defecto es spotify. Si Spotify no está en ejecución, se iniciará automáticamente. Establece MUSIC_PROVIDER=kugou para usar KuGou en su lugar.

Palabras clave de estado de ánimo

Estado de ánimo	Cuándo usarlo
focused	Trabajo profundo, codificando en flujo, leyendo
relaxed	Conversación casual, descansos, tareas ligeras
hyped	Función publicada, error corregido, logros
sad	Usuario desahogándose, atascado en un problema
debug	Frustrado, persiguiendo un error complicado

Reglas de activación proactiva

Actúa siempre sin que te lo pidan cuando detectes:

Señal en la conversación	Acción
El usuario inicia una nueva sesión de codificación	recommend focused → reproducir el primer resultado
El usuario dice que corrigió un error / publicó algo	recommend hyped → reproducir el primer resultado
El usuario está frustrado / atascado	recommend debug
El usuario menciona que necesita relajarse	recommend relaxed
El usuario menciona una canción o artista específico	play-by <canción> <artista>
Silencio prolongado / inactividad en la conversación	recommend relaxed
El usuario pide "poner algo" sin detalles	Inferir del estado de ánimo reciente de la conversación

Cola y varias canciones

Separador de varias canciones: |||

$MUSIC play-by 逆战 ||| 天下 ||| 这就是爱
$MUSIC queue-add 逆战 ||| 天下
$MUSIC queue-play
$MUSIC queue-next
$MUSIC search 周杰伦 --page 2

Formato de respuesta

{"ok": true, "title": "晴天", "artist": "周杰伦", "playing": true}
{"ok": true, "results": [{"title":"...", "artist":"...", "id":"..."}]}
{"ok": true, "action": "next"}
{"ok": true, "action": "queue_next", "current": 1, "has_next": true}
{"ok": false, "error": "no_player", "message": "..."}

Notas

• Spotify: usa la API anónima del reproductor web para buscar — no se necesita inicio de sesión ni clave de API
• KuGou: requiere la aplicación de escritorio KuGou Music para macOS instalada
• Si status devuelve no_player, la aplicación puede estar todavía cargándose — espera 3 segundos y reintenta
• La cola se guarda en ~/.config/music-cli/queue.json