@mcptoolshop/claude-sfx 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mcp-tool-shop
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.es.md

@@ -0,0 +1,188 @@
+<p align="center">
+  <a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <a href="README.md">English</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.it.md">Italiano</a> | <a href="README.pt-BR.md">Português (BR)</a>
+</p>
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/claude-sfx/readme.png" width="400" alt="Claude-SFX">
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/claude-sfx"><img src="https://img.shields.io/npm/v/claude-sfx" alt="npm version"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT License"></a>
+  <a href="https://mcp-tool-shop-org.github.io/claude-sfx/"><img src="https://img.shields.io/badge/Landing_Page-live-blue" alt="Landing Page"></a>
+</p>
+
+Retroalimentación de audio procedimental para [Claude Code](https://docs.anthropic.com/en/docs/claude-code). Cada llamada a una herramienta, edición de archivo, búsqueda, envío a Git y despliegue de agente genera un sonido distinto, sintetizado a partir de matemáticas, no de archivos de audio.
+
+## Inicio rápido
+
+```bash
+npm install -g claude-sfx
+cd your-project
+claude-sfx init       # install hooks into .claude/settings.json
+claude-sfx demo       # hear all 7 verbs
+```
+
+Eso es todo. Claude Code ahora reproducirá sonidos mientras trabaja.
+
+## ¿Por qué retroalimentación de audio?
+
+Cuando un agente de IA lee, escribe, busca y despliega en su nombre, pierde visibilidad. Está mirando texto que se desplaza. La retroalimentación de audio restaura la conciencia:
+
+- **Accesibilidad** — escuche los cambios de estado, los errores y las finalizaciones sin tener que mirar la terminal.
+- **Flujo** — sepa si una prueba ha pasado o si un envío se ha completado sin tener que cambiar de contexto.
+- **Presencia** — el agente se siente como un colaborador, no como una caja negra.
+
+## Los 7 verbos
+
+Cada acción de Claude Code se corresponde con uno de 7 verbos principales. Los modificadores (estado, alcance, dirección) alteran el sonido sin romper la coherencia.
+
+| Verbo | Desencadenantes | Sonido |
+| --- | --- | --- |
+| **intake** | `Read`, `WebFetch`, `WebSearch` | Seno ascendente suave — algo que está entrando |
+| **transform** | `Edit` | Pulso con textura FM — remodelando |
+| **commit** | `Write`, `NotebookEdit`, `git commit` | Tono de timbre agudo — sellado |
+| **navigate** | `Grep`, `Glob` | Pitido de sonar — escaneando |
+| **execute** | `Bash`, `npm test`, `tsc` | Estallido de ruido + tono — acción mecánica |
+| **move** | `mv`, `cp`, inicio de subagente | Silbido de viento — desplazamiento de aire |
+| **sync** | `git push`, `git pull` | Silbido dramático + ancla tonal |
+
+### Modificadores
+
+```bash
+claude-sfx play navigate --status ok      # bright ping (octave harmonic)
+claude-sfx play navigate --status err     # low detuned ping (dissonance)
+claude-sfx play navigate --status warn    # tremolo ping
+claude-sfx play sync --direction up       # rising whoosh (push)
+claude-sfx play sync --direction down     # falling whoosh (pull)
+claude-sfx play intake --scope remote     # longer tail (distance feel)
+```
+
+### Detección inteligente de Bash
+
+El controlador de la conexión inspecciona los comandos de Bash para seleccionar el sonido correcto:
+
+| Comando de Bash | Verbo | Estado |
+| --- | --- | --- |
+| `git push` | sync (arriba) | desde código de salida |
+| `git pull` | sync (abajo) | desde código de salida |
+| `npm test`, `pytest` | ejecutar | desde código de salida |
+| `tsc`, `npm run build` | ejecutar | desde código de salida |
+| `mv`, `cp` | mover | — |
+| `rm` | mover | advertencia |
+| todo lo demás | ejecutar | desde código de salida |
+
+## Perfiles
+
+Paletas de sonido que cambian todo el carácter con una sola opción.
+
+| Perfil | Carácter |
+| --- | --- |
+| **minimal** (default) | Tonos de onda sinusoidal — sutiles, profesionales, para uso diario |
+| **retro** | Chirrídos de onda cuadrada de 8 bits — divertidos pero controlados |
+
+```bash
+claude-sfx demo --profile retro           # hear retro palette
+claude-sfx preview minimal                # audition all sounds + modifiers
+claude-sfx config set profile retro       # change default globally
+claude-sfx config repo retro              # use retro in current directory only
+```
+
+### Perfiles personalizados
+
+Copie `profiles/minimal.json`, edite los parámetros de síntesis y cárguelo:
+
+```bash
+claude-sfx play navigate --profile ./my-profile.json
+```
+
+Cada número en el archivo JSON se corresponde directamente con el motor de síntesis: forma de onda, frecuencia, duración, envolvente (ADSR), profundidad FM, ancho de banda, ganancia.
+
+## Anti-molestias
+
+Lo que diferencia un producto de un juguete.
+
+| Función | Comportamiento |
+| --- | --- |
+| **Debounce** | El mismo verbo dentro de 200 ms → un sonido |
+| **Rate limit** | Máximo de 8 sonidos por ventana de 10 segundos |
+| **Quiet hours** | Todos los sonidos se suprimen durante las horas configuradas |
+| **Mute** | Activación instantánea, persiste al reiniciar la sesión |
+| **Volume** | Control de ganancia de 0 a 100 |
+| **Per-verb disable** | Desactive verbos específicos que no desee |
+
+```bash
+claude-sfx mute                            # instant silence
+claude-sfx unmute
+claude-sfx volume 40                       # quieter
+claude-sfx config set quiet-start 22:00    # quiet after 10pm
+claude-sfx config set quiet-end 07:00      # until 7am
+claude-sfx disable navigate                # no more search pings
+claude-sfx enable navigate                 # bring it back
+```
+
+## Ambiente (operaciones de larga duración)
+
+Para comandos que tardan un tiempo (compilaciones, despliegues, suites de pruebas grandes):
+
+```bash
+claude-sfx ambient-start     # low drone fades in
+# ... operation runs ...
+claude-sfx ambient-resolve   # drone stops, resolution stinger plays
+claude-sfx ambient-stop      # stop drone silently (no stinger)
+```
+
+## Sonidos de sesión
+
+```bash
+claude-sfx session-start     # two-note ascending chime (boot)
+claude-sfx session-end       # two-note descending chime (closure)
+```
+
+## Todos los comandos
+
+```
+Setup:
+  init                            Install hooks into .claude/settings.json
+  uninstall                       Remove hooks
+
+Playback:
+  play <verb> [options]           Play a sound (goes through guard)
+  demo [--profile <name>]         Play all 7 verbs
+  preview [profile]               Audition all sounds in a profile
+  session-start / session-end     Chimes
+  ambient-start / ambient-resolve / ambient-stop
+
+Config:
+  mute / unmute                   Toggle all sounds
+  volume [0-100]                  Get or set volume
+  config                          Print current config
+  config set <key> <value>        Set a value
+  config reset                    Reset to defaults
+  config repo <profile|clear>     Per-directory profile override
+  disable / enable <verb>         Toggle specific verbs
+  export [dir] [--profile]        Export all sounds as .wav files
+```
+
+## Cómo funciona
+
+Sin archivos de audio. Cada sonido se sintetiza en tiempo de ejecución a partir de matemáticas:
+
+- **Osciladores** — seno, cuadrada, diente de sierra, triángulo, ruido blanco.
+- **Envolventes ADSR** — ataque, decaimiento, sostenimiento, liberación.
+- **Síntesis FM** — modulación de frecuencia para crear texturas.
+- **Filtro de variable de estado** — ruido filtrado en banda para efectos de "whoosh".
+- **Barridos de frecuencia** — interpolación lineal para crear movimiento.
+- **Limitador de volumen** — compresión de rodilla suave, límite máximo.
+
+Todo el paquete tiene aproximadamente 2800 líneas de código TypeScript y no tiene dependencias para producción. Los sonidos se generan como buffers PCM, se codifican a formato WAV en memoria y se reproducen a través del reproductor de audio nativo del sistema operativo (PowerShell en Windows, afplay en macOS, aplay en Linux).
+
+## Requisitos:
+
+- Node.js 18 o superior.
+- Claude Code.
+- Salida de audio del sistema (altavoces o auriculares).
+
+## Licencia:
+
+[MIT](LICENSE)

package/README.fr.md

@@ -0,0 +1,188 @@
+<p align="center">
+  <a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <a href="README.es.md">Español</a> | <a href="README.md">English</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.it.md">Italiano</a> | <a href="README.pt-BR.md">Português (BR)</a>
+</p>
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/claude-sfx/readme.png" width="400" alt="Claude-SFX">
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/claude-sfx"><img src="https://img.shields.io/npm/v/claude-sfx" alt="npm version"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT License"></a>
+  <a href="https://mcp-tool-shop-org.github.io/claude-sfx/"><img src="https://img.shields.io/badge/Landing_Page-live-blue" alt="Landing Page"></a>
+</p>
+
+Retour audio pour [Claude Code](https://docs.anthropic.com/en/docs/claude-code). Chaque appel de fonction, modification de fichier, recherche, envoi vers Git et exécution d'agent produit un son distinct, synthétisé à partir de formules mathématiques, et non à partir de fichiers audio.
+
+## Démarrage rapide
+
+```bash
+npm install -g claude-sfx
+cd your-project
+claude-sfx init       # install hooks into .claude/settings.json
+claude-sfx demo       # hear all 7 verbs
+```
+
+Voilà. Claude Code émettra désormais des sons pendant son fonctionnement.
+
+## Pourquoi un retour audio ?
+
+Lorsqu'un agent d'IA lit, écrit, effectue des recherches et déploie des éléments en votre nom, vous perdez de la visibilité. Vous ne voyez qu'un texte qui défile. Le retour audio rétablit la conscience :
+
+- **Accessibilité** : écoutez les changements d'état, les erreurs et les confirmations sans avoir à surveiller le terminal.
+- **Fluidité** : sachez si un test a réussi ou si une modification a été intégrée sans avoir à changer de contexte.
+- **Présence** : l'agent vous semble être un collaborateur, et non une boîte noire.
+
+## Les 7 actions
+
+Chaque action de Claude Code correspond à l'une des 7 actions de base. Les modificateurs (état, portée, direction) modifient le son sans rompre la cohérence.
+
+| Action | Déclencheurs | Son |
+| --- | --- | --- |
+| **intake** | `Read`, `WebFetch`, `WebSearch` | Onde sinusoïdale ascendante : quelque chose arrive. |
+| **transform** | `Edit` | Impulsion texturée par modulation de fréquence (FM) : remodelage. |
+| **commit** | `Write`, `NotebookEdit`, `git commit` | Tonnette percutant : confirmation. |
+| **navigate** | `Grep`, `Glob` | Impulsion sonar : analyse. |
+| **execute** | `Bash`, `npm test`, `tsc` | Bruit + ton : action mécanique. |
+| **move** | `mv`, `cp`, lancement de sous-agent. | Sifflement de vent : déplacement d'air. |
+| **sync** | `git push`, `git pull` | Sifflement dramatique + ancre tonale. |
+
+### Modificateurs
+
+```bash
+claude-sfx play navigate --status ok      # bright ping (octave harmonic)
+claude-sfx play navigate --status err     # low detuned ping (dissonance)
+claude-sfx play navigate --status warn    # tremolo ping
+claude-sfx play sync --direction up       # rising whoosh (push)
+claude-sfx play sync --direction down     # falling whoosh (pull)
+claude-sfx play intake --scope remote     # longer tail (distance feel)
+```
+
+### Détection intelligente de Bash
+
+Le gestionnaire de hooks analyse les commandes Bash pour choisir le son approprié :
+
+| Commande Bash | Action | État |
+| --- | --- | --- |
+| `git push` | sync (montée) | code de retour |
+| `git pull` | sync (descente) | code de retour |
+| `npm test`, `pytest` | exécution | code de retour |
+| `tsc`, `npm run build` | exécution | code de retour |
+| `mv`, `cp` | déplacement | — |
+| `rm` | déplacement | avertissement |
+| tout le reste | exécution | code de retour |
+
+## Profils
+
+Palettes de sons qui modifient l'ensemble du comportement avec un seul paramètre.
+
+| Profil | Comportement |
+| --- | --- |
+| **minimal** (default) | Tons en onde sinusoïdale : subtils, professionnels, pour une utilisation quotidienne. |
+| **retro** | Bruits de couinement en onde carrée 8 bits : amusants mais contrôlés. |
+
+```bash
+claude-sfx demo --profile retro           # hear retro palette
+claude-sfx preview minimal                # audition all sounds + modifiers
+claude-sfx config set profile retro       # change default globally
+claude-sfx config repo retro              # use retro in current directory only
+```
+
+### Profils personnalisés
+
+Copiez `profiles/minimal.json`, modifiez les paramètres de synthèse, puis chargez-le :
+
+```bash
+claude-sfx play navigate --profile ./my-profile.json
+```
+
+Chaque nombre dans le fichier JSON correspond directement au moteur de synthèse : forme d'onde, fréquence, durée, enveloppe (ADSR), profondeur de modulation de fréquence (FM), bande passante, gain.
+
+## Prévention des nuisances
+
+Ce qui distingue un produit d'un simple jouet.
+
+| Fonctionnalité | Comportement |
+| --- | --- |
+| **Debounce** | Même action dans un délai de 200 ms → un seul son. |
+| **Rate limit** | Maximum de 8 sons par fenêtre de 10 secondes. |
+| **Quiet hours** | Tous les sons sont désactivés pendant les heures configurées. |
+| **Mute** | Activation/désactivation instantanée, persiste après le redémarrage de la session. |
+| **Volume** | Contrôle du gain de 0 à 100. |
+| **Per-verb disable** | Désactivez les actions spécifiques que vous ne souhaitez pas entendre. |
+
+```bash
+claude-sfx mute                            # instant silence
+claude-sfx unmute
+claude-sfx volume 40                       # quieter
+claude-sfx config set quiet-start 22:00    # quiet after 10pm
+claude-sfx config set quiet-end 07:00      # until 7am
+claude-sfx disable navigate                # no more search pings
+claude-sfx enable navigate                 # bring it back
+```
+
+## Ambiance (opérations de longue durée)
+
+Pour les commandes qui prennent du temps (compilations, déploiements, suites de tests volumineuses) :
+
+```bash
+claude-sfx ambient-start     # low drone fades in
+# ... operation runs ...
+claude-sfx ambient-resolve   # drone stops, resolution stinger plays
+claude-sfx ambient-stop      # stop drone silently (no stinger)
+```
+
+## Sons de session
+
+```bash
+claude-sfx session-start     # two-note ascending chime (boot)
+claude-sfx session-end       # two-note descending chime (closure)
+```
+
+## Toutes les commandes
+
+```
+Setup:
+  init                            Install hooks into .claude/settings.json
+  uninstall                       Remove hooks
+
+Playback:
+  play <verb> [options]           Play a sound (goes through guard)
+  demo [--profile <name>]         Play all 7 verbs
+  preview [profile]               Audition all sounds in a profile
+  session-start / session-end     Chimes
+  ambient-start / ambient-resolve / ambient-stop
+
+Config:
+  mute / unmute                   Toggle all sounds
+  volume [0-100]                  Get or set volume
+  config                          Print current config
+  config set <key> <value>        Set a value
+  config reset                    Reset to defaults
+  config repo <profile|clear>     Per-directory profile override
+  disable / enable <verb>         Toggle specific verbs
+  export [dir] [--profile]        Export all sounds as .wav files
+```
+
+## Fonctionnement
+
+Aucun fichier audio. Chaque son est synthétisé en temps réel à partir de formules mathématiques :
+
+- **Oscillateurs** — sinusoïdale, carrée, en dents de scie, triangulaire, bruit blanc
+- **Enveloppes ADSR** — attaque, décroissance, sustain, relâchement
+- **Synthèse FM** — modulation de fréquence pour créer des textures
+- **Filtre à état variable** — bruit filtré en bande passante pour créer des effets de "whoosh"
+- **Balayages de fréquence** — interpolation linéaire pour créer du mouvement
+- **Limiteur de volume** — compression "soft-knee", seuil maximum
+
+L'ensemble du package est composé d'environ 2 800 lignes de code TypeScript et ne possède aucune dépendance pour la production. Les sons sont générés sous forme de tampons PCM, encodés en format WAV en mémoire, et lus via le lecteur audio natif du système d'exploitation (PowerShell sur Windows, afplay sur macOS, aplay sur Linux).
+
+## Prérequis
+
+- Node.js 18+
+- Claude Code
+- Sortie audio du système (haut-parleurs ou casque)
+
+## Licence
+
+[MIT](LICENSE)

package/README.hi.md

@@ -0,0 +1,188 @@
+<p align="center">
+  <a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.md">English</a> | <a href="README.it.md">Italiano</a> | <a href="README.pt-BR.md">Português (BR)</a>
+</p>
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/claude-sfx/readme.png" width="400" alt="Claude-SFX">
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/claude-sfx"><img src="https://img.shields.io/npm/v/claude-sfx" alt="npm version"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT License"></a>
+  <a href="https://mcp-tool-shop-org.github.io/claude-sfx/"><img src="https://img.shields.io/badge/Landing_Page-live-blue" alt="Landing Page"></a>
+</p>
+
+प्रक्रियात्मक ऑडियो प्रतिक्रिया [क्लाउड कोड] (https://docs.anthropic.com/en/docs/claude-code) के लिए। प्रत्येक टूल कॉल, फ़ाइल संपादन, खोज, गिट पुश और एजेंट डिस्पैच के लिए एक अलग ध्वनि होती है - जो ऑडियो फ़ाइलों के बजाय गणित से उत्पन्न होती है।
+
+## शुरुआत
+
+```bash
+npm install -g claude-sfx
+cd your-project
+claude-sfx init       # install hooks into .claude/settings.json
+claude-sfx demo       # hear all 7 verbs
+```
+
+बस इतना ही। क्लाउड कोड अब काम करते समय ध्वनियाँ बजाएगा।
+
+## ऑडियो प्रतिक्रिया क्यों?
+
+जब कोई एआई एजेंट आपकी ओर से पढ़ता है, लिखता है, खोजता है और तैनात करता है, तो आप दृश्यता खो देते हैं। आप केवल टेक्स्ट को स्क्रॉल होते हुए देखते हैं। ऑडियो प्रतिक्रिया जागरूकता बहाल करती है:
+
+- **पहुंच** - टर्मिनल को देखने के बिना स्थिति परिवर्तन, त्रुटियों और पूर्णता को सुनें
+- **प्रवाह** - बिना संदर्भ बदले यह जानें कि कोई परीक्षण पास हुआ है या कोई पुश सफल हुआ है
+- **उपस्थिति** - एजेंट एक सहयोगी की तरह महसूस होता है, न कि एक ब्लैक बॉक्स की तरह
+
+## 7 क्रियाएँ
+
+प्रत्येक क्लाउड कोड क्रिया 7 मुख्य क्रियाओं में से एक से मेल खाती है। संशोधक (स्थिति, दायरा, दिशा) ध्वनि को बदलते हैं लेकिन सामंजस्य को नहीं तोड़ते।
+
+| क्रिया | ट्रिगर | ध्वनि |
+| --- | --- | --- |
+| **intake** | `Read`, `WebFetch`, `WebSearch` | हल्की बढ़ती हुई साइन तरंग - कुछ आ रहा है |
+| **transform** | `Edit` | एफएम-टेक्सचर्ड पल्स - पुन: आकार देना |
+| **commit** | `Write`, `NotebookEdit`, `git commit` | तेज स्टैम्प टोन - सील |
+| **navigate** | `Grep`, `Glob` | सोनार पिंग - स्कैनिंग |
+| **execute** | `Bash`, `npm test`, `tsc` | शोर विस्फोट + टोन - यांत्रिक क्रिया |
+| **move** | `mv`, `cp`, सबएजेंट स्पॉन | हवा की सरसराहट - वायु विस्थापन |
+| **sync** | `git push`, `git pull` | नाटकीय सरसराहट + टोनल एंकर |
+
+### संशोधक
+
+```bash
+claude-sfx play navigate --status ok      # bright ping (octave harmonic)
+claude-sfx play navigate --status err     # low detuned ping (dissonance)
+claude-sfx play navigate --status warn    # tremolo ping
+claude-sfx play sync --direction up       # rising whoosh (push)
+claude-sfx play sync --direction down     # falling whoosh (pull)
+claude-sfx play intake --scope remote     # longer tail (distance feel)
+```
+
+### स्मार्ट बैश डिटेक्शन
+
+हुक हैंडलर सही ध्वनि चुनने के लिए बैश कमांड का निरीक्षण करता है:
+
+| बैश कमांड | क्रिया | स्थिति |
+| --- | --- | --- |
+| `git push` | sync (ऊपर) | एग्जिट कोड से |
+| `git pull` | sync (नीचे) | एग्जिट कोड से |
+| `npm test`, `pytest` | निष्पादित करें | एग्जिट कोड से |
+| `tsc`, `npm run build` | निष्पादित करें | एग्जिट कोड से |
+| `mv`, `cp` | स्थानांतरित करें | — |
+| `rm` | स्थानांतरित करें | चेतावनी |
+| सब कुछ और | निष्पादित करें | एग्जिट कोड से |
+
+## प्रोफ़ाइल
+
+ध्वनि पैलेट जो एक झंडे के साथ पूरे चरित्र को बदलते हैं।
+
+| प्रोफ़ाइल | चरित्र |
+| --- | --- |
+| **minimal** (default) | साइन-वेव टोन - सूक्ष्म, पेशेवर, दैनिक उपयोग के लिए |
+| **retro** | स्क्वायर-वेव 8-बिट चीप्स - मजेदार लेकिन नियंत्रित |
+
+```bash
+claude-sfx demo --profile retro           # hear retro palette
+claude-sfx preview minimal                # audition all sounds + modifiers
+claude-sfx config set profile retro       # change default globally
+claude-sfx config repo retro              # use retro in current directory only
+```
+
+### कस्टम प्रोफाइल
+
+`profiles/minimal.json` की प्रतिलिपि बनाएँ, संश्लेषण मापदंडों को संपादित करें, और इसे लोड करें:
+
+```bash
+claude-sfx play navigate --profile ./my-profile.json
+```
+
+JSON में प्रत्येक संख्या सीधे सिंथ इंजन से मेल खाती है - तरंग, आवृत्ति, अवधि, लिफाफा (ADSR), FM गहराई, बैंडविड्थ, गेन।
+
+## अनायासता-रोधी
+
+यह एक उत्पाद को एक खिलौने से अलग करता है।
+
+| विशेषता | व्यवहार |
+| --- | --- |
+| **Debounce** | समान क्रिया 200ms के भीतर → एक ध्वनि |
+| **Rate limit** | प्रति 10-सेकंड विंडो में अधिकतम 8 ध्वनियाँ |
+| **Quiet hours** | निर्धारित घंटों के दौरान सभी ध्वनियाँ बंद |
+| **Mute** | तत्काल टॉगल, सत्र पुनरारंभ पर भी बना रहता है |
+| **Volume** | 0–100 गेन नियंत्रण |
+| **Per-verb disable** | उन विशिष्ट क्रियाओं को बंद करें जिन्हें आप नहीं चाहते हैं |
+
+```bash
+claude-sfx mute                            # instant silence
+claude-sfx unmute
+claude-sfx volume 40                       # quieter
+claude-sfx config set quiet-start 22:00    # quiet after 10pm
+claude-sfx config set quiet-end 07:00      # until 7am
+claude-sfx disable navigate                # no more search pings
+claude-sfx enable navigate                 # bring it back
+```
+
+## एम्बिएंट (लंबे समय तक चलने वाले ऑपरेशन)
+
+उन कमांड के लिए जिन्हें पूरा होने में कुछ समय लगता है (बिल्ड, तैनाती, बड़े परीक्षण सूट):
+
+```bash
+claude-sfx ambient-start     # low drone fades in
+# ... operation runs ...
+claude-sfx ambient-resolve   # drone stops, resolution stinger plays
+claude-sfx ambient-stop      # stop drone silently (no stinger)
+```
+
+## सत्र ध्वनियाँ
+
+```bash
+claude-sfx session-start     # two-note ascending chime (boot)
+claude-sfx session-end       # two-note descending chime (closure)
+```
+
+## सभी कमांड
+
+```
+Setup:
+  init                            Install hooks into .claude/settings.json
+  uninstall                       Remove hooks
+
+Playback:
+  play <verb> [options]           Play a sound (goes through guard)
+  demo [--profile <name>]         Play all 7 verbs
+  preview [profile]               Audition all sounds in a profile
+  session-start / session-end     Chimes
+  ambient-start / ambient-resolve / ambient-stop
+
+Config:
+  mute / unmute                   Toggle all sounds
+  volume [0-100]                  Get or set volume
+  config                          Print current config
+  config set <key> <value>        Set a value
+  config reset                    Reset to defaults
+  config repo <profile|clear>     Per-directory profile override
+  disable / enable <verb>         Toggle specific verbs
+  export [dir] [--profile]        Export all sounds as .wav files
+```
+
+## यह कैसे काम करता है
+
+कोई भी ऑडियो फ़ाइल नहीं। प्रत्येक ध्वनि रनटाइम पर गणित से उत्पन्न होती है:
+
+- **ऑसिलेटर** — साइन, स्क्वायर, सॉटूथ, त्रिकोण, सफेद शोर
+- **एडीएसआर एनवलप** — अटैक, डीके, सस्टेन, रिलीज
+- **एफएम सिंथेसिस** — बनावट के लिए आवृत्ति मॉडुलन
+- **स्टेट-वेरिएबल फिल्टर** — "वूश" ध्वनि के लिए बैंडपास-फिल्टर किया गया शोर
+- **फ्रीक्वेंसी स्वीप** — गति के लिए रैखिक इंटरपोलेशन
+- **लाउडनेस लिमिटर** — सॉफ्ट-नी कंप्रेशन, हार्ड सीलिंग
+
+पूरा पैकेज लगभग 2,800 लाइनों का टाइपस्क्रिप्ट कोड है और इसमें कोई भी उत्पादन निर्भरता नहीं है। ध्वनियाँ पीसीएम बफर के रूप में उत्पन्न होती हैं, मेमोरी में WAV में एन्कोड की जाती हैं, और ऑपरेटिंग सिस्टम के मूल ऑडियो प्लेयर के माध्यम से चलाई जाती हैं (विंडोज पर पॉवरशेल, macOS पर एफ्प्ले, लिनक्स पर एप्ले)।
+
+## आवश्यकताएं:
+
+- Node.js 18+
+- क्लाउड कोड
+- सिस्टम ऑडियो आउटपुट (स्पीकर या हेडफ़ोन)
+
+## लाइसेंस:
+
+[एमआईटी](LICENSE)