vibe-notify 0.1.0 → 0.1.1

package/README.ja.md

@@ -0,0 +1,112 @@
+# vibe-notify 🔊
+
+Claude Code セッションの通知音。Claude の応答が完了したときにカスタマイズ可能なビープ音/ジングルを再生します。席を離れていてもタスクの完了がわかります。
+
+## クイックスタート
+
+```bash
+# グローバルにインストール
+npm install -g vibe-notify
+
+# テスト
+vibe-notify victory
+
+# 設定ファイルを作成
+vibe-notify --init
+```
+
+インストールなしでも実行できます：
+
+```bash
+npx -y vibe-notify victory
+```
+
+## 内蔵サウンド
+
+| サウンド | 説明 |
+|-------|-------------|
+| `short-beep` | 短いビープ音 — クイック確認 |
+| `double-beep` | 2回の短いビープ音 — 「処理が完了しました」 |
+| `ascending` | 3つの上昇音 — ポジティブな進行 |
+| `descending` | 3つの下降音 — タスク完了、落ち着く |
+| `victory` | C-E-G-C アルペジオ — 勝利のジングル |
+| `custom` | 自分の `.wav` ファイルを再生 |
+
+いつでも一覧表示：`vibe-notify --list`
+
+## 設定
+
+設定ファイルの場所（優先順）：
+1. **プロジェクトローカル**：プロジェクトルートの `.vibe-notify.json`
+2. **グローバル**：`~/.vibe-notify/config.json`
+
+```json
+{
+  "sound": "ascending",
+  "customFile": null,
+  "volume": 0.7,
+  "playback": {
+    "method": "auto"
+  }
+}
+```
+
+### カスタムサウンドファイル
+
+```json
+{
+  "sound": "custom",
+  "customFile": "C:\\Users\\You\\sounds\\done.wav",
+  "volume": 1.0
+}
+```
+
+## Claude Code フック設定
+
+Claude の応答完了時に自動再生するには、`.claude/settings.json`（プロジェクトまたはグローバル）に以下を追加します：
+
+```json
+{
+  "hooks": {
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx",
+            "args": ["-y", "vibe-notify"],
+            "timeout": 15
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+グローバルインストールしている場合は `"npx", "-y", "vibe-notify"` を `"vibe-notify"` に置き換えてください。args にサウンド名（例：`"victory"`）を追加すると設定ファイルの設定を上書きできます。
+
+## CLI リファレンス
+
+```
+vibe-notify [options] [sound-name]
+
+オプション：
+  --help, -h       ヘルプを表示
+  --list, -l       利用可能なサウンドを一覧表示
+  --config, -c     設定ファイルのパスを表示
+  --init           デフォルト設定ファイルを作成
+  --version, -v    バージョンを表示
+```
+
+## 仕組み
+
+- **ランタイム依存ゼロ** — すべてのサウンド生成は純粋な Node.js で行います
+- 内蔵サウンドは WAV オーディオとしてメモリ上で生成（エンベロープ付き正弦波）
+- 再生にはネイティブシステムプレイヤーを使用：PowerShell SoundPlayer (Windows)、afplay (macOS)、paplay/aplay (Linux)
+- WAV 再生に失敗した場合は `[System.Console]::Beep()` または端末ベルにフォールバック
+- 一時ファイルは再生後すぐにクリーンアップ
+
+## ライセンス
+
+MIT

package/README.md

@@ -1,5 +1,7 @@
 # vibe-notify 🔊
 
+[English](./README.md) | [中文](./README.zh-CN.md) | [日本語](./README.ja.md)
+
 Notification sounds for Claude Code sessions. Plays a customizable beep/jingle when Claude finishes responding — so you can step away and still know when your task is done.
 
 ## Quick Start

package/README.zh-CN.md

@@ -0,0 +1,112 @@
+# vibe-notify 🔊
+
+Claude Code 会话的通知提示音。当 Claude 完成响应时播放可自定义的提示音/铃声 — 让你可以走开也能知道任务已完成。
+
+## 快速开始
+
+```bash
+# 全局安装
+npm install -g vibe-notify
+
+# 测试一下
+vibe-notify victory
+
+# 创建配置文件
+vibe-notify --init
+```
+
+或者无需安装直接运行：
+
+```bash
+npx -y vibe-notify victory
+```
+
+## 内置音效
+
+| 音效 | 描述 |
+|-------|-------------|
+| `short-beep` | 一声短促提示音 — 快速确认 |
+| `double-beep` | 两声短促提示音 — "任务完成了" |
+| `ascending` | 三声渐高音调 — 正向进展 |
+| `descending` | 三声渐低音调 — 任务完成，放松下来 |
+| `victory` | C-E-G-C 琶音 — 庆祝胜利 |
+| `custom` | 播放你自己的 `.wav` 文件 |
+
+随时查看音效列表：`vibe-notify --list`
+
+## 配置
+
+配置文件位置（按顺序查找）：
+1. **项目本地**：项目根目录下的 `.vibe-notify.json`
+2. **全局**：`~/.vibe-notify/config.json`
+
+```json
+{
+  "sound": "ascending",
+  "customFile": null,
+  "volume": 0.7,
+  "playback": {
+    "method": "auto"
+  }
+}
+```
+
+### 自定义音频文件
+
+```json
+{
+  "sound": "custom",
+  "customFile": "C:\\Users\\You\\sounds\\done.wav",
+  "volume": 1.0
+}
+```
+
+## Claude Code Hook 设置
+
+将以下内容添加到 `.claude/settings.json`（项目或全局），在 Claude 完成响应时自动播放：
+
+```json
+{
+  "hooks": {
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx",
+            "args": ["-y", "vibe-notify"],
+            "timeout": 15
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+如果已全局安装，将 `"npx", "-y", "vibe-notify"` 替换为 `"vibe-notify"`。在 args 中添加音效名称（如 `"victory"`）可覆盖配置文件中的设置。
+
+## CLI 参考
+
+```
+vibe-notify [options] [sound-name]
+
+选项：
+  --help, -h       显示帮助
+  --list, -l       列出可用音效
+  --config, -c     打印配置文件路径
+  --init           创建默认配置文件
+  --version, -v    显示版本
+```
+
+## 工作原理
+
+- **零运行时依赖** — 所有音频均使用纯 Node.js 生成
+- 内置音效以 WAV 格式在内存中生成（带包络的正弦波）
+- 播放使用系统原生播放器：PowerShell SoundPlayer (Windows)、afplay (macOS)、paplay/aplay (Linux)
+- 如果 WAV 播放失败，回退到 `[System.Console]::Beep()` 或终端响铃
+- 临时文件在播放后立即清理
+
+## 许可证
+
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibe-notify",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Notification sounds for Claude Code completions — customizable beeps when your session finishes",
   "keywords": ["claude", "claude-code", "notification", "sound", "beep", "alert"],
   "license": "MIT",
@@ -14,6 +14,8 @@
   "files": [
     "dist/",
     "README.md",
+    "README.zh-CN.md",
+    "README.ja.md",
     "LICENSE"
   ],
   "scripts": {