{
  "markdown": "# Gemini Notifier Extension\n\nA Gemini CLI extension that provides desktop system notifications when the agent requires attention (e.g., waiting for tool permissions).\n\n## Features\n\n- **Native Terminal Notifications**: Supports modern terminals (Ghostty, iTerm2, Kitty, VSCode) via OSC escape codes.\n- **OS Fallback**: Falls back to system-level notifications (`osascript` on macOS, `notify-send` on Linux) if the terminal is not supported.\n- **Zero Config**: Works out of the box with the Gemini CLI `Notification` hook.\n\n## Supported Environments\n\n### Terminals (Native Integration)\nThe extension attempts to send native terminal notifications (OSC 9) for the following:\n- Ghostty\n- iTerm2\n- Kitty\n- VS Code Terminal\n- Apple Terminal\n\n### Operating Systems (Fallback)\nIf the terminal is not detected or supported, the extension attempts to use OS utilities:\n\n- **Android (Termux)**: Uses `termux-notification` (Requires `termux-api` package).\n- **macOS**: Uses `osascript` (built-in).\n- **Linux**: Uses `notify-send`.\n  - **Requirement**: Ensure `libnotify-bin` (Debian/Ubuntu) or `libnotify` (Arch/Fedora) is installed.\n  - Test with: `notify-send \"Test\" \"Message\"`\n\n## Installation\n\nThis extension is typically installed via the Gemini CLI extensions manager.\n\n```bash\ngemini extensions install https://github.com/thoreinstein/gemini-notifier\n# OR linked locally\ngemini extensions link .\n```\n\n## How it Works\n\n1. The extension registers a **Notification** hook with the Gemini CLI.\n2. When the CLI emits a `ToolPermission` event (Agent waiting for user), the hook triggers.\n3. The script (`src/notify.js`) checks your `TERM_PROGRAM` environment variable.\n4. If a supported terminal is found, it sends an escape code to stdout.\n5. If not, it attempts to spawn a system notification process (`osascript` or `notify-send`).\n",
  "bytes": 1824,
  "sha": "1b0af2255f8b7ec93fe4ac3b2ae8a1092b1798c9f847a2e0d924dea4c752e2b7",
  "repo_slug": "thoreinstein/gemini-notifier",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_thoreinstein_gemini_notifier_05d1b237/readme"
}