@mcptoolshop/claude-sfx 0.1.0

package/README.it.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.hi.md">हिन्दी</a> | <a href="README.md">English</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>
+
+Feedback audio procedurale per [Claude Code](https://docs.anthropic.com/en/docs/claude-code). Ogni chiamata a uno strumento, modifica di un file, ricerca, push Git e invio di un agente produce un suono distinto, generato tramite calcoli matematici, non tramite file audio.
+
+## Guida rapida
+
+```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
+```
+
+Ecco tutto. Claude Code ora riprodurrà dei suoni mentre lavora.
+
+## Perché il feedback audio?
+
+Quando un agente AI legge, scrive, cerca e distribuisce al posto tuo, si perde la visibilità. Si sta fissando un testo che scorre. Il feedback audio ripristina la consapevolezza:
+
+- **Accessibilità** — ascoltare i cambiamenti di stato, gli errori e i completamenti senza guardare il terminale.
+- **Fluidità** — sapere se un test è superato o se un aggiornamento è stato completato senza dover cambiare contesto.
+- **Presenza** — l'agente sembra un collaboratore, non una scatola nera.
+
+## I 7 verbi
+
+Ogni azione di Claude Code corrisponde a uno dei 7 verbi principali. I modificatori (stato, ambito, direzione) alterano il suono senza compromettere la coerenza.
+
+| Verbo | Trigger | Suono |
+| --- | --- | --- |
+| **intake** | `Read`, `WebFetch`, `WebSearch` | Onda sinusoidale in aumento — qualcosa sta arrivando |
+| **transform** | `Edit` | Impulso con texture FM — rimodellamento |
+| **commit** | `Write`, `NotebookEdit`, `git commit` | Tono di timbro deciso — completato |
+| **navigate** | `Grep`, `Glob` | Ronzio simile a un sonar — scansione |
+| **execute** | `Bash`, `npm test`, `tsc` | Esplosione di rumore + tono — azione meccanica |
+| **move** | `mv`, `cp`, avvio di un sub-agente | Fruscio del vento — spostamento dell'aria |
+| **sync** | `git push`, `git pull` | Fruscio drammatico + ancoraggio tonale |
+
+### Modificatori
+
+```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)
+```
+
+### Rilevamento intelligente di Bash
+
+Il gestore degli eventi analizza i comandi Bash per scegliere il suono corretto:
+
+| Comando Bash | Verbo | Stato |
+| --- | --- | --- |
+| `git push` | sync (in alto) | dal codice di uscita |
+| `git pull` | sync (in basso) | dal codice di uscita |
+| `npm test`, `pytest` | esegui | dal codice di uscita |
+| `tsc`, `npm run build` | esegui | dal codice di uscita |
+| `mv`, `cp` | sposta | — |
+| `rm` | sposta | avviso |
+| tutto il resto | esegui | dal codice di uscita |
+
+## Profili
+
+Palette di suoni che cambiano completamente il carattere con un'unica opzione.
+
+| Profilo | Carattere |
+| --- | --- |
+| **minimal** (default) | Toni a onda sinusoidale — sottili, professionali, adatti all'uso quotidiano |
+| **retro** | Cinguettii a onda quadra a 8 bit — divertenti ma controllati |
+
+```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
+```
+
+### Profili personalizzati
+
+Copia `profiles/minimal.json`, modifica i parametri di sintesi e caricalo:
+
+```bash
+claude-sfx play navigate --profile ./my-profile.json
+```
+
+Ogni numero nel file JSON corrisponde direttamente al motore di sintesi: forma d'onda, frequenza, durata, inviluppo (ADSR), profondità FM, larghezza di banda, guadagno.
+
+## Anti-fastidio
+
+Ciò che distingue un prodotto da un giocattolo.
+
+| Funzionalità | Comportamento |
+| --- | --- |
+| **Debounce** | Lo stesso verbo entro 200 ms → un suono |
+| **Rate limit** | Max 8 suoni per una finestra di 10 secondi |
+| **Quiet hours** | Tutti i suoni disattivati durante le ore configurate |
+| **Mute** | Attivazione/disattivazione istantanea, sopravvive al riavvio della sessione |
+| **Volume** | Controllo del guadagno da 0 a 100 |
+| **Per-verb disable** | Disattivare verbi specifici che non si desidera utilizzare |
+
+```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 (operazioni a lunga esecuzione)
+
+Per i comandi che richiedono molto tempo (compilazioni, distribuzioni, suite di test di grandi dimensioni):
+
+```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)
+```
+
+## Suoni della sessione
+
+```bash
+claude-sfx session-start     # two-note ascending chime (boot)
+claude-sfx session-end       # two-note descending chime (closure)
+```
+
+## Tutti i comandi
+
+```
+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
+```
+
+## Come funziona
+
+Nessun file audio. Ogni suono è generato al runtime tramite calcoli matematici:
+
+- **Oscillatori** — sinusoidale, quadrato, a dente di sega, triangolare, rumore bianco
+- **Involucri ADSR** — attacco, decadimento, sustain, rilascio
+- **Sintesi FM** — modulazione di frequenza per creare texture
+- **Filtro a variabile di stato** — rumore filtrato in banda passante per effetti di "whoosh"
+- **Sweep di frequenza** — interpolazione lineare per creare movimento
+- **Limitatore di volume** — compressione "soft-knee", limite massimo rigido
+
+L'intero pacchetto è composto da circa 2.800 righe di codice TypeScript e non presenta dipendenze per la produzione. I suoni vengono generati come buffer PCM, codificati in formato WAV in memoria e riprodotti tramite il lettore audio nativo del sistema operativo (PowerShell su Windows, afplay su macOS, aplay su Linux).
+
+## Requisiti
+
+- Node.js 18 o superiore
+- Claude Code
+- Uscita audio del sistema (altoparlanti o cuffie)
+
+## Licenza
+
+[MIT](LICENSE)

package/README.ja.md

@@ -0,0 +1,188 @@
+<p align="center">
+  <a href="README.md">English</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.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>
+
+[Claude Code](https://docs.anthropic.com/en/docs/claude-code) のための、プロシージャルなオーディオフィードバック機能。 ツール呼び出し、ファイル編集、検索、git push、エージェントの起動など、すべての操作に対して、数学に基づいて生成された独特のサウンドが再生されます（オーディオファイルを使用していません）。
+
+## クイックスタート
+
+```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
+```
+
+これで完了です。Claude Code は、動作中にサウンドを再生するようになります。
+
+## なぜオーディオフィードバックが必要なのか？
+
+AIエージェントがあなたの代わりに読み込み、書き込み、検索し、デプロイを行う場合、あなたは状況を把握しにくくなります。 画面に表示されるテキストをただ見ているだけです。 オーディオフィードバックは、状況を把握する能力を取り戻します。
+
+- **アクセシビリティ:** ターミナルを見なくても、状態の変化、エラー、完了などを音声で把握できます。
+- **スムーズな作業:** テストが成功したか、push が完了したかを、コンテキストを切り替えることなく音声で知ることができます。
+- **没入感:** エージェントが単なるブラックボックスではなく、協力者のように感じられます。
+
+## 7つのアクション
+
+Claude Code のすべての操作は、7つのコアアクションのいずれかに対応します。 修飾子（ステータス、範囲、方向）は、サウンドを変更しますが、一貫性を保ちます。
+
+| アクション | トリガー | サウンド |
+| --- | --- | --- |
+| **intake** | `Read`, `WebFetch`, `WebSearch` | 緩やかな上昇音 - 何かが始まる |
+| **transform** | `Edit` | FMテクスチャのパルス - 形状の変化 |
+| **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)
+```
+
+### スマートなBash検出
+
+フックハンドラは、Bashコマンドを検査して、適切なサウンドを選択します。
+
+| Bashコマンド | アクション | ステータス |
+| --- | --- | --- |
+| `git push` | `sync (up)` | 終了コードから |
+| `git pull` | `sync (down)` | 終了コードから |
+| `npm test`, `pytest` | 実行 | 終了コードから |
+| `tsc`, `npm run build` | 実行 | 終了コードから |
+| `mv`, `cp` | 移動 | — |
+| `rm` | 移動 | 警告 |
+| その他すべて | 実行 | 終了コードから |
+
+## プロファイル
+
+1つのフラグで、サウンド全体を変更するサウンドパレット。
+
+| プロファイル | サウンド |
+| --- | --- |
+| **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以内に発生した場合 → 1つのサウンド |
+| **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
+```
+
+## 仕組み
+
+オーディオファイルは一切使用していません。すべてのサウンドは、実行時に数学に基づいて合成されます。
+
+- **発振器**：サイン波、矩形波、のこぎり波、三角波、ホワイトノイズ
+- **ADSRエンベロープ**：アタック、ディケイ、サスティン、リリース
+- **FMシンセシス**：テクスチャを作成するための周波数変調
+- **ステートバリアブルフィルター**：ウィーシュ音を作成するためのバンドパスフィルターを通したノイズ
+- **周波数スイープ**：動きを表現するための線形補間
+- **ラウドネスリミッター**：ソフトニー・コンプレッション、ハード・シーリング
+
+このパッケージ全体は約2,800行のTypeScriptで記述されており、外部依存性は一切ありません。音はPCMバッファとして生成され、メモリ内でWAV形式にエンコードされ、OSネイティブのオーディオプレイヤーを通じて再生されます（WindowsではPowerShell、macOSではafplay、Linuxではaplay）。
+
+## 必要条件
+
+- Node.js 18以降
+- Claude Code
+- システムオーディオ出力（スピーカーまたはヘッドホン）
+
+## ライセンス
+
+[MIT](LICENSE)

package/README.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.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/@mcptoolshop/claude-sfx"><img src="https://img.shields.io/npm/v/@mcptoolshop/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>
+
+Procedural audio feedback for [Claude Code](https://docs.anthropic.com/en/docs/claude-code). Every tool call, file edit, search, git push, and agent dispatch gets a distinct sound — synthesized from math, not audio files.
+
+## Quick Start
+
+```bash
+npm install -g @mcptoolshop/claude-sfx
+cd your-project
+claude-sfx init       # install hooks into .claude/settings.json
+claude-sfx demo       # hear all 7 verbs
+```
+
+That's it. Claude Code will now play sounds as it works.
+
+## Why Audio Feedback?
+
+When an AI agent reads, writes, searches, and deploys on your behalf, you lose visibility. You're staring at text scrolling past. Audio feedback restores awareness:
+
+- **Accessibility** — hear state changes, errors, and completions without watching the terminal
+- **Flow** — know a test passed or a push landed without context-switching
+- **Presence** — the agent feels like a collaborator, not a black box
+
+## The 7 Verbs
+
+Every Claude Code action maps to one of 7 core verbs. Modifiers (status, scope, direction) alter the sound without breaking coherence.
+
+| Verb | Triggers | Sound |
+|---|---|---|
+| **intake** | `Read`, `WebFetch`, `WebSearch` | Soft rising sine — something coming in |
+| **transform** | `Edit` | FM-textured pulse — reshaping |
+| **commit** | `Write`, `NotebookEdit`, `git commit` | Sharp stamp tone — sealed |
+| **navigate** | `Grep`, `Glob` | Sonar ping — scanning |
+| **execute** | `Bash`, `npm test`, `tsc` | Noise burst + tone — mechanical action |
+| **move** | `mv`, `cp`, subagent spawn | Wind whoosh — air displacement |
+| **sync** | `git push`, `git pull` | Dramatic whoosh + tonal anchor |
+
+### Modifiers
+
+```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)
+```
+
+### Smart Bash Detection
+
+The hook handler inspects Bash commands to pick the right sound:
+
+| Bash Command | Verb | Status |
+|---|---|---|
+| `git push` | sync (up) | from exit code |
+| `git pull` | sync (down) | from exit code |
+| `npm test`, `pytest` | execute | from exit code |
+| `tsc`, `npm run build` | execute | from exit code |
+| `mv`, `cp` | move | — |
+| `rm` | move | warn |
+| everything else | execute | from exit code |
+
+## Profiles
+
+Sound palettes that change the entire character with one flag.
+
+| Profile | Character |
+|---|---|
+| **minimal** (default) | Sine-wave tones — subtle, professional, daily-driver |
+| **retro** | Square-wave 8-bit chirps — fun but controlled |
+
+```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
+```
+
+### Custom Profiles
+
+Copy `profiles/minimal.json`, edit the synthesis parameters, load it:
+
+```bash
+claude-sfx play navigate --profile ./my-profile.json
+```
+
+Every number in the JSON maps directly to the synth engine — waveform, frequency, duration, envelope (ADSR), FM depth, bandwidth, gain.
+
+## Anti-Annoyance
+
+What separates a product from a toy.
+
+| Feature | Behavior |
+|---|---|
+| **Debounce** | Same verb within 200ms → one sound |
+| **Rate limit** | Max 8 sounds per 10-second window |
+| **Quiet hours** | All sounds suppressed during configured hours |
+| **Mute** | Instant toggle, survives session restart |
+| **Volume** | 0–100 gain control |
+| **Per-verb disable** | Turn off specific verbs you don't want |
+
+```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
+```
+
+## Ambient (Long-Running Operations)
+
+For commands that take a while (builds, deploys, large test suites):
+
+```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)
+```
+
+## Session Sounds
+
+```bash
+claude-sfx session-start     # two-note ascending chime (boot)
+claude-sfx session-end       # two-note descending chime (closure)
+```
+
+## All Commands
+
+```
+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
+```
+
+## How It Works
+
+Zero audio files. Every sound is synthesized at runtime from math:
+
+- **Oscillators** — sine, square, sawtooth, triangle, white noise
+- **ADSR envelopes** — attack, decay, sustain, release
+- **FM synthesis** — frequency modulation for texture
+- **State-variable filter** — bandpass-filtered noise for whooshes
+- **Frequency sweeps** — linear interpolation for movement
+- **Loudness limiter** — soft-knee compression, hard ceiling
+
+The entire package is ~2,800 lines of TypeScript with zero production dependencies. Sounds are generated as PCM buffers, encoded to WAV in memory, and played through the OS native audio player (PowerShell on Windows, afplay on macOS, aplay on Linux).
+
+## Requirements
+
+- Node.js 18+
+- Claude Code
+- System audio output (speakers or headphones)
+
+## License
+
+[MIT](LICENSE)