BetterGravity

The open community modification platform for Google Antigravity.

Drop in a .css file and the interface restyles instantly. Write a plugin in plain JavaScript with no build step. Experience a revamped UI, animated desktop companions, in-app browser with autonomous computer use, personal Gemini API keys, and Discord Rich Presence.

Install · Make a theme · Make a plugin · How it works · Community catalog

What BetterGravity unlocks

BetterGravity is both an extensible modification platform and a curated suite of power-user capabilities built directly into Antigravity.

🎨 Revamped Gemini Workspace

Restyled with the clean Willow design system, dedicated sidebar navigation (Chat, Work, Skills, Scheduled Tasks, and Pets), refined typography, and distraction-free conversation layouts.

🐾 Interactive Desktop Companions

Choose from 17+ desktop companions, generate custom animated pixel pets with Gemini, or watch them cheer, idle, and code alongside your agent in real time.

🌐 In-App Browser & Autonomous Computer Use

Test web applications, inspect live DOM trees, and let your agent browse the web or drive mouse and keyboard interactions autonomously without leaving Antigravity.

🔑 Bring Your Own Gemini Key & 🎮 Discord Rich Presence

Platform features

Install

Windows, macOS & Linux, Antigravity 2.x.

Download the installer from releases, run it, and press Install.

Enabling features & plugins

Once installed, BetterGravity adds its own dedicated menu inside Antigravity:

1. Open Antigravity and click Settings (gear icon in the bottom-left corner).
2. In the settings sidebar, scroll down to the BetterGravity section.
3. Click Plugins to toggle on your preferred capabilities:
   • Gemini App — Willow UI workspace redesign with dedicated tabs (Chat, Work, Skills, Scheduled Tasks).
   • Pets — Desktop companions & interactive manager.
   • In-App Browser & Computer Use — Autonomous web browsing and UI automation.
   • Bring Your Own Gemini Key — Bypass quotas with custom API keys and thinking token pass-through.
   • Discord Rich Presence — Live agent status in Discord.
4. Click Themes to switch styles or drag-and-drop custom .css stylesheets.

🛡️ Safety & Reversibility:

• Backups are created automatically before any patch is applied.
• Uninstalling restores your original Antigravity installation byte for byte.
• Never touches your local repositories, workspace code, or credentials.

Full instructions and troubleshooting are in the installation guide.

A theme in ten seconds

/**
 * @name Neon
 * @author you
 */

:root {
  --primary: #22d3ee !important;
  --background: #16091f !important;
}

[data-testid="agent-input-box"] {
  border: 2px solid #7c5cff !important;
  border-radius: 18px !important;
}

Drop it on the BetterGravity settings page, or put it in the themes folder. Switch it on.

!important matters: Antigravity applies its theme as inline custom properties, so ordinary rules lose. The theme guide explains what else is reachable, including how to replace the app's own animations.

A plugin in twenty

plugin.log.info("started");

const settings = plugin.settings.define({
  greeting: { type: "string", label: "Greeting", default: "Hello" }
});

plugin.dom.observe('[data-testid="conversation-row-sidebar"]', (row) => {
  row.title = settings.greeting;
});

With a plugin.json beside it, that is a complete plugin. Turn on developer mode, switch it on, and editing the file reloads it live.

Plain JavaScript gets full type checking and editor completion by copying one globals.d.ts — no TypeScript required. See making a plugin.

How it works

Antigravity is not a normal Electron app, and that shapes everything here. Its app.asar is a small launcher: it starts a native language server and points a window at https://127.0.0.1:<port>, so the entire interface is a web app served over loopback. There are no UI files on disk to patch.

So BetterGravity injects at runtime instead. The installer swaps app.asar for a small bootstrap and keeps the original as _app.asar. The bootstrap restores Antigravity's identity, starts the BetterGravity runtime, and hands control to the original entry point. If anything in the runtime fails, it is caught and Antigravity starts exactly as it would without BetterGravity.

Nothing you install can stop your editor from opening.

Architecture goes into detail.

Safety

The installer is privileged code that modifies an application on your machine. It keeps timestamped backups, verifies every step, refuses host versions it has not been tested against, and never deletes your content.

Plugins are the opposite: untrusted code running in the same page as your source and credentials. Plugin loading is off until you turn on developer mode, and the settings page says exactly why. Themes are plain CSS and carry no such risk, so they load freely.

Found a vulnerability? See the security policy.

Repository

apps/installer          The Windows installer: Electron shell and its UI
packages/patcher        Patching, verification, uninstall, update guardian
packages/runtime        The layer that runs inside Antigravity
packages/plugin-api     The public contract plugins are written against
packages/theme-api      Theme metadata format
packages/marketplace    Submission rules and the catalog shape
packages/shared         Version constants and shared types
community/              Submitted themes and plugins, and the catalog
examples/               A reference plugin, type-checked in CI
docs/                   Everything above, in detail

Development

Node.js 22+ and pnpm 10+.

pnpm install
pnpm check     # verify structure, typecheck, build, and test
pnpm dev       # the installer UI in a browser, against a safe preview patcher

pnpm dev never touches Antigravity. To work against a real installation, and for the DevTools-protocol harness used to develop the injected UI, see contributing.

Sharing what you make

Themes and plugins are submitted to community/ as pull requests, reviewed, and indexed into a [catalog](commun