{
  "markdown": "# Gemini Extension: Audio Alerts\n\nCustom audio alerts for Gemini CLI to solve the **\"Silent Hang\"** issue in IDE terminals like VS Code.\n\n## Problem\nSystem notifications are often suppressed in IDE terminals, causing sessions to \"hang\" when Gemini waits for user input without any audible alert.\n\n## Solution\nDirect audio alerts triggered via Gemini's hook system when:\n- Gemini requests tools permission\n- A task completes\n- An error occurs\n\n## Installation\n\n```bash\ngemini extensions install https://github.com/HainanZhao/gemini-extension-audio-alerts\n```\n\n## Important: Enable Notifications\n\n**This extension requires notifications to be enabled in Gemini settings.**\n\nEnable notifications using:\n```\n/settings\n```\n\nWithout notifications enabled, the audio alerts will not trigger for some events.\n\n## Configuration (Optional)\n### Manual Configuration\n\nYou can edit the `.env` file directly.\n1.  **Locate the extension directory**: `~/.gemini/extensions/audio-alerts`\n2.  **Edit the environment file**:\n    ```bash\n    # Open the .env file in your editor\n    open ~/.gemini/extensions/audio-alerts/.env\n    ```\n3.  **Set the variables**:\n    ```dotenv\n    # Set your preferred theme (default, retro, portal, hero, premium)\n    AUDIO_ALERTS_THEME=retro\n\n    # Enable debug logging (optional, 1=enabled, 0=disabled)\n    AUDIO_ALERTS_DEBUG=0\n\n    # Disable Text-to-Speech (TTS) completely (true or false)\n    AUDIO_ALERTS_DISABLE_TTS=false\n    ```\n\nChanges to the `.env` file are loaded automatically by Gemini CLI.\n\n## Sound Themes\n\n| Theme | Style |\n|-------|-------|\n| default | Agent thriller |\n| retro | 8-bit video game |\n| portal | Sci-fi |\n| hero | Cinematic |\n| premium | Elegant |\n\nTo change the theme, use the `gemini settings` command or edit the `~/.gemini/extensions/audio-alerts/.env` file.\n\n## How It Works\n\nHooks are defined in `hooks/hooks.json`:\n- **Notification** (`ToolPermission`) → Question sound (standalone terminal)\n- **AfterAgent** → Completion sound (skips TTS if < 30s)\n\n## Requirements\n\n- **macOS**: Built-in `afplay`\n- **Linux**: `sox`, `mpg123`, or `paplay`\n\n## License\n\nISC License\n",
  "bytes": 2115,
  "sha": "1f04e2bdb5b993eda6ea01a4090e7e1c67fa6254d183089bae5e05803149014b",
  "repo_slug": "hainanzhao/gemini-extension-audio-alerts",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_hainanzhao_gemini_extension_audio_alerts_1083c79a/readme"
}