@mcptoolshop/claude-sfx 0.1.2 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (13) hide show
  1. package/CHANGELOG.md +47 -0
  2. package/README.es.md +132 -118
  3. package/README.fr.md +132 -118
  4. package/README.hi.md +132 -118
  5. package/README.it.md +132 -118
  6. package/README.ja.md +132 -118
  7. package/README.md +18 -4
  8. package/README.pt-BR.md +132 -118
  9. package/README.zh.md +132 -118
  10. package/dist/cli.js +50 -8
  11. package/dist/errors.d.ts +35 -0
  12. package/dist/errors.js +59 -0
  13. package/package.json +5 -2
package/README.fr.md CHANGED
@@ -1,54 +1,56 @@
1
- <p align="center">
2
- <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>
3
- </p>
4
-
1
+ <p align="center">
2
+ <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>
3
+ </p>
4
+
5
5
  <p align="center">
6
6
  <img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/claude-sfx/readme.jpg" width="400" alt="Claude-SFX">
7
7
  </p>
8
-
8
+
9
9
  <p align="center">
10
- <a href="https://www.npmjs.com/package/claude-sfx"><img src="https://img.shields.io/npm/v/claude-sfx" alt="npm version"></a>
10
+ <a href="https://www.npmjs.com/package/@mcptoolshop/claude-sfx"><img src="https://img.shields.io/npm/v/@mcptoolshop/claude-sfx" alt="npm version"></a>
11
+ <a href="https://github.com/mcp-tool-shop-org/claude-sfx/actions/workflows/ci.yml"><img src="https://github.com/mcp-tool-shop-org/claude-sfx/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
12
+ <a href="https://codecov.io/gh/mcp-tool-shop-org/claude-sfx"><img src="https://codecov.io/gh/mcp-tool-shop-org/claude-sfx/branch/main/graph/badge.svg" alt="codecov"></a>
11
13
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT License"></a>
12
14
  <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>
13
15
  </p>
14
-
15
- 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.
16
-
17
- ## Démarrage rapide
18
-
16
+
17
+ 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.
18
+
19
+ ## Démarrage rapide
20
+
19
21
  ```bash
20
- npm install -g claude-sfx
22
+ npm install -g @mcptoolshop/claude-sfx
21
23
  cd your-project
22
24
  claude-sfx init # install hooks into .claude/settings.json
23
25
  claude-sfx demo # hear all 7 verbs
24
26
  ```
25
-
26
- Voilà. Claude Code émettra désormais des sons pendant son fonctionnement.
27
-
28
- ## Pourquoi un retour audio ?
29
-
30
- 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 :
31
-
32
- - **Accessibilité** : écoutez les changements d'état, les erreurs et les confirmations sans avoir à surveiller le terminal.
33
- - **Fluidité** : sachez si un test a réussi ou si une modification a été intégrée sans avoir à changer de contexte.
34
- - **Présence** : l'agent vous semble être un collaborateur, et non une boîte noire.
35
-
36
- ## Les 7 actions
37
-
38
- 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.
39
-
40
- | Action | Déclencheurs | Son |
41
- | --- | --- | --- |
42
- | **intake** | `Read`, `WebFetch`, `WebSearch` | Onde sinusoïdale ascendante : quelque chose arrive. |
43
- | **transform** | `Edit` | Impulsion texturée par modulation de fréquence (FM) : remodelage. |
44
- | **commit** | `Write`, `NotebookEdit`, `git commit` | Tonnette percutant : confirmation. |
45
- | **navigate** | `Grep`, `Glob` | Impulsion sonar : analyse. |
46
- | **execute** | `Bash`, `npm test`, `tsc` | Bruit + ton : action mécanique. |
47
- | **move** | `mv`, `cp`, lancement de sous-agent. | Sifflement de vent : déplacement d'air. |
48
- | **sync** | `git push`, `git pull` | Sifflement dramatique + ancre tonale. |
49
-
50
- ### Modificateurs
51
-
27
+
28
+ Voilà. Claude Code émettra désormais des sons pendant son fonctionnement.
29
+
30
+ ## Pourquoi un retour audio ?
31
+
32
+ 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 vous contentez de regarder le texte défiler. Le retour audio rétablit la conscience :
33
+
34
+ - **Accessibilité** : écoutez les changements d'état, les erreurs et les confirmations sans avoir à surveiller le terminal.
35
+ - **Fluidité** : sachez qu'un test a réussi ou qu'une modification a été intégrée sans avoir à changer de contexte.
36
+ - **Présence** : l'agent vous semble être un collaborateur, et non une boîte noire.
37
+
38
+ ## Les 7 verbes
39
+
40
+ Chaque action de Claude Code correspond à l'un des 7 verbes principaux. Les modificateurs (état, portée, direction) modifient le son sans rompre la cohérence.
41
+
42
+ | Verbe | Déclencheurs | Son |
43
+ |---|---|---|
44
+ | **intake** | `Read`, `WebFetch`, `WebSearch` | Onde sinusoïdale ascendante : quelque chose arrive. |
45
+ | **transform** | `Edit` | Impulsion texturée par modulation de fréquence : remodelage. |
46
+ | **commit** | `Write`, `NotebookEdit`, `git commit` | Sonnet net : confirmation. |
47
+ | **navigate** | `Grep`, `Glob` | Impulsion sonar : analyse. |
48
+ | **execute** | `Bash`, `npm test`, `tsc` | Explosion de bruit + tonalité : action mécanique. |
49
+ | **move** | `mv`, `cp`, création de sous-agent. | Sifflement de vent : déplacement d'air. |
50
+ | **sync** | `git push`, `git pull` | Sifflement dramatique + ancre tonale. |
51
+
52
+ ### Modificateurs
53
+
52
54
  ```bash
53
55
  claude-sfx play navigate --status ok # bright ping (octave harmonic)
54
56
  claude-sfx play navigate --status err # low detuned ping (dissonance)
@@ -57,60 +59,60 @@ claude-sfx play sync --direction up # rising whoosh (push)
57
59
  claude-sfx play sync --direction down # falling whoosh (pull)
58
60
  claude-sfx play intake --scope remote # longer tail (distance feel)
59
61
  ```
60
-
61
- ### Détection intelligente de Bash
62
-
63
- Le gestionnaire de hooks analyse les commandes Bash pour choisir le son approprié :
64
-
65
- | Commande Bash | Action | État |
66
- | --- | --- | --- |
67
- | `git push` | sync (montée) | code de retour |
68
- | `git pull` | sync (descente) | code de retour |
69
- | `npm test`, `pytest` | exécution | code de retour |
70
- | `tsc`, `npm run build` | exécution | code de retour |
71
- | `mv`, `cp` | déplacement | — |
72
- | `rm` | déplacement | avertissement |
73
- | tout le reste | exécution | code de retour |
74
-
75
- ## Profils
76
-
77
- Palettes de sons qui modifient l'ensemble du comportement avec un seul paramètre.
78
-
79
- | Profil | Comportement |
80
- | --- | --- |
81
- | **minimal** (default) | Tons en onde sinusoïdale : subtils, professionnels, pour une utilisation quotidienne. |
82
- | **retro** | Bruits de couinement en onde carrée 8 bits : amusants mais contrôlés. |
83
-
62
+
63
+ ### Détection intelligente de Bash
64
+
65
+ Le gestionnaire de hooks analyse les commandes Bash pour choisir le son approprié :
66
+
67
+ | Commande Bash | Verbe | État |
68
+ |---|---|---|
69
+ | `git push` | sync (montée) | code de sortie |
70
+ | `git pull` | sync (descente) | code de sortie |
71
+ | `npm test`, `pytest` | exécution | code de sortie |
72
+ | `tsc`, `npm run build` | exécution | code de sortie |
73
+ | `mv`, `cp` | déplacement | — |
74
+ | `rm` | déplacement | avertissement |
75
+ | tout le reste | exécution | code de sortie |
76
+
77
+ ## Profils
78
+
79
+ Palettes de sons qui modifient l'ensemble du comportement avec un seul paramètre.
80
+
81
+ | Profil | Comportement |
82
+ |---|---|
83
+ | **minimal** (default) | Tons sinusoïdaux : subtils, professionnels, pour une utilisation quotidienne. |
84
+ | **retro** | Bruits de 8 bits en forme de carré : amusants mais contrôlés. |
85
+
84
86
  ```bash
85
87
  claude-sfx demo --profile retro # hear retro palette
86
88
  claude-sfx preview minimal # audition all sounds + modifiers
87
89
  claude-sfx config set profile retro # change default globally
88
90
  claude-sfx config repo retro # use retro in current directory only
89
91
  ```
90
-
91
- ### Profils personnalisés
92
-
93
- Copiez `profiles/minimal.json`, modifiez les paramètres de synthèse, puis chargez-le :
94
-
92
+
93
+ ### Profils personnalisés
94
+
95
+ Copiez `profiles/minimal.json`, modifiez les paramètres de synthèse, puis chargez-le :
96
+
95
97
  ```bash
96
98
  claude-sfx play navigate --profile ./my-profile.json
97
99
  ```
98
-
99
- 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.
100
-
101
- ## Prévention des nuisances
102
-
103
- Ce qui distingue un produit d'un simple jouet.
104
-
105
- | Fonctionnalité | Comportement |
106
- | --- | --- |
107
- | **Debounce** | Même action dans un délai de 200 ms → un seul son. |
108
- | **Rate limit** | Maximum de 8 sons par fenêtre de 10 secondes. |
109
- | **Quiet hours** | Tous les sons sont désactivés pendant les heures configurées. |
110
- | **Mute** | Activation/désactivation instantanée, persiste après le redémarrage de la session. |
111
- | **Volume** | Contrôle du gain de 0 à 100. |
112
- | **Per-verb disable** | Désactivez les actions spécifiques que vous ne souhaitez pas entendre. |
113
-
100
+
101
+ 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.
102
+
103
+ ## Prévention des nuisances
104
+
105
+ Ce qui distingue un produit d'un simple jouet.
106
+
107
+ | Fonctionnalité | Comportement |
108
+ |---|---|
109
+ | **Debounce** | Même verbe dans un délai de 200 ms → un seul son. |
110
+ | **Rate limit** | Maximum de 8 sons par fenêtre de 10 secondes. |
111
+ | **Quiet hours** | Tous les sons sont désactivés pendant les heures configurées. |
112
+ | **Mute** | Activation/désactivation instantanée, persiste après le redémarrage de la session. |
113
+ | **Volume** | Contrôle du gain de 0 à 100. |
114
+ | **Per-verb disable** | Désactivez les verbes spécifiques que vous ne souhaitez pas utiliser. |
115
+
114
116
  ```bash
115
117
  claude-sfx mute # instant silence
116
118
  claude-sfx unmute
@@ -120,27 +122,27 @@ claude-sfx config set quiet-end 07:00 # until 7am
120
122
  claude-sfx disable navigate # no more search pings
121
123
  claude-sfx enable navigate # bring it back
122
124
  ```
123
-
124
- ## Ambiance (opérations de longue durée)
125
-
126
- Pour les commandes qui prennent du temps (compilations, déploiements, suites de tests volumineuses) :
127
-
125
+
126
+ ## Ambiance (opérations de longue durée)
127
+
128
+ Pour les commandes qui prennent du temps (compilations, déploiements, suites de tests volumineuses) :
129
+
128
130
  ```bash
129
131
  claude-sfx ambient-start # low drone fades in
130
132
  # ... operation runs ...
131
133
  claude-sfx ambient-resolve # drone stops, resolution stinger plays
132
134
  claude-sfx ambient-stop # stop drone silently (no stinger)
133
135
  ```
134
-
135
- ## Sons de session
136
-
136
+
137
+ ## Sons de session
138
+
137
139
  ```bash
138
140
  claude-sfx session-start # two-note ascending chime (boot)
139
141
  claude-sfx session-end # two-note descending chime (closure)
140
142
  ```
141
-
142
- ## Toutes les commandes
143
-
143
+
144
+ ## Toutes les commandes
145
+
144
146
  ```
145
147
  Setup:
146
148
  init Install hooks into .claude/settings.json
@@ -163,26 +165,38 @@ Config:
163
165
  disable / enable <verb> Toggle specific verbs
164
166
  export [dir] [--profile] Export all sounds as .wav files
165
167
  ```
166
-
167
- ## Fonctionnement
168
-
169
- Aucun fichier audio. Chaque son est synthétisé en temps réel à partir de formules mathématiques :
170
-
171
- - **Oscillateurs** — sinusoïdale, carrée, en dents de scie, triangulaire, bruit blanc
172
- - **Enveloppes ADSR** — attaque, décroissance, sustain, relâchement
173
- - **Synthèse FM** — modulation de fréquence pour créer des textures
174
- - **Filtre à état variable** — bruit filtré en bande passante pour créer des effets de "whoosh"
175
- - **Balayages de fréquence** — interpolation linéaire pour créer du mouvement
176
- - **Limiteur de volume** — compression "soft-knee", seuil maximum
177
-
178
- 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).
179
-
180
- ## Prérequis
181
-
182
- - Node.js 18+
183
- - Claude Code
184
- - Sortie audio du système (haut-parleurs ou casque)
185
-
186
- ## Licence
187
-
188
- [MIT](LICENSE)
168
+
169
+ ## Fonctionnement
170
+
171
+ Aucun fichier audio. Chaque son est synthétisé en temps réel à partir de formules mathématiques :
172
+
173
+ - **Oscillateurs** : sinusoïdale, carrée, en dents de scie, triangulaire, bruit blanc.
174
+ - **Enveloppes ADSR** : attaque, décroissance, maintien, relâchement.
175
+ - **Synthèse FM** : modulation de fréquence pour la texture.
176
+ - **Filtre à état variable** : bruit filtré en bande passante pour les sifflements.
177
+ - **Balayages de fréquence** : interpolation linéaire pour le mouvement.
178
+ - **Limiteur de volume** : compression "soft-knee", seuil maximum.
179
+
180
+ L'ensemble du système est constitué d'environ 2 800 lignes de TypeScript, sans aucune dépendance de production. Les sons sont générés sous forme de tampons PCM, encodés en WAV en mémoire, puis lus via le lecteur audio natif du système d'exploitation (PowerShell sous Windows, afplay sous macOS, aplay sous Linux).
181
+
182
+ ## Sécurité et confidentialité
183
+
184
+ **Données modifiées :** `~/.claude-sfx/config.json` (préférences), `.claude/settings.json` (enregistrement des extensions). Les tampons audio sont générés en mémoire et ne sont jamais écrits sur le disque, sauf si vous exécutez la commande `export`.
185
+
186
+ **Données non modifiées :** code source, historique Git, réseau, identifiants, variables d'environnement. Aucune donnée de télémétrie n'est collectée ni envoyée. Aucun fichier audio n'est téléchargé ; chaque son est synthétisé localement à partir de calculs mathématiques.
187
+
188
+ **Autorisations :** lecture/écriture du système de fichiers pour la configuration et les extensions, invocation du lecteur audio du système d'exploitation. Consultez le fichier [SECURITY.md](SECURITY.md) pour connaître la politique complète.
189
+
190
+ ## Prérequis
191
+
192
+ - Node.js 18+
193
+ - Claude Code
194
+ - Sortie audio du système (haut-parleurs ou casque)
195
+
196
+ ## Licence
197
+
198
+ [MIT](LICENSE)
199
+
200
+ ---
201
+
202
+ Créé par <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a>
package/README.hi.md CHANGED
@@ -1,54 +1,56 @@
1
- <p align="center">
2
- <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>
3
- </p>
4
-
1
+ <p align="center">
2
+ <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>
3
+ </p>
4
+
5
5
  <p align="center">
6
6
  <img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/claude-sfx/readme.jpg" width="400" alt="Claude-SFX">
7
7
  </p>
8
-
8
+
9
9
  <p align="center">
10
- <a href="https://www.npmjs.com/package/claude-sfx"><img src="https://img.shields.io/npm/v/claude-sfx" alt="npm version"></a>
10
+ <a href="https://www.npmjs.com/package/@mcptoolshop/claude-sfx"><img src="https://img.shields.io/npm/v/@mcptoolshop/claude-sfx" alt="npm version"></a>
11
+ <a href="https://github.com/mcp-tool-shop-org/claude-sfx/actions/workflows/ci.yml"><img src="https://github.com/mcp-tool-shop-org/claude-sfx/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
12
+ <a href="https://codecov.io/gh/mcp-tool-shop-org/claude-sfx"><img src="https://codecov.io/gh/mcp-tool-shop-org/claude-sfx/branch/main/graph/badge.svg" alt="codecov"></a>
11
13
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT License"></a>
12
14
  <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>
13
15
  </p>
14
-
15
- प्रक्रियात्मक ऑडियो प्रतिक्रिया [क्लाउड कोड] (https://docs.anthropic.com/en/docs/claude-code) के लिए। प्रत्येक टूल कॉल, फ़ाइल संपादन, खोज, गिट पुश और एजेंट डिस्पैच के लिए एक अलग ध्वनि होती है - जो ऑडियो फ़ाइलों के बजाय गणित से उत्पन्न होती है।
16
-
17
- ## शुरुआत
18
-
16
+
17
+ [क्लाउड कोड](https://docs.anthropic.com/en/docs/claude-code) के लिए प्रक्रियात्मक ऑडियो प्रतिक्रिया। प्रत्येक टूल का उपयोग, फ़ाइल में बदलाव, खोज, गिट पुश, और एजेंट को भेजने पर एक अलग ध्वनि उत्पन्न होती है - यह ध्वनि ऑडियो फ़ाइलों से नहीं, बल्कि गणितीय गणनाओं के आधार पर बनाई जाती है।
18
+
19
+ ## शुरुआत कैसे करें।
20
+
19
21
  ```bash
20
- npm install -g claude-sfx
22
+ npm install -g @mcptoolshop/claude-sfx
21
23
  cd your-project
22
24
  claude-sfx init # install hooks into .claude/settings.json
23
25
  claude-sfx demo # hear all 7 verbs
24
26
  ```
25
-
26
- बस इतना ही। क्लाउड कोड अब काम करते समय ध्वनियाँ बजाएगा।
27
-
28
- ## ऑडियो प्रतिक्रिया क्यों?
29
-
30
- जब कोई एआई एजेंट आपकी ओर से पढ़ता है, लिखता है, खोजता है और तैनात करता है, तो आप दृश्यता खो देते हैं। आप केवल टेक्स्ट को स्क्रॉल होते हुए देखते हैं। ऑडियो प्रतिक्रिया जागरूकता बहाल करती है:
31
-
32
- - **पहुंच** - टर्मिनल को देखने के बिना स्थिति परिवर्तन, त्रुटियों और पूर्णता को सुनें
33
- - **प्रवाह** - बिना संदर्भ बदले यह जानें कि कोई परीक्षण पास हुआ है या कोई पुश सफल हुआ है
34
- - **उपस्थिति** - एजेंट एक सहयोगी की तरह महसूस होता है, न कि एक ब्लैक बॉक्स की तरह
35
-
36
- ## 7 क्रियाएँ
37
-
38
- प्रत्येक क्लाउड कोड क्रिया 7 मुख्य क्रियाओं में से एक से मेल खाती है। संशोधक (स्थिति, दायरा, दिशा) ध्वनि को बदलते हैं लेकिन सामंजस्य को नहीं तोड़ते।
39
-
40
- | क्रिया | ट्रिगर | ध्वनि |
41
- | --- | --- | --- |
42
- | **intake** | `Read`, `WebFetch`, `WebSearch` | हल्की बढ़ती हुई साइन तरंग - कुछ आ रहा है |
43
- | **transform** | `Edit` | एफएम-टेक्सचर्ड पल्स - पुन: आकार देना |
44
- | **commit** | `Write`, `NotebookEdit`, `git commit` | तेज स्टैम्प टोन - सील |
45
- | **navigate** | `Grep`, `Glob` | सोनार पिंग - स्कैनिंग |
46
- | **execute** | `Bash`, `npm test`, `tsc` | शोर विस्फोट + टोन - यांत्रिक क्रिया |
47
- | **move** | `mv`, `cp`, सबएजेंट स्पॉन | हवा की सरसराहट - वायु विस्थापन |
48
- | **sync** | `git push`, `git pull` | नाटकीय सरसराहट + टोनल एंकर |
49
-
50
- ### संशोधक
51
-
27
+
28
+ बस इतना ही। अब, क्लाउड कोड काम करते समय आवाज़ें उत्पन्न करेगा।
29
+
30
+ ## ऑडियो फीडबैक क्यों?
31
+
32
+ जब कोई एआई एजेंट आपकी ओर से पढ़ता है, लिखता है, खोज करता है और काम करता है, तो आप उस प्रक्रिया की जानकारी खो देते हैं। आप बस टेक्स्ट को स्क्रीन पर बहते हुए देखते रहते हैं। ऑडियो प्रतिक्रिया आपको फिर से जागरूक करती है:
33
+
34
+ - **उपलब्धता:** टर्मिनल पर ध्यान दिए बिना, सिस्टम में होने वाले परिवर्तनों, त्रुटियों और पूर्ण होने की सूचनाएं प्राप्त करें।
35
+ - **सुविधा:** यह जानने के लिए कि कोई परीक्षण सफल हुआ है या कोई बदलाव लागू हुआ है, संदर्भ बदलने की आवश्यकता नहीं होती।
36
+ - **उपस्थिति:** यह एजेंट एक सहयोगी की तरह महसूस होता है, न कि एक जटिल प्रणाली की।
37
+
38
+ ## सात क्रियाएँ।
39
+
40
+ प्रत्येक क्लाउड कोड क्रिया 7 मुख्य क्रियाओं में से किसी एक से मेल खाती है। संशोधक (स्थिति, दायरा, दिशा) ध्वनि को बदलते हैं, लेकिन वाक्य की स्पष्टता को बाधित नहीं करते।
41
+
42
+ | क्रिया। | ट्रिगर। | ध्वनि। |
43
+ |---|---|---|
44
+ | **intake** | `Read`, `WebFetch`, `WebSearch` | धीरे-धीरे ऊपर की ओर बढ़ने वाली साइन तरंग - कुछ आ रहा है। |
45
+ | **transform** | `Edit` | एफएम-टेक्सचर्ड पल्स - पुन: आकार देना। |
46
+ | **commit** | `Write`, `NotebookEdit`, `git commit` | तेज़ और स्पष्ट मुहर का निशान - सील कर दिया गया। |
47
+ | **navigate** | `Grep`, `Glob` | सोनार सिग्नल - स्कैनिंग। |
48
+ | **execute** | `Bash`, `npm test`, `tsc` | ध्वनि विस्फोट + स्वर - यांत्रिक क्रिया। |
49
+ | **move** | `mv`, `cp`, सब-एजेंट स्पॉन। | हवा की तेज़ गति - वायु का विस्थापन। |
50
+ | **sync** | `git push`, `git pull` | अचानक होने वाली तेज़ आवाज़ + स्वर-आधारित उच्चारण। |
51
+
52
+ ### संशोधक।
53
+
52
54
  ```bash
53
55
  claude-sfx play navigate --status ok # bright ping (octave harmonic)
54
56
  claude-sfx play navigate --status err # low detuned ping (dissonance)
@@ -57,60 +59,60 @@ claude-sfx play sync --direction up # rising whoosh (push)
57
59
  claude-sfx play sync --direction down # falling whoosh (pull)
58
60
  claude-sfx play intake --scope remote # longer tail (distance feel)
59
61
  ```
60
-
61
- ### स्मार्ट बैश डिटेक्शन
62
-
63
- हुक हैंडलर सही ध्वनि चुनने के लिए बैश कमांड का निरीक्षण करता है:
64
-
65
- | बैश कमांड | क्रिया | स्थिति |
66
- | --- | --- | --- |
67
- | `git push` | sync (ऊपर) | एग्जिट कोड से |
68
- | `git pull` | sync (नीचे) | एग्जिट कोड से |
69
- | `npm test`, `pytest` | निष्पादित करें | एग्जिट कोड से |
70
- | `tsc`, `npm run build` | निष्पादित करें | एग्जिट कोड से |
71
- | `mv`, `cp` | स्थानांतरित करें | — |
72
- | `rm` | स्थानांतरित करें | चेतावनी |
73
- | सब कुछ और | निष्पादित करें | एग्जिट कोड से |
74
-
75
- ## प्रोफ़ाइल
76
-
77
- ध्वनि पैलेट जो एक झंडे के साथ पूरे चरित्र को बदलते हैं।
78
-
79
- | प्रोफ़ाइल | चरित्र |
80
- | --- | --- |
81
- | **minimal** (default) | साइन-वेव टोन - सूक्ष्म, पेशेवर, दैनिक उपयोग के लिए |
82
- | **retro** | स्क्वायर-वेव 8-बिट चीप्स - मजेदार लेकिन नियंत्रित |
83
-
62
+
63
+ ### स्मार्ट बैश डिटेक्शन (या, बेहतर बैश पहचान तकनीक)
64
+
65
+ "हुक हैंडलर" बैश कमांड की जांच करता है ताकि सही ध्वनि का चयन किया जा सके:
66
+
67
+ | बैश कमांड। | क्रिया। | स्थिति। |
68
+ |---|---|---|
69
+ | `git push` | सिंक्रोनाइज़ (करना) | "एग्जिट कोड से" या "एग्जिट कोड के माध्यम से" |
70
+ | `git pull` | सिंक्रोनाइज़ (डाउनलोड) करें। | "एग्जिट कोड से" या "एग्जिट कोड के माध्यम से" |
71
+ | `npm test`, `pytest` | निष्पादित करना। | "एग्जिट कोड से" या "एग्जिट कोड के माध्यम से" |
72
+ | `tsc`, `npm run build` | निष्पादित करना। | "एग्जिट कोड से" या "एग्जिट कोड के माध्यम से" |
73
+ | `mv`, `cp` | स्थानांतरित करना। | — |
74
+ | `rm` | स्थानांतरित करना। | चेतावनी देना। |
75
+ | सब कुछ और। | निष्पादित करना। | "एग्जिट कोड से" या "एग्जिट कोड के माध्यम से" |
76
+
77
+ ## प्रोफ़ाइलें।
78
+
79
+ ऐसे ध्वनि विकल्प जो एक ही सेटिंग बदलकर पूरी तरह से अनुभव को बदल देते हैं।
80
+
81
+ | प्रोफ़ाइल। | चरित्र। |
82
+ |---|---|
83
+ | **minimal** (default) | साइन वेव टोन - सूक्ष्म, पेशेवर, और रोजमर्रा के उपयोग के लिए उपयुक्त। |
84
+ | **retro** | स्क्वेयर-वेव 8-बिट ध्वनियाँ - मज़ेदार, लेकिन नियंत्रित। |
85
+
84
86
  ```bash
85
87
  claude-sfx demo --profile retro # hear retro palette
86
88
  claude-sfx preview minimal # audition all sounds + modifiers
87
89
  claude-sfx config set profile retro # change default globally
88
90
  claude-sfx config repo retro # use retro in current directory only
89
91
  ```
90
-
91
- ### कस्टम प्रोफाइल
92
-
93
- `profiles/minimal.json` की प्रतिलिपि बनाएँ, संश्लेषण मापदंडों को संपादित करें, और इसे लोड करें:
94
-
92
+
93
+ ### अनुकूलित प्रोफाइल।
94
+
95
+ `profiles/minimal.json` फ़ाइल की कॉपी बनाएं, संश्लेषण (सिंथेसिस) के मापदंडों को संपादित करें, और फिर उसे लोड करें:
96
+
95
97
  ```bash
96
98
  claude-sfx play navigate --profile ./my-profile.json
97
99
  ```
98
-
99
- JSON में प्रत्येक संख्या सीधे सिंथ इंजन से मेल खाती है - तरंग, आवृत्ति, अवधि, लिफाफा (ADSR), FM गहराई, बैंडविड्थ, गेन।
100
-
101
- ## अनायासता-रोधी
102
-
103
- यह एक उत्पाद को एक खिलौने से अलग करता है।
104
-
105
- | विशेषता | व्यवहार |
106
- | --- | --- |
107
- | **Debounce** | समान क्रिया 200ms के भीतर → एक ध्वनि |
108
- | **Rate limit** | प्रति 10-सेकंड विंडो में अधिकतम 8 ध्वनियाँ |
109
- | **Quiet hours** | निर्धारित घंटों के दौरान सभी ध्वनियाँ बंद |
110
- | **Mute** | तत्काल टॉगल, सत्र पुनरारंभ पर भी बना रहता है |
111
- | **Volume** | 0–100 गेन नियंत्रण |
112
- | **Per-verb disable** | उन विशिष्ट क्रियाओं को बंद करें जिन्हें आप नहीं चाहते हैं |
113
-
100
+
101
+ JSON में मौजूद प्रत्येक संख्या सीधे सिंथेसाइज़र इंजन से जुड़ी होती है - इसमें वेवफॉर्म, आवृत्ति, अवधि, एनवेलप (एडीएसआर), एफएम की गहराई, बैंडविड्थ और गेन शामिल हैं।
102
+
103
+ ## अवांछित व्यवधानों से बचाव
104
+
105
+ एक उत्पाद और एक खिलौने में क्या अंतर होता है?
106
+
107
+ | विशेषता। | व्यवहार। |
108
+ |---|---|
109
+ | **Debounce** | एक ही क्रिया शब्द का प्रयोग 200 मिलीसेकंड के भीतर होने पर → एक ही ध्वनि उत्पन्न होगी। |
110
+ | **Rate limit** | एक 10-सेकंड की अवधि में अधिकतम 8 ध्वनियाँ रिकॉर्ड की जा सकती हैं। |
111
+ | **Quiet hours** | निर्धारित समय के दौरान सभी ध्वनियाँ बंद कर दी जाएंगी। |
112
+ | **Mute** | तत्काल स्विच करने की सुविधा, सत्र के पुनः आरंभ होने पर भी बरकरार रहती है। |
113
+ | **Volume** | 0-100: नियंत्रण प्राप्त करें। |
114
+ | **Per-verb disable** | उन विशिष्ट क्रियाओं को बंद कर दें जिन्हें आप प्रदर्शित नहीं करना चाहते। |
115
+
114
116
  ```bash
115
117
  claude-sfx mute # instant silence
116
118
  claude-sfx unmute
@@ -120,27 +122,27 @@ claude-sfx config set quiet-end 07:00 # until 7am
120
122
  claude-sfx disable navigate # no more search pings
121
123
  claude-sfx enable navigate # bring it back
122
124
  ```
123
-
124
- ## एम्बिएंट (लंबे समय तक चलने वाले ऑपरेशन)
125
-
126
- उन कमांड के लिए जिन्हें पूरा होने में कुछ समय लगता है (बिल्ड, तैनाती, बड़े परीक्षण सूट):
127
-
125
+
126
+ ## एम्बिएंट (लंबे समय तक चलने वाले ऑपरेशन)
127
+
128
+ उन कमांडों के लिए जिनमें समय लगता है (जैसे कि सॉफ्टवेयर बनाना, तैनात करना, या बड़े परीक्षणों का समूह चलाना):
129
+
128
130
  ```bash
129
131
  claude-sfx ambient-start # low drone fades in
130
132
  # ... operation runs ...
131
133
  claude-sfx ambient-resolve # drone stops, resolution stinger plays
132
134
  claude-sfx ambient-stop # stop drone silently (no stinger)
133
135
  ```
134
-
135
- ## सत्र ध्वनियाँ
136
-
136
+
137
+ ## सत्र की ध्वनियाँ।
138
+
137
139
  ```bash
138
140
  claude-sfx session-start # two-note ascending chime (boot)
139
141
  claude-sfx session-end # two-note descending chime (closure)
140
142
  ```
141
-
142
- ## सभी कमांड
143
-
143
+
144
+ ## सभी आदेश।
145
+
144
146
  ```
145
147
  Setup:
146
148
  init Install hooks into .claude/settings.json
@@ -163,26 +165,38 @@ Config:
163
165
  disable / enable <verb> Toggle specific verbs
164
166
  export [dir] [--profile] Export all sounds as .wav files
165
167
  ```
166
-
167
- ## यह कैसे काम करता है
168
-
169
- कोई भी ऑडियो फ़ाइल नहीं। प्रत्येक ध्वनि रनटाइम पर गणित से उत्पन्न होती है:
170
-
171
- - **ऑसिलेटर** — साइन, स्क्वायर, सॉटूथ, त्रिकोण, सफेद शोर
172
- - **एडीएसआर एनवलप** — अटैक, डीके, सस्टेन, रिलीज
173
- - **एफएम सिंथेसिस** — बनावट के लिए आवृत्ति मॉडुलन
174
- - **स्टेट-वेरिएबल फिल्टर** — "वूश" ध्वनि के लिए बैंडपास-फिल्टर किया गया शोर
175
- - **फ्रीक्वेंसी स्वीप** — गति के लिए रैखिक इंटरपोलेशन
176
- - **लाउडनेस लिमिटर** — सॉफ्ट-नी कंप्रेशन, हार्ड सीलिंग
177
-
178
- पूरा पैकेज लगभग 2,800 लाइनों का टाइपस्क्रिप्ट कोड है और इसमें कोई भी उत्पादन निर्भरता नहीं है। ध्वनियाँ पीसीएम बफर के रूप में उत्पन्न होती हैं, मेमोरी में WAV में एन्कोड की जाती हैं, और ऑपरेटिंग सिस्टम के मूल ऑडियो प्लेयर के माध्यम से चलाई जाती हैं (विंडोज पर पॉवरशेल, macOS पर एफ्प्ले, लिनक्स पर एप्ले)।
179
-
180
- ## आवश्यकताएं:
181
-
182
- - Node.js 18+
183
- - क्लाउड कोड
184
- - सिस्टम ऑडियो आउटपुट (स्पीकर या हेडफ़ोन)
185
-
186
- ## लाइसेंस:
187
-
188
- [एमआईटी](LICENSE)
168
+
169
+ ## यह कैसे काम करता है।
170
+
171
+ कोई भी ऑडियो फ़ाइल मौजूद नहीं है। हर ध्वनि, गणितीय सूत्रों के आधार पर, प्रोग्राम चलने के दौरान ही उत्पन्न की जाती है।
172
+
173
+ - **ऑसिलेटर:** साइन, स्क्वायर, सॉटूथ, त्रिकोण, सफेद शोर।
174
+ - **एडीएसआर एनवलप:** अटैक, डीके, सस्टेन, रिलीज।
175
+ - **एफएम सिंथेसिस:** बनावट के लिए आवृत्ति मॉडुलन।
176
+ - **स्टेट-वेरिएबल फिल्टर:** "वूश" ध्वनि के लिए बैंडपास-फिल्टर किया गया शोर।
177
+ - **फ्रीक्वेंसी स्वीप:** गति के लिए रैखिक इंटरपोलेशन।
178
+ - **लाउडनेस लिमिटर:** सॉफ्ट-नी कंप्रेशन, हार्ड सीलिंग।
179
+
180
+ पूरा पैकेज लगभग 2,800 लाइनों का टाइपस्क्रिप्ट कोड है, जिसमें कोई भी बाहरी निर्भरता नहीं है जो उत्पादन में आवश्यक हो। ध्वनियाँ पीसीएम बफ़र के रूप में उत्पन्न होती हैं, उन्हें मेमोरी में WAV फ़ॉर्मेट में एन्कोड किया जाता है, और फिर ऑपरेटिंग सिस्टम के मूल ऑडियो प्लेयर के माध्यम से बजाया जाता है (विंडोज पर पॉवरशेल, macOS पर एफ़प्ले, और लिनक्स पर एप्ले)।
181
+
182
+ ## सुरक्षा और गोपनीयता।
183
+
184
+ **जिन डेटा तक पहुंचा जाता है:** `~/.claude-sfx/config.json` (प्राथमिकताएं), `.claude/settings.json` (हुक पंजीकरण)। ऑडियो बफर मेमोरी में उत्पन्न होते हैं और केवल तभी डिस्क पर लिखे जाते हैं जब आप `export` कमांड चलाते हैं।
185
+
186
+ **जिन डेटा तक नहीं पहुंचा जाता:** स्रोत कोड, गिट इतिहास, नेटवर्क, क्रेडेंशियल, पर्यावरण चर। कोई भी टेलीमेट्री डेटा एकत्र या भेजा नहीं जाता है। कोई भी ऑडियो फ़ाइल डाउनलोड नहीं की जाती है - हर ध्वनि गणित के आधार पर स्थानीय रूप से उत्पन्न होती है।
187
+
188
+ **अनुमतियाँ:** कॉन्फ़िगरेशन और हुक के लिए फ़ाइल सिस्टम पढ़ने/लिखने की अनुमति, ऑपरेटिंग सिस्टम के ऑडियो प्लेयर को चलाने की अनुमति। पूर्ण नीति के लिए [SECURITY.md](SECURITY.md) देखें।
189
+
190
+ ## आवश्यकताएं
191
+
192
+ - Node.js 18+
193
+ - क्लाउड कोड
194
+ - सिस्टम ऑडियो आउटपुट (स्पीकर या हेडफ़ोन)
195
+
196
+ ## लाइसेंस
197
+
198
+ [MIT](LICENSE)
199
+
200
+ ---
201
+
202
+ यह <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a> द्वारा बनाया गया है।