@minhspark/codex-mcp-bridge 1.23.0 → 1.24.1

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-mcp-bridge",
-  "version": "1.23.0",
+  "version": "1.24.1",
   "description": "Connect ChatGPT to your own Codex Desktop projects and conversations.",
   "author": {
     "name": "Bui Dang Minh"

package/CHANGELOG.md

@@ -4,6 +4,38 @@ Follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and [SemVer](ht
 
 ## [Unreleased]
 
+## [1.24.1] - 2026-10-29
+
+### Fixed
+
+- Native Codex turns whose `root_turn_id` names a different causal root are no longer rejected as contradictory. Membership comes from explicit turn IDs, contradictory explicit IDs are still rejected, and a turn is never selected only because its causal root matches the requested turn (#169, #171 by @deinspanjer).
+- An accepted Desktop send whose response cannot be verified now reports `status: observation_unavailable` with `nextAction: inspect_existing_task` and the original receipt, instead of `failed`. Desktop's own `failed` or `interrupted` status is still reported when it belongs to the exact observed turn. `wait_codex_reply` with `responsePreferences` returns the same next action plus `guidance` telling the caller not to resend the prompt.
+- When a Claude reply observation is interrupted by a new input boundary after an asynchronous or timed-out `send_to_claude_session`, the bridge now publishes a correlated bridge-status notification to `read_claude_inbox` and to the originating Codex task. It is labelled as a bridge notification rather than a Claude reply, keeps the original account and project scope, reports outcome unknown, task not cancelled and retry unsafe, and survives reload without duplication. Asynchronous send guidance now points to `read_claude_delivery` (#170, #172 by @deinspanjer).
+
+### Upgrade
+
+- `npm install -g @minhspark/codex-mcp-bridge@latest`, then restart Claude Desktop and Codex Desktop (or reconnect their MCP servers) so running bridges load 1.24.1.
+
+## [1.24.0] - 2026-10-28
+
+### Added
+
+- Optional Antigravity MCP bridge for verified Codex and Claude Desktop callers. Select an exact existing Antigravity App conversation or explicitly create a bridge-owned CLI streaming session in the same project directory.
+- Native App sidecar transport with current-user socket access, native workspace/project checks, busy-recipient protection, and durable request receipts. CLI streaming validates native conversation identity and preserves permission review; results and uncertain outcomes are recorded without automatic resends.
+- `antigravity-mcp-bridge-install` configures Codex, Claude, and the App sidecar independently or together, previews changes with `--dry-run`, preserves unrelated configuration, and removes only its own registrations.
+- Antigravity Desktop's `agent-bridge` MCP can discover, read, and send to existing Codex Desktop tasks and live Claude Desktop Code sessions in the same project. Native per-call sender metadata, process ancestry, project configuration, and permission checks preserve Antigravity authorship and recipient policy.
+- Sidecars track their native parent process identity and exit when that parent stops, preventing a restarted App from retaining an orphan's stale connection. Desktop callers without workspace metadata resolve their directory through exact native conversation and project evidence.
+
+### Compatibility
+
+- Node.js 22.13 or newer is required for read-only native conversation discovery. The App adapter filters mirrored CLI records rather than trusting the database directory alone.
+- App receipts report native acceptance; App response forwarding and creation are not implemented. CLI support uses bridge-owned headless sessions, not attachment to existing interactive terminals. Antigravity outbound is Desktop-only; nested callers and Linux host verification are unsupported. Claude socket writes remain unconfirmed until a native receipt or reply is observed.
+
+### Verification
+
+- Automated coverage includes real MCP transports, caller identity, project scope, current-user pipe access, duplicate requests, native metadata, recipient permission checks, durable receipt states, stream protocol failures, installer preservation, and file replacement during reads.
+- Live Windows verification covered CLI streaming under native `request-review` permissions and both directions between Codex and Antigravity Desktop. The App replied `ANTIGRAVITY_DESKTOP_NATIVE_OK`; its outbound MCP delivered `ANTIGRAVITY_TO_CODEX_DESKTOP_OK` to the exact originating Codex task. Claude outbound routing has automated coverage; a live Claude receiver was unavailable during verification.
+
 ## [1.23.0] - 2026-10-26
 
 ### Added

package/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="assets/agent-pets.svg" width="144" height="52" alt="Claude Clawd → Codex; Codex → Claude" />
+  <img src="assets/agent-pets.svg" width="240" height="220" alt="Claude, Codex, and Antigravity connected by curved two-way arrows" />
 </p>
 
 <h1 align="center">codex-mcp-bridge</h1>
@@ -15,17 +15,33 @@
   <a href="LICENSE"><img src="https://img.shields.io/npm/l/@minhspark/codex-mcp-bridge" height="20" alt="license" /></a>
 </p>
 
-Send prompts and replies between **Claude and Codex**, keeping each conversation in its own app. Supports Windows, macOS, and Linux; native Desktop integration supports Windows and macOS.
+Connect **Claude, Codex, and Antigravity** through MCP, keeping work in each agent's own app and preserving native identity and permission checks. Supports Windows, macOS, and Linux; native Desktop integration supports Windows and macOS.
+
+The optional **Antigravity bridge** sends work both ways between existing Desktop conversations in the same project. Codex and Claude can also start and continue bridge-owned Antigravity CLI streaming sessions. Antigravity App replies remain in the App; outbound calls from Antigravity CLI are not supported. [Setup and current limits](#antigravity-app-and-cli).
 
 https://github.com/user-attachments/assets/98b23989-826f-4d7d-9dcb-ad7dd2739095
 
 ## Installation
 
+Install the bridge package first, then follow the setup for the apps you use. The optional [workflow skill](#workflow-skill--npx-skills) has its own install commands; installing it does not register or start an MCP server.
+
+### Package — npm
+
+**macOS / Linux / WSL**
+
 ```bash
 npm install -g @minhspark/codex-mcp-bridge@latest
 ```
 
-Requires **Node.js 22+**. In Windows PowerShell, use `npm.cmd` instead of `npm`. Run the same command to update; reconnect MCP servers if their settings or installation paths changed.
+**Windows PowerShell**
+
+```powershell
+npm.cmd install -g @minhspark/codex-mcp-bridge@latest
+```
+
+Requires **Node.js 22.13+**. Use `.cmd` for this package's commands in Windows PowerShell. Run the same package command to update; reconnect MCP servers if their settings or installation paths changed.
+
+### Package — Homebrew
 
 On macOS or Linux you can install with [Homebrew](https://github.com/buidangminh23/homebrew-tap) instead, which brings its own Node.js:
 
@@ -33,9 +49,87 @@ On macOS or Linux you can install with [Homebrew](https://github.com/buidangminh
 brew install buidangminh23/tap/codex-mcp-bridge
 ```
 
-Update with `brew upgrade codex-mcp-bridge`. The installers record Homebrew's stable `opt` paths, so registrations keep working after an upgrade and running bridges reload the new version. Keep one install channel: whichever of npm or Homebrew comes first on `PATH` provides the commands.
+**Homebrew — update**
+
+```bash
+brew upgrade codex-mcp-bridge
+```
+
+The installers record Homebrew's stable `opt` paths, so registrations keep working after an upgrade and running bridges reload the new version. Keep one install channel: whichever of npm or Homebrew comes first on `PATH` provides the commands.
+
+[Windows](#windows-powershell) · [macOS](#macos-terminal) · [Claude Code](#register-claude-code) · [Antigravity](#antigravity-app-and-cli) · [VS Code](#vs-code-extensions--windows-preview) · [Linux / WSL](#linux--wsl-bash) · [NPX Skills](#workflow-skill--npx-skills) · [ChatGPT plugin](#chatgpt-plugin)
+
+| Integration | Setup |
+| --- | --- |
+| Claude Desktop Code → Codex Desktop | Native relay plus user-level `claude mcp add` registration below |
+| Claude Code CLI → local Codex app-server | CLI registration with Desktop mode disabled |
+| Claude Desktop shared MCP → local Codex app-server | Optional legacy registration below |
+| Codex → Claude Desktop Code | `claude-mcp-bridge-install` with `CODEX_BRIDGE_DESKTOP_TASKS=1` |
+| Codex / Claude Desktop Code → Antigravity App or CLI | Antigravity `--codex` / `--claude` registrations |
+| Antigravity App → Codex / Claude Desktop Code | Antigravity `--desktop` registration |
+| Claude Code ↔ Codex inside VS Code | Separate Windows preview registrations below |
+| ChatGPT → paired Codex Desktop | Hosted plugin plus `codex-sites-connector --pair` |
+
+### Antigravity App and CLI
+
+Install and sign in to the Antigravity App and/or `agy` CLI, then run:
+
+```bash
+antigravity-mcp-bridge-install --all
+```
 
-[Windows](#windows-powershell) · [macOS](#macos-terminal) · [Linux / WSL](#linux--wsl-bash) · [ChatGPT plugin](#chatgpt-plugin)
+**Windows PowerShell — all components**
+
+```powershell
+antigravity-mcp-bridge-install.cmd --all
+```
+
+**Codex → Antigravity App / CLI**
+
+```bash
+antigravity-mcp-bridge-install --codex
+```
+
+**Claude Desktop Code → Antigravity App / CLI**
+
+```bash
+antigravity-mcp-bridge-install --claude
+```
+
+**Antigravity App sidecar and outbound bridge**
+
+```bash
+antigravity-mcp-bridge-install --desktop
+```
+
+**Preview the installation without changing configuration**
+
+```bash
+antigravity-mcp-bridge-install --all --dry-run
+```
+
+Use `.cmd` for each command on Windows. `--all` includes all three components; the individual commands are alternatives when only some clients are needed. The installer preserves unrelated configuration and native permissions. Reload Codex/Claude to load the new MCP server. Antigravity launches its own sidecar from `~/.gemini/config/sidecars/codex-bridge/sidecar.json`; do not run that sidecar manually or copy authentication environment variables between processes.
+
+The `agy` CLI must be installed and signed in separately. CLI sessions are started through the `start_antigravity_cli_session` MCP tool; there is no separate `--cli` installer flag. Set `ANTIGRAVITY_CLI_BIN` to the absolute `agy` executable path in the MCP server environment if automatic discovery cannot find it.
+
+| Tool | Behavior |
+| --- | --- |
+| `antigravity_bridge_status` | Reports native sidecar connectivity and CLI capabilities. |
+| `list_antigravity_conversations` | Lists the selected surface in the verified sender's exact project directory. |
+| `send_to_antigravity_conversation` | Sends to an exact existing App conversation or a CLI session owned by this bridge. |
+| `start_antigravity_cli_session` | Starts an explicitly authorized CLI streaming session with its initial prompt. |
+| `read_antigravity_delivery` | Reads the original receipt without resending. |
+| `close_antigravity_cli_session` | Closes an idle CLI session owned by the sender. |
+
+Generate a new `requestId` UUID for each intentional delivery and reuse it only when inspecting or retrying that same delivery. A pending or unknown receipt must be inspected before further action. Receipts survive process restarts; live CLI processes do not. A CLI timeout retains its conversation identity for inspection. No mode or permission-bypass flag is added; headless tool requests requiring interaction may be denied by Antigravity.
+
+The App adapter uses the official [sidecar `agentapi`](https://antigravity.google/docs/sidecars), verifies native workspace metadata, and refuses busy or ambiguous destinations. An App `accepted` receipt confirms native acceptance, not a completed agent reply. Open the exact App conversation to read its response. The CLI adapter uses the official [streaming JSON interface](https://antigravity.google/docs/cli/headless) and returns the agent's final result. It creates bridge-owned headless sessions; it does not attach to an already running interactive terminal. The two surfaces never substitute for one another.
+
+The installer also registers **agent-bridge inside Antigravity Desktop** in `~/.gemini/config/mcp_config.json`. Reload the App after installation to discover it. From an Antigravity conversation, ask the agent to check `agent_bridge_status`, call `list_agent_tasks` for `codex` or `claude`, then use `send_to_agent_task` with the exact destination ID, project directory, prompt, and a fresh request UUID. Claude destinations also require their native `taskId`. Read `read_agent_delivery` without resending; `read_agent_task` reads the selected Codex task's response or Claude's native task metadata.
+
+Outbound calls verify Antigravity's per-call MCP metadata, Desktop process ancestry, native workspace/project, and effective permission settings. The sender is attributed as Antigravity. Codex keeps its native task settings; Claude's inbound policy and permission-class checks remain in effect. A socket write to Claude is `sent_unconfirmed`, not acceptance or completion. After MCP restart, a saved receipt remains available but live Claude reply tracking may be unavailable; inspect the exact native task before further action.
+
+Outbound support targets existing local Codex tasks and live Claude Desktop Code sessions in the same project. Nested Antigravity callers, outbound CLI callers, App conversation creation, and automatic App reply forwarding are not implemented. Windows Desktop is the live verification platform; macOS ancestry has unit coverage and Linux outbound host verification fails closed. The existing Codex↔Claude bridge remains separate. Use `antigravity-mcp-bridge-install --all --remove` to remove only these registrations; delivery receipts are retained.
 
 ### Windows (PowerShell)
 
@@ -46,7 +140,6 @@ If the Codex CLI is missing, run `winget install --id OpenAI.Codex --exact`, ope
 ```powershell
 $env:CODEX_EXE = (Get-Command codex.exe).Source
 codex-native-relay-install.cmd --desktop-tasks
-codex-mcp-bridge-install.cmd --desktop-tasks
 $env:CODEX_BRIDGE_DESKTOP_TASKS = "1"
 claude-mcp-bridge-install.cmd
 ```
@@ -61,7 +154,6 @@ Install and sign in to Codex Desktop and Claude Desktop. Save the project in Cod
 npm install -g @openai/codex@latest
 codex login
 codex-native-relay-install --desktop-tasks
-codex-mcp-bridge-install --desktop-tasks
 CODEX_BRIDGE_DESKTOP_TASKS=1 claude-mcp-bridge-install
 ```
 
@@ -71,6 +163,8 @@ Keep bootstrap enabled on the first relay install. Next: [register Claude Code](
 
 Claude Desktop and Claude Code have separate MCP registrations. If `claude --version` is unavailable, [install Claude Code](https://code.claude.com/docs/en/setup) first. For a new registration, replace the example project path below with the actual directory. Preserve custom settings if `codex-bridge` is already registered.
 
+Native Desktop handoffs require a verified Claude Desktop **Code** session. A shared Desktop chat MCP registration cannot establish that sender identity. If you also keep the optional legacy shared registration below, close Claude before editing its `claude_desktop_config.json` and rename that entry from `codex-bridge` to `codex-bridge-desktop`, keeping its contents. Otherwise the shared entry can shadow the user-level Code registration and hide the calling task. Later Desktop installer runs recognize the renamed entry.
+
 <details>
 <summary>Windows PowerShell</summary>
 
@@ -101,19 +195,65 @@ claude mcp add --scope user codex-bridge \
   -- "$(command -v node)" "$bridge_root/src/mcp-supervisor.mjs" index.mjs
 ```
 
-For a Homebrew install, use the stable paths instead of `npm root -g` and `command -v node`:
+For a Homebrew install, use this complete command with stable `opt` paths instead:
 
 ```bash
 bridge_root="$(brew --prefix)/opt/codex-mcp-bridge/libexec/lib/node_modules/@minhspark/codex-mcp-bridge"
 node_bin="$(brew --prefix)/opt/node/bin/node"
+claude mcp add --scope user codex-bridge \
+  -e CODEX_BIN="$(command -v codex)" \
+  -e CODEX_BRIDGE_DESKTOP_TASKS=1 \
+  -e CODEX_BRIDGE_AUTOSTART=0 \
+  -e CODEX_BRIDGE_THREAD_POLICY=roots \
+  -e CODEX_BRIDGE_ALLOWED_ROOTS="$HOME/YourProject" \
+  -- "$node_bin" "$bridge_root/src/mcp-supervisor.mjs" index.mjs
 ```
 
-and end the command with `-- "$node_bin" "$bridge_root/src/mcp-supervisor.mjs" index.mjs`.
-
 </details>
 
 Separate multiple allowed directories with `;` on Windows or `:` on macOS/Linux.
 
+`codex-bridge-code-install` is for checking or migrating an existing supervised Code registration to a shared project policy; it does not replace the first-install commands above. See [project onboarding](docs/project-onboarding.md).
+
+### Claude Desktop shared MCP — legacy option
+
+This optional registration connects a shared Claude Desktop MCP server to local Codex app-server sessions. For verified handoffs into Codex Desktop conversations, use the Code-tab setup above. Install and sign in to the Codex CLI first.
+
+**Windows PowerShell**
+
+```powershell
+$env:CODEX_EXE = (Get-Command codex.exe).Source
+$env:CODEX_BRIDGE_DESKTOP_TASKS = "0"
+$env:CODEX_BRIDGE_AUTOSTART = "1"
+codex-mcp-bridge-install.cmd
+```
+
+**macOS Terminal**
+
+```bash
+CODEX_BRIDGE_DESKTOP_TASKS=0 CODEX_BRIDGE_AUTOSTART=1 codex-mcp-bridge-install
+```
+
+The installer updates Claude Desktop's shared MCP configuration. Close and reopen Claude after configuration changes, and keep a distinct `codex-bridge-desktop` entry name if also using the user-level Code registration. `--desktop-tasks` configures the native destination mode but does not make a shared Desktop chat server a verified Code sender.
+
+### VS Code extensions — Windows preview
+
+For existing Claude Code and Codex extension conversations inside the same VS Code project, register the separate preview bridge in both clients. Install the npm package first and replace the example root with the real project directory. These registrations preserve extension sender checks and do not provide Desktop access.
+
+```powershell
+$bridgeRoot = Join-Path ((npm.cmd root -g).Trim()) '@minhspark/codex-mcp-bridge'
+$nodeBin = (Get-Command node.exe).Source
+$projectRoot = 'C:\Projects\YourProject'
+claude mcp add --scope user codex-vscode-bridge `
+  -e "VSCODE_BRIDGE_ALLOWED_ROOTS=$projectRoot" `
+  -- $nodeBin (Join-Path $bridgeRoot 'src/vscode-bridge.mjs') claude
+codex.exe mcp add claude-vscode-bridge `
+  --env "VSCODE_BRIDGE_ALLOWED_ROOTS=$projectRoot" `
+  -- $nodeBin (Join-Path $bridgeRoot 'src/vscode-bridge.mjs') codex
+```
+
+Reload the VS Code window after registration. Separate multiple explicit project roots with `;`; drive roots are not accepted. See [preview behavior and limits](REFERENCE.md#vs-code-extension-bridge-windows-preview).
+
 ### Native relay pipe forwarding
 
 On Windows and macOS, `codex-native-relay-install` adds this to the relay's entry in `~/.codex/config.toml` (or `$CODEX_HOME/config.toml`) and keeps its other settings:
@@ -127,7 +267,7 @@ If you register the relay by hand, add the same line and append the variable nam
 
 ### Linux / WSL (Bash)
 
-Use Node.js 22+ and signed-in Codex and Claude Code CLIs under the same Linux user. This mode uses a local app-server; native Desktop integration requires Windows or macOS.
+Use Node.js 22.13+ and signed-in Codex and Claude Code CLIs under the same Linux user. This mode uses a local app-server; native Desktop integration requires Windows or macOS.
 
 <details>
 <summary>CLI registration commands</summary>
@@ -150,6 +290,114 @@ Replace `$HOME/YourProject` with the actual project directory. WSL and Windows u
 
 </details>
 
+<details>
+<summary>Linux Homebrew registration commands</summary>
+
+```bash
+npm install -g @openai/codex@latest
+codex login
+CODEX_BRIDGE_DESKTOP_TASKS=0 claude-mcp-bridge-install
+bridge_root="$(brew --prefix)/opt/codex-mcp-bridge/libexec/lib/node_modules/@minhspark/codex-mcp-bridge"
+node_bin="$(brew --prefix)/opt/node/bin/node"
+claude mcp add --scope user codex-bridge \
+  -e CODEX_BIN="$(command -v codex)" \
+  -e CODEX_BRIDGE_DESKTOP_TASKS=0 \
+  -e CODEX_BRIDGE_AUTOSTART=1 \
+  -e CODEX_BRIDGE_THREAD_POLICY=roots \
+  -e CODEX_BRIDGE_ALLOWED_ROOTS="$HOME/YourProject" \
+  -- "$node_bin" "$bridge_root/src/mcp-supervisor.mjs" index.mjs
+```
+
+Replace `$HOME/YourProject` with the actual project directory. The bridge and Node paths remain stable across Homebrew upgrades.
+
+</details>
+
+### Workflow skill — NPX Skills
+
+The repository includes one portable skill, `codex-bridge`, for the [hosted Codex Bridge workflow](#chatgpt-plugin). These commands install its Markdown instructions only. Using the workflow requires a client with the hosted plugin's MCP tools and a paired connector; copying the skill does not install the local bridges, configure authentication, or make a client a supported native sender.
+
+Use a Node.js version supported by the current [Skills CLI](https://github.com/vercel-labs/skills). The examples target the current project; add `-g` for a user-wide install. In Windows PowerShell use `npx.cmd` instead of `npx`.
+
+**NPX Skills — select the workflow skill**
+
+```bash
+npx skills add buidangminh23/codex-mcp-bridge --skill codex-bridge
+```
+
+**List available skills without installing**
+
+```bash
+npx skills add buidangminh23/codex-mcp-bridge --list
+```
+
+**Claude Code**
+
+```bash
+npx skills add buidangminh23/codex-mcp-bridge --skill codex-bridge -a claude-code
+```
+
+**Codex**
+
+```bash
+npx skills add buidangminh23/codex-mcp-bridge --skill codex-bridge -a codex
+```
+
+**Cursor**
+
+```bash
+npx skills add buidangminh23/codex-mcp-bridge --skill codex-bridge -a cursor
+```
+
+**Gemini CLI**
+
+```bash
+npx skills add buidangminh23/codex-mcp-bridge --skill codex-bridge -a gemini-cli
+```
+
+**Antigravity**
+
+```bash
+npx skills add buidangminh23/codex-mcp-bridge --skill codex-bridge -a antigravity
+```
+
+**Antigravity CLI**
+
+```bash
+npx skills add buidangminh23/codex-mcp-bridge --skill codex-bridge -a antigravity-cli
+```
+
+**Cline**
+
+```bash
+npx skills add buidangminh23/codex-mcp-bridge --skill codex-bridge -a cline
+```
+
+**OpenCode**
+
+```bash
+npx skills add buidangminh23/codex-mcp-bridge --skill codex-bridge -a opencode
+```
+
+**All Skills CLI agents — user-wide, without prompts**
+
+```bash
+npx skills add buidangminh23/codex-mcp-bridge --all -g
+```
+
+`--all` installs every skill in the repository for every supported Skills CLI agent, not just detected apps. Choose an individual `-a` command above for a narrower install. Agent names and scope flags follow the [Skills CLI reference](https://github.com/vercel-labs/skills/blob/main/docs/commands.md).
+
+**Legacy `add-skill` command**
+
+```bash
+npx add-skill buidangminh23/codex-mcp-bridge
+```
+
+`add-skill` is deprecated and forwards to `npx skills add`; use the current command above, especially on Windows where the legacy wrapper may fail to find `npx`.
+
+**Marketplace and Gemini extension installs**
+
+This repository ships a hosted ChatGPT plugin and the skill above. It does not currently publish a Claude/Codex marketplace catalog or a `gemini-extension.json` package. Consequently, `/plugin marketplace add`, `codex plugin marketplace add`, and `gemini extensions install` are not installation routes for this repository. Use the native bridge setup, NPX skill commands, or [hosted plugin setup](#chatgpt-plugin) as appropriate.
+
 ### Verify the installation
 
 Reconnect the affected MCP servers in the actual client tasks; Claude Code provides `/mcp`. Run these **MCP tools** inside the apps:
@@ -159,6 +407,16 @@ Reconnect the affected MCP servers in the actual client tasks; Claude Code provi
 | Claude Code | `codex_bridge_status` |
 | Codex | `claude_bridge_status` |
 | Codex Desktop | `native_relay_status` |
+| Codex / Claude Desktop Code with Antigravity installed | `antigravity_bridge_status` |
+
+To check CLI registrations without sending work:
+
+```bash
+codex mcp list
+claude mcp list
+```
+
+On Windows use `codex.exe mcp list`. An installed skill is listed separately with `npx skills list` (add `-g` for user-wide skills); it is not an MCP registration.
 
 Send a short message and confirm its reply **in both directions**. Registration alone does not prove delivery.
 

package/assets/README.md

@@ -1,9 +1,10 @@
 # Artwork sources
 
-`agent-pets.svg` pairs Claude Clawd and the original Codex companion with a right arrow above a left arrow. The artwork preserves each mascot's colors and proportions.
+`agent-pets.svg` places Claude Clawd, the original Codex companion, and the official Google Antigravity logo around a circle, connected by curved two-way arrows. The artwork preserves the original colors and proportions of all three marks.
 
 - Claude Clawd: `ClaudeCode` vector from [LobeHub Icons](https://github.com/lobehub/lobe-icons), copied from the `icons-pro-max` asset catalog. Copyright (c) 2023 LobeHub; MIT license below.
 - Codex companion: original idle frame from OpenAI's Codex desktop companion artwork (`codex-spritesheet-v6`, cell 0,0, 192 × 208 pixels). Copyright OpenAI. This third-party artwork and the represented trademarks are not covered by this repository's MIT license.
+- Antigravity: original vector mark from the [official Google Antigravity favicon](https://www.antigravity.google/favicon.svg), retrieved October 28, 2026. The favicon background is omitted; the logo paths, colors, masks, and filters are preserved. Copyright Google. This third-party artwork and the represented trademarks are not covered by this repository's MIT license.
 
 ## LobeHub Icons license