@renatopuente/r2d2-agent-sound
v1.2.3
Published
Reproduce un sonido aleatorio de R2D2 en Claude Code cuando solicita permiso o termina de responder
Maintainers
Readme
R2D2 Agent Sound — Hook para Claude Code
Reproduce un sonido aleatorio de R2D2 (R2D2_A.mp3 o R2D2_B.mp3) en Claude Code cuando:
- Claude solicita permiso para ejecutar una herramienta (
PermissionRequest) - Claude termina de responder y espera tu input (
Stop)
Cada vez que se dispara el hook, se selecciona aleatoriamente uno de los dos sonidos R2D2.
Requisitos
- Windows 10/11
- Claude Code
- PowerShell (incluido en Windows)
- Node.js (para instalación vía npm)
Instalación rápida (recomendada)
npx @renatopuente/r2d2-agent-soundEsto descarga e instala el paquete automáticamente sin necesidad de clonar el repositorio.
El instalador:
- Copia
R2D2_A.mp3yR2D2_B.mp3a~/sounds/ - Agrega los hooks automáticamente a
~/.claude/settings.json - Muestra la ruta de los MP3 y los eventos configurados
Reinicia Claude Code después de instalarlo.
Desinstalación
npx @renatopuente/r2d2-agent-sound r2d2-uninstallO si ya instalaste el paquete globalmente:
r2d2-uninstallEl desinstalador:
- Elimina los hooks de R2D2 de
~/.claude/settings.json(sin tocar otros hooks) - Borra
~/sounds/R2D2_A.mp3y~/sounds/R2D2_B.mp3 - Elimina
~/sounds/si quedó vacía
Reinicia Claude Code después de desinstalarlo.
Instalación manual
- Clona o descarga este repositorio.
- Copia
R2D2_A.mp3yR2D2_B.mp3a una carpeta de tu preferencia. - Abre el archivo de configuración global de Claude Code:
C:\Users\<TuUsuario>\.claude\settings.json - Agrega los hooks dentro de la clave
"hooks"usando el comando de PowerShell con selección aleatoria.
Personalización
- Volumen: Cambia
$mp.Volume = 1.0a cualquier valor entre 0.0 y 1.0. - Sonido: Reemplaza los archivos R2D2 con cualquier MP3 que quieras usar.
- Disparador: Elimina el bloque
PermissionRequestoStopsi solo quieres uno de los dos.
Cómo funciona
Claude Code soporta hooks — comandos de shell que se ejecutan en eventos específicos del ciclo de vida del agente. Este paquete usa System.Windows.Media.MediaPlayer de PowerShell para reproducir aleatoriamente uno de los sonidos R2D2 de forma asíncrona cuando Claude necesita tu atención.
Hecho por @renatopuente
