# Purge the WordPress cache with Antigravity

> Purging the WordPress cache with Antigravity means asking its agent, inside the editor where you just changed a site, to clear the xSpeed cache and check the result through the xSpeed Hub server connected to it.

Page: https://xspeedcache.com/agent/antigravity/purge-cache/
Last updated: October 2026

You are in Antigravity with a WordPress project open and an agent ready to take a task. You change a template or a stylesheet and need to see it live. You describe the job in the agent panel: purge the cache on shop for the files I touched, and tell me what was cleared. The agent calls list_sites to match the name, then purge_cache with a type, and the result returns in the same session.

Antigravity connects to the Hub with OAuth, so an xSpeed Hub page opens in your browser where you sign in and approve access, then you copy the authorization code the page shows and paste it into the settings panel. Antigravity keeps the credentials it receives. The OAuth consent page has no read-only option, so the sign-in gets the scopes Antigravity requests, read and write by default, and only a sign-in as a Viewer member is read-only. A purge of type all reports the page cache, the object cache and, where Cloudflare is connected, the edge, so the agent can tell you which store held the old copy, and it can read get_cache_status afterwards to confirm.

Antigravity runs MCP tools in Ask mode unless you have configured otherwise, so each call waits for your approval in a card. xSpeed Hub has no confirmation of its own, so a purge runs as soon as the connection allows writes and Antigravity lets the call through. Allow rules such as mcp(xspeedhub/get_cache_status) or mcp(xspeedhub/*) let calls through without a prompt, and the Turbo permission preset allows MCP actions without asking. For a purge across every site, the Hub also tells the agent to say that it will touch all the sites and wait for your yes, but that is an instruction to the model, not a lock.

## Set up Antigravity once

### 1. Put your sites in xSpeed Hub

Sign in at app.xspeedcache.com with Google or email; the Hub is free and has no site cap. Then connect each WordPress site from its own dashboard: click Connect Hub in the xSpeed Cache top bar, then Connect via xSpeed Hub. Each site needs the free xSpeed Cache plugin.

### 2. Add xSpeed Hub to mcp_config.json

Antigravity reads ~/.gemini/config/mcp_config.json for every project, or .agents/mcp_config.json inside one workspace. In the IDE, open the ... menu at the top of the agent side panel, choose MCP Servers, then Manage MCP Servers and View raw config. Remote servers must use the serverUrl field; the older url and httpUrl fields are not supported.

File: `~/.gemini/config/mcp_config.json`

```json
{
  "mcpServers": {
    "xspeedhub": {
      "serverUrl": "https://app.xspeedcache.com/xspeed/mcp"
    }
  }
}
```

### 3. Authenticate

Open Agent settings with Cmd+, on macOS or Ctrl+, on Windows and Linux, go to the Customizations tab and click Authenticate next to xspeedhub. Sign in to xSpeed Hub in the browser and approve access, copy the authorization code the page shows, paste it into the settings panel and click Submit. Antigravity keeps the credentials it receives and refreshes them. In the CLI, type /mcp to open the MCP manager and check the server status.

```
Settings → Customizations → Authenticate
```

Full setup: https://xspeedcache.com/agent/antigravity/

### Before you send a prompt that changes something

Reads change nothing on your sites, though contact_support emails xSpeed support. Writes run once your connection allows them, so your client's approval prompt and a read-only connection (the token's Read-only everywhere switch, or a Viewer sign-in) are the gates that matter. Antigravity runs unconfigured MCP tools in Ask mode, so each call waits for your approval in a card before it executes. Allow rules such as mcp(xspeedhub/get_cache_status) or mcp(xspeedhub/*) let calls through without a prompt, Ask and Deny rules take precedence over Allow, and the Turbo permission preset allows MCP and web actions without asking. When you approve a card you can also edit its target to widen the grant. With Turbo or a broad allow rule, a write reaches the Hub as soon as your connection allows writes. xSpeed Hub has no confirmation step of its own.

## Prompts

- I changed the header styles on blog. Use xSpeed Hub to purge only assets there and check the cache status afterwards.
- With xSpeed Hub, read the cache status of every site, then purge the page cache on the one with the lowest hit ratio.
- Using xSpeed Hub, purge every site in my workspace and list any that failed.

## Example session

```
You: I updated the header styles on blog. Use xSpeed Hub to clear the stale files.
  → list_sites [read-only]: 6 sites; blog is blog.example.com
Agent: Only CSS changed, so I will purge assets on blog and keep the cached pages. Proceed?
You: Proceed.
  → purge_cache(site: blog, type: assets) [changes site]: 19 minified CSS and JS files cleared
  → get_cache_status(site: blog) [read-only]: page cache on, 190 cached pages, last purge just now
Agent: The assets cache on blog is cleared and 190 pages stay cached. A page that still shows old styles needs a page purge too; say so and I will run it.
```

## How it works

1. **Find the site**: The agent calls list_sites when you have more than one site, then matches the name you used to a site handle. If the name could mean two sites, the Hub tells it to ask you rather than guess.
2. **Pick the purge type**: purge_cache takes a type: all, page, assets, object or rest. all clears the page cache, the object cache and, when they are connected, the Cloudflare edge and CDN. After a theme or CSS change, assets is enough; after a content edit, page; after a deploy, all.
3. **Purge**: The call runs straight away on that site once your connection allows writes. For every site at once the agent passes site: "all", and the Hub runs the sites one after another with a one-second pause.
4. **Clear only the edge if that is all you need**: purge_cloudflare empties the Cloudflare edge cache on its own, without touching the copies on your server. A page or assets purge does not reach Cloudflare; a purge of type all does when Cloudflare is connected.
5. **Warm it again**: start_preloader rebuilds the cache in the background so the first visitors after the purge are not the ones paying for it.

## Reference

| | |
| --- | --- |
| Tool | purge_cache (write) |
| Purge types | all, page, assets, object, rest |
| What all covers | Page cache, object cache, plus the Cloudflare edge and CDN when connected |
| Every site at once | site: "all" or a list of handles, one result per site |
| Fan-out pacing | Sites run one after another with a 1 second pause |
| Edge only | purge_cloudflare, a separate write tool |
| Re-warm | start_preloader after the purge |
| Read-only access | purge_cache is refused on a connection token with Read-only everywhere on, and for a Viewer sign-in |
| Confirmation | None on the Hub; your client's prompt is the gate |

## Rules

- Name the site. With several sites, an unclear name should make the agent ask, and the Hub tells it to.
- A purge of every site is one call with site: "all". The Hub tells the agent to confirm it with you once before it runs.
- Purge the narrowest type that fixes the problem, then warm the cache, so visitors do not all hit uncached pages at once.
- A fan-out result is reported per site. Treat some sites failing as a partial result, not a failure of the whole call.

## Good to know with Antigravity

Antigravity runs MCP tools in Ask mode by default, so a purge waits for your approval card. A broad allow rule such as mcp(xspeedhub/*) or the Turbo permission preset removes that stop, and then purge_cache runs the moment the agent calls it. Allow single reads with a rule like mcp(xspeedhub/get_cache_status), add an Ask rule for purge_cache, and remember that Ask and Deny take precedence over Allow. When you approve a card you can edit its target to widen the grant, so read it before you submit. The OAuth sign-in gets the scopes Antigravity requests, read and write by default, and the Hub's Read-only everywhere switch applies only to the connection token, so for an agent that should only look, sign in as a Viewer member of the workspace.

## More prompts for this job

They work in any client connected to xSpeed Hub.

- Use xSpeed Hub to purge the page cache on blog.
- I just changed the theme CSS on shop. Use xSpeed Hub to purge only the assets cache there.
- With xSpeed Hub, purge every site in my workspace and tell me which ones failed.
- Use xSpeed Hub to purge shop, then purge its Cloudflare edge cache too.
- With xSpeed Hub, purge the docs site and start the preloader so it is warm again.
- Using xSpeed Hub, what purge type should I use after updating a plugin that changes the checkout page?

## Frequently asked questions

### Can Antigravity purge my WordPress cache?

Yes. Connect xSpeed Hub to Antigravity, then ask the agent to purge the site you changed. It calls purge_cache with the type that fits and can read the cache status afterwards to confirm.

### How does Antigravity sign in to xSpeed Hub?

It uses OAuth. An xSpeed Hub page opens in your browser, you sign in and approve access, copy the authorization code the page shows into the settings panel, and Antigravity keeps the credentials it receives, so there is no connection token to paste. The consent page has no read-only option, so it gets the scopes Antigravity requests, read and write by default, and a sign-in as a Viewer member is read-only and refuses every purge.

### What is the difference between the purge types?

all clears every cache xSpeed manages for the site, including a connected Cloudflare zone or CDN. page clears the stored HTML pages, assets clears minified and combined CSS and JavaScript, object clears the Redis or Memcached object cache, and rest clears cached REST API responses.

### Does purging xSpeed also clear Cloudflare?

A purge of type all does, when the site has Cloudflare connected in xSpeed: it clears the page cache, the object cache and the Cloudflare edge, and reports each one. A page, assets or rest purge stays on your server. purge_cloudflare clears only the edge.

### Can I purge all of my sites with one prompt?

Yes. The agent passes site: "all" to purge_cache and the Hub purges every site in the workspace one after another, returning a result per site. The Hub tells the agent to confirm a write across every site with you once before it runs it.

### Will a purge slow my site down?

The next request to each purged page builds it fresh, which is slower than a cached hit. Starting the preloader right after the purge rebuilds the cache in the background so visitors mostly land on warm pages.

## Purge the cache with other agents

[Claude Code](https://xspeedcache.com/agent/claude-code/purge-cache/) · [Claude](https://xspeedcache.com/agent/claude/purge-cache/) · [Claude Cowork](https://xspeedcache.com/agent/claude-cowork/purge-cache/) · [ChatGPT](https://xspeedcache.com/agent/chatgpt/purge-cache/) · [Codex](https://xspeedcache.com/agent/codex/purge-cache/) · [Cursor](https://xspeedcache.com/agent/cursor/purge-cache/) · [GitHub Copilot in VS Code](https://xspeedcache.com/agent/github-copilot/purge-cache/) · [Windsurf](https://xspeedcache.com/agent/windsurf/purge-cache/) · [Gemini CLI](https://xspeedcache.com/agent/gemini-cli/purge-cache/) · [Zed](https://xspeedcache.com/agent/zed/purge-cache/) · [Kiro](https://xspeedcache.com/agent/kiro/purge-cache/) · [OpenCode](https://xspeedcache.com/agent/opencode/purge-cache/) · [OpenClaw](https://xspeedcache.com/agent/openclaw/purge-cache/) · [Hermes Agent](https://xspeedcache.com/agent/hermes-agent/purge-cache/) · [Grok Build](https://xspeedcache.com/agent/grok-build/purge-cache/) · [ChatGPT dots](https://xspeedcache.com/agent/chatgpt-dots/purge-cache/) · [Grok](https://xspeedcache.com/agent/grok/purge-cache/) · [Grok Bot](https://xspeedcache.com/agent/grok-bot/purge-cache/) · [Muse](https://xspeedcache.com/agent/muse/purge-cache/) · [Manus](https://xspeedcache.com/agent/manus/purge-cache/) · [Kimi Code](https://xspeedcache.com/agent/kimi/purge-cache/) · [Paperclip](https://xspeedcache.com/agent/paperclip/purge-cache/) · [NanoClaw](https://xspeedcache.com/agent/nanoclaw/purge-cache/)

## More with Antigravity

- [Find out why WordPress pages are not cached with Antigravity](https://xspeedcache.com/agent/antigravity/troubleshoot-cache/)
- [Scan a website for speed problems with Antigravity](https://xspeedcache.com/agent/antigravity/speed-scan/)
- [Run and track PageSpeed tests with Antigravity](https://xspeedcache.com/agent/antigravity/pagespeed-tests/)
- [Raise a WordPress site's PageSpeed score with Antigravity](https://xspeedcache.com/agent/antigravity/optimize-site/)
- [Tune WordPress cache settings with Antigravity](https://xspeedcache.com/agent/antigravity/cache-settings/)
- [Warm the WordPress cache with Antigravity](https://xspeedcache.com/agent/antigravity/preload-cache/)
- [Set up the Redis object cache with Antigravity](https://xspeedcache.com/agent/antigravity/object-cache/)
- [Manage Cloudflare caching with Antigravity](https://xspeedcache.com/agent/antigravity/cloudflare/)
- [Manage every WordPress site at once with Antigravity](https://xspeedcache.com/agent/antigravity/fleet/)

## Documentation

- How to enable Page Cache: https://xspeedcache.com/docs/page-cache/
- How to warm your cache ahead of visitors: https://xspeedcache.com/docs/preloader/
- Managing your fleet with xSpeed Hub: https://xspeedcache.com/docs/managing-your-fleet-with-xspeed-hub/