{
  "markdown": "# Gemini CLI Notify Sound Extension\n\nA notification sound extension for the [Gemini CLI](https://geminicli.com) that plays an audio cue when various hook events occur. \n\nNever miss the completion of a long-running task, agent action, or prompt generation again. This extension works cross-platform (macOS, Linux, Windows) using built-in terminal audio players.\n\n## Features\n- **Cross-Platform Support:** Plays sounds using built-in tools (`afplay` on macOS, `aplay`/`paplay` on Linux, `PowerShell` on Windows).\n- **Default Sounds Included:** Comes with 4 crisp `ping` sounds (`.wav` format) out of the box to avoid licensing issues.\n- **macOS System Sounds:** On macOS, automatically supports playing native system sounds (like Ping, Pop, Basso, etc.).\n- **Event Specific:** Granular control over which Gemini CLI events trigger a sound.\n- **Interactive Configuration:** Easy-to-use interactive menu to set up sounds and event triggers.\n\n## Installation\n\nInstall the extension directly via the Gemini CLI using the public GitHub repository:\n\n```bash\ngemini extensions install https://github.com/hwanyong/notify-sound\n```\n\n## Configuration\n\nYou can easily configure the extension using the interactive command provided:\n\n```bash\n/notify-sound:config\n```\n\n### Configuration Options\n\nWhen you run the config command, you will see an interactive menu:\n\n1. **Master Switch:** Quickly enable or disable the entire extension.\n2. **Change Sound:** \n   - Choose between the built-in sounds (`ping1`, `ping2`, `ping3`, `ping4`).\n   - If you are on a Mac, you will also see the native macOS system sounds.\n3. **Event Toggles:** You can toggle sounds on/off for specific Gemini CLI lifecycle hooks:\n   - `SessionStart` / `SessionEnd`\n   - `BeforeAgent` / `AfterAgent`\n   - `BeforeModel` / `AfterModel`\n   - `BeforeToolSelection` \n   - `BeforeTool` / `AfterTool`\n   - `Notification`\n   - `PreCompress`\n\n## CLI Commands\n\nIn addition to the interactive config, you can quickly toggle the master state:\n\n- **Enable all sounds:**\n  ```bash\n  /notify-sound:enable\n  ```\n- **Disable all sounds (Silence):**\n  ```bash\n  /notify-sound:disable\n  ```\n- **Check current status:**\n  ```bash\n  /notify-sound:status\n  ```\n\n## License\n\nThis project is licensed under the [MIT License](LICENSE). \nThe included `ping1` ~ `ping4` sounds are assumed to be royalty-free/public domain (CC0) or appropriately licensed for distribution.\n",
  "bytes": 2401,
  "sha": "dd63ad321726aeee05b31825d8411b2015ac6f252a41456b3911f99688547177",
  "repo_slug": "hwanyong/notify-sound",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_hwanyong_notify_sound_46ae62b9/readme"
}