{
  "markdown": "# Antigravity CLI Windows Notifications\n\nIntegration hooks for Antigravity CLI providing native Windows Toast notifications for completion events, user interaction requests, and tool permission prompts.\n\n## Overview\n\nThis project implements a professional notification system for the **Antigravity CLI** (`agy`) on Windows. It addresses the UX gap in long-running tasks by providing asynchronous alerts when the agent completes an operation or requires user intervention.\n\n## Key Features\n\n- **Completion & Failure Alerts**: Native Toast notifications for tasks. Automatically detects execution failures and changes alert sounds/titles accordingly.\n- **Interactive Prompts**: Immediate alerts for `ask_user` tool calls and `ToolPermission` requests.\n- **Native Audio**: Uses Windows native `SMS` notification sound for optimal user experience.\n- **CLI Configuration**: Adjust settings like the time threshold directly from your terminal.\n\n## Installation Guide\n\n### Option 1: Automated via Antigravity CLI (Recommended)\n\n1. Clone this repository and enter the directory:\n   ```powershell\n   git clone https://github.com/BillNobill/antigravity-cli-windows-notifier.git\n   cd antigravity-cli-windows-notifier\n   ```\n2. Open Antigravity CLI in this folder:\n   ```powershell\n   agy\n   ```\n3. Give the following prompt:\n   > \"Install the windows notification hooks for me.\"\n   *Or run the command directly:*\n   ```powershell\n   agy plugin install .\n   ```\n\n### Option 2: Legacy Manual Installation (Node.js)\nIf you prefer the legacy method (which modifies `settings.json` directly):\n1. Clone the repository and navigate to the root.\n2. Run the installer:\n   ```powershell\n   node install.js\n   ```\n\n### Uninstallation\n\nTo remove the hooks and assets from your system:\n```powershell\nagy plugin uninstall antigravity-windows-notifier\n```\n*Legacy removal:*\n```powershell\nnode uninstall.js\n```\n> [!NOTE]  \n> This operation will restore your `settings.json` from the latest backup and delete the notification scripts from the `.gemini/antigravity-cli/hooks` directory.\n\n## Configuration\n\nYou can easily adjust the notification settings using the included configuration utility. By default, the system only notifies for tasks exceeding 5 seconds and the brand icon is disabled to maximize text space.\n\n### Available Options\n\n| Option | Description | Example |\n| :--- | :--- | :--- |\n| `--threshold=[seconds]` | Set minimum task duration for notifications | `node config.js --threshold=10` |\n| `--icon=[on\\|off]` | Enable or disable the Antigravity logo in notifications | `node config.js --icon=on` |\n\n> [!TIP]\n> You can combine options in a single command: `node config.js --threshold=5 --icon=off`\n\n## Usage & Management\n\n### Global Scope\nOnce installed, the notifier becomes **Global** for your user. It works in **any folder** where you run the Antigravity CLI.\n\n### Enabling/Disabling Hooks\nManage notifications directly within the CLI:\n- **List active hooks**: `/hooks list`\n- **Disable a hook**: `/hooks disable [hook-name]`\n- **Enable a hook**: `/hooks enable [hook-name]`\n\n## Architecture\n\n- **`BeforeAgent`**: Persists start timestamp (ms) to `%TEMP%`.\n- **`AfterAgent`**: Handles duration calculation, error detection heuristics, and triggers the Windows Toast via PowerShell.\n- **`BeforeTool` & `Notification`**: Intercepts `ask_user` and `ToolPermission` events while preventing duplicate notifications.\n\n## Contributing\n\nTechnical contributions and bug reports are welcome via Pull Requests.\n\n## License\n\nMIT\n",
  "bytes": 3512,
  "sha": "7ad4f6d496862a77ffc323c8411df0b8b9a3477a6a3e7d5fa4ecda3921da989f",
  "repo_slug": "billnobill/antigravity-cli-windows-notifier",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_billnobill_antigravity_cli_windows_notif_71079586/readme"
}