Find your next open-source project

Search by name, purpose, or keyword — or paste a GitHub repository URL

nkjDSLcvanv/antigravity-codex-theme

System Tools

Adds Codex light/dark themes, Chinese UI, and live token telemetry to Google Antigravity without modifying the app bundle.

This project ships 1 agent skillsSkill list and install →
114
6
JavaScript
MIT
4 days old

What it does

This is a local injection plugin for Google Antigravity that adds a Codex-style light theme (codex-pure-white) and dark theme (codex-dark), a Chinese UI dictionary of 1,900+ entries, and a live session telemetry layer. According to the README, it deploys to ~/.gemini/antigravity/codex-theme and talks to the running IDE over a local DevTools port, so the Antigravity installation package itself is not modified README.

The telemetry part shows four session states (ready, running, waiting/retrying, error) in the bottom toolbar and in per-turn footers, with two levels of usage panels and a hover breakdown card README. It reports token speed, context occupancy, cache hit rate, TTFT, and per-turn input/output splits.

Requirements and installation

Before installing, you need Node.js >= 22.13.0 and Google Antigravity 2.30.x to 2.34.0+, and the installer has been tested on macOS, Windows, and Linux desktops package.json.

The basic CLI flow is:

git clone https://github.com/nkjDSLcvanv/antigravity-codex-theme.git
cd antigravity-codex-theme
node install.mjs install
node --disable-warning=ExperimentalWarning install.mjs doctor

doctor checks the Node version, Antigravity version, CDP status, core/manifest.json hashes, and whether the runtime was mounted README. If Antigravity was already running without a debug port, restart it or run node install.mjs relaunch.

As of Antigravity 2.33.0+, the app no longer leaves a local DevToolsActivePort file open by default, so Antigravity must be launched with --remote-debugging-port=0. The project handles this via a cold-start relay on macOS and edits to shortcuts or .desktop entries on Windows and Linux README.

Selective install and customization

You can install only what you need with --only; the four module groups are theme, i18n, metrics, and fixes:

node install.mjs install --only i18n,metrics

Personal settings live under ~/.gemini/antigravity/codex-theme/user/ and survive upgrades. config.json controls the preset, telemetryLayout (compact or detailed), cache mode, and module toggles; i18n.override.json adds translations; custom.css and custom.js inject further styling or scripts config.json README. Changes are hot-reloaded into open windows in about 2.5 seconds.

If you change files under core/, regenerate the manifest and rerun checks:

node install.mjs build-manifest && npm run check && npm test && node install.mjs install

Uninstall and limits

node install.mjs uninstall stops the background service, removes autostart entries and launch arguments, and restores the default English UI and native theme. It intentionally keeps the user/ config directory, backups, and the remote-debugging-port field written into ~/.antigravity/argv.json, so a true cleanup requires deleting those manually README.

The plugin is tied to a specific range of Antigravity versions, and the CDP relay behavior changed with 2.33.0+, so upgrades in the host app can break injection until the project catches up. The README describes the setup as verified on macOS, Windows, and Linux, with unit tests and CI syntax checks covering core logic CI workflow.

HotRepo's take

The project entered HotRepo's new-project list on 2026-11-21 with 107 stars total and 7 stars gained over a roughly 1.5-hour measurement window, plus one fork. That record shows early attention from people already using Antigravity 2.33+ who need a Chinese UI or token visibility, rather than a broadly popular tool. The README's focus on module-level installation and backups is useful, but the dependency on an undocumented host app and local debug port is the main thing to weigh before installing.

Written by AI from the project's public information and HotRepo's records, updated . The project's own docs are the source of truth.

You might also like

  1. confeden/AntigravityLets a Google account from a blocked region use Antigravity coding tools without a VPN or region change.Rust1,029
  2. lbjlaq/Antigravity-ManagerDesktop and Docker tool that manages multiple AI service accounts and exposes them as OpenAI, Anthropic and Gemini-compatible API endpoints.Rust33,364
  3. vinceliuice/MacTahoe-gtk-themeA macOS Tahoe-style GTK theme for Linux desktops, with importable installer and tweak scripts.SCSS1,717
  4. jlcodes99/cockpit-toolsDesktop app for managing multiple accounts across AI IDEs and coding CLIs, with quota monitoring and parallel instances.Rust20,064
  5. INK-Q/agy-fastAn MCP plugin that batches tool calls and injects a startup snapshot to cut Antigravity's LLM turns, token use and latency.TypeScript122