{
  "markdown": "# Gemini CLI + Warp\n\nOfficial [Warp](https://warp.dev) terminal integration for [Gemini CLI](https://github.com/google-gemini/gemini-cli).\n\n## Features\n\n### 🔔 Native Notifications\n\nGet native Warp notifications when Gemini CLI:\n- **Completes a task** — with a summary showing your prompt and Gemini's response\n- **Needs your input** — when Gemini has been idle and is waiting for you\n- **Requests permission** — when Gemini wants to run a tool and needs your approval\n\nNotifications appear in Warp's notification center and as system notifications, so you can context-switch while Gemini works and get alerted when attention is needed.\n\n### 📡 Session Status\n\nThe extension keeps Warp informed of Gemini's current state by emitting structured events on every session transition:\n- **Prompt submitted** — you sent a prompt, Gemini is working\n- **Tool completed** — a tool call finished, Gemini is back to running\n\nThis powers Warp's inline status indicators for Gemini CLI sessions.\n\n## Installation\n\n```bash\ngemini extensions install <github-url-or-local-path>\n```\n\nFor local development:\n\n```bash\ngemini extensions link ~/gemini-warp\n```\n\n> ⚠️ **Important**: After installing, **restart Gemini CLI** for the extension to activate.\n\nOnce restarted, notifications will appear automatically.\n\n## Requirements\n\n- [Warp terminal](https://warp.dev) (macOS, Linux, or Windows)\n- [Gemini CLI](https://github.com/google-gemini/gemini-cli) v0.26.0+\n- `jq` for JSON parsing (install via `brew install jq` or your package manager)\n\n## How It Works\n\nThe extension communicates with Warp via OSC 777 escape sequences. Each hook script builds a structured JSON payload (via `build-payload.sh`) and sends it to `warp://cli-agent`, where Warp parses it to drive notifications and session UI.\n\nPayloads include a protocol version negotiated between the extension and Warp (`min(plugin_version, warp_version)`), the session ID, working directory, and event-specific fields.\n\nThe extension registers five hooks:\n- **SessionStart** — emits the extension version on startup\n- **AfterAgent** — fires when Gemini finishes a turn, sends a task-complete notification with your prompt and Gemini's response\n- **Notification** — handles both idle notifications and tool-permission requests (Gemini merges these into one event, dispatched by `notification_type`)\n- **BeforeAgent** — fires when you submit a prompt, signaling the session is active again\n- **AfterTool** — fires when a tool call completes, signaling the session is no longer blocked\n\n## Configuration\n\nNotifications work out of the box. To customize Warp's notification behavior (sounds, system notifications, etc.), see [Warp's notification settings](https://docs.warp.dev/features/notifications).\n\n## Uninstall\n\n```bash\ngemini extensions uninstall warp\n```\n\n## Versioning\n\nThe extension version in `gemini-extension.json` is checked by the Warp client to detect outdated installations.\nWhen bumping the version here, also update `MINIMUM_PLUGIN_VERSION` in the Warp client.\n\n## License\n\nMIT License — see [LICENSE](LICENSE) for details.\n",
  "bytes": 3077,
  "sha": "a9e8a651de27aa210fbc029419727660df6df17ec2a295ec693a2009559e94aa",
  "repo_slug": "warpdotdev/gemini-cli-warp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_warpdotdev_gemini_cli_warp_6aca1e7a/readme"
}