Install

One prompt. Your agent does the rest.

Requires Google Antigravity (CLI, IDE or 2.0) already installed. No shell one-liners and no third-party domain to trust — paste the prompt below into your agent and it clones the repo, wires the registry, and registers the extension. Everything lives under ~/.gemini/extensions/seo/, so it's namespaced as /seo:<command> and your existing Antigravity config is untouched.

Copy this into your agent

Paste the whole block into your Antigravity CLI / IDE (or Claude, Codex, Cursor). The agent will clone the repo, install requirements, wire the registry, and register the extension — no manual steps.

You are my install assistant. Install the Antigravity SEO extension from GitHub into my Google Antigravity config, end to end, without asking me to run anything manually.

REPO:     https://github.com/dotusmanali/antigravity-seo
BRANCH:   main
TARGET:   ~/.gemini/extensions/seo   (on Windows: %USERPROFILE%\.gemini\extensions\seo)
SETTINGS: ~/.gemini/settings.json    (Windows: %USERPROFILE%\.gemini\settings.json)

Do exactly this, in order. Stop and show me the error if any step fails.

1.  Verify Google Antigravity is installed (the ~/.gemini folder must already exist). If it does not, stop and tell me to install Antigravity first from https://antigravity.google.
2.  Back up ~/.gemini/settings.json to ~/.gemini/logs/antigravity-seo/backups/ before touching it.
3.  Download the main branch (git clone or the main.tar.gz tarball) into a temp dir. Create the TARGET folder and copy the repo's contents into it — the skills/, agents/, commands/, scripts/, tools/, templates/ folders and the top-level JSON files (registry.json, manifest.json, plugin.json, mcp_config.json, hooks.json) plus requirements.txt. Do not touch anything else under ~/.gemini/.
4.  Install Python dependencies:
       python3 -m pip install -r <TARGET>/requirements.txt
5.  Build and validate the skill/agent registry:
       python3 <TARGET>/tools/build_registry.py
    It must print "registry.json written" and exit 0. If it reports broken links or orphan skills, stop and show me the output.
6.  Register the extension in settings.json (append-only, merge — never overwrite existing keys):
       python3 <TARGET>/tools/register_extension.py
7.  Verify the environment (MCP servers, env vars, CLI tools):
       python3 <TARGET>/tools/verify_environment.py --json
    For every missing item it reports, install it or ask me for the value (never invent secrets, never write API keys to disk outside the OS keyring or a local .env I control).
8.  Confirm success by printing:
       - final TARGET path
       - number of skills, agents, and commands loaded
       - list of MCP servers detected
       - the exact command I should run next: "/seo:audit https://<my-site>"

Rules:
- Never delete or rewrite files outside <TARGET> and the single "extensions.seo" block in settings.json.
- Never echo, log, or transmit any API key, token, or secret value.
- If any step fails, print the full error and the recovery file at ~/.gemini/logs/antigravity-seo/last-error.md, then stop.

When everything above passes, tell me to restart Antigravity, then reply with "Antigravity SEO ready" and nothing else.

After install

  1. 01Restart your Antigravity CLI or IDE. It will pick up the extension registration automatically.
  2. 02Run /seo:audit https://your-site.com — the orchestrator will spawn the right subagents based on your site's business type.
  3. 03(Optional) Add MCP integrations: DataForSEO, Firecrawl, Google Search Console. The registry will detect them and unlock the matching skills.

Doctor

Machine-readable health check

Your agent can parse the JSON report and auto-install anything missing — no copy-pasting error messages.

$ python3 ~/.gemini/extensions/seo/tools/verify_environment.py --json

Returns { required, registry, optional_mcps, ok } with a fix field on every failing row.

Uninstall

Clean rollback

Runs the uninstaller that ships inside the extension. Removes the extension folder and unregisters from settings.json. Nothing else in ~/.gemini/ is touched.

$ bash ~/.gemini/extensions/seo/uninstall.sh
# Windows: ~/.gemini/extensions/seo/uninstall.ps1
# Restore pre-install settings: RESTORE_BACKUP=1 bash uninstall.sh

Something broke?

If a step fails, the recovery prompt at ~/.gemini/logs/antigravity-seo/last-error.md captures the exact error. Paste it into your Antigravity agent — it will diagnose and install what's missing.