{"_id":"@bamoo456/antigravity-acp","_rev":"2-d52fe9d7b6f7f27323f5e9b8a0e08abc","name":"@bamoo456/antigravity-acp","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.0":{"name":"@bamoo456/antigravity-acp","version":"0.1.0","keywords":["acp","agent-client-protocol","antigravity","agy","google"],"license":"MIT","_id":"@bamoo456/antigravity-acp@0.1.0","maintainers":[{"name":"bamoo456","email":"bamoo456@gmail.com"}],"homepage":"https://github.com/bamoo456/antigravity-acp#readme","bugs":{"url":"https://github.com/bamoo456/antigravity-acp/issues"},"os":["darwin","linux","win32"],"bin":{"agy-acp-server":"bin.mjs","antigravity-acp":"bin.mjs"},"cpu":["arm64","x64"],"dist":{"shasum":"6f2743840630e0100faf6e4ea1597dfcc591109f","tarball":"https://registry.npmjs.org/@bamoo456/antigravity-acp/-/antigravity-acp-0.1.0.tgz","fileCount":9,"integrity":"sha512-IVXYoweO6VVZqavmu3lJPTPUk9A6mhD23wUiDGROYMJ1+ImSgjFEegXAFz3G6tHlHZ746SNMolKhItxhL4ISSg==","signatures":[{"sig":"MEUCIF27dDsYwmdpf0f4TNMKyvc4prSsV8/H4ZjbkiGVN6Y9AiEA590XNTJrRC7N7r86rvk4LTIrQO6cAhNIwX+dsNgtqRc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":31401},"type":"module","engines":{"node":">=20"},"gitHead":"579acdf887d92a03baff0adca61235df197a9cdd","scripts":{"test":"node --test test/unzip.test.mjs && node test/smoke.mjs","postinstall":"node install.mjs"},"_npmUser":{"name":"bamoo456","email":"bamoo456@gmail.com"},"repository":{"url":"git+https://github.com/bamoo456/antigravity-acp.git","type":"git"},"_npmVersion":"10.9.8","description":"Google's official Antigravity ACP server (agy_acp_server), fetched for your platform on install. A drop-in ACP agent for Zed, cloud-acp-gateway, or any ACP client.","directories":{},"_nodeVersion":"22.23.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/antigravity-acp_0.1.0_1788851023667_0.2241258372262187","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"os":["darwin","linux","win32"],"_id":"@bamoo456/antigravity-acp@0.1.1","bin":{"agy-acp-server":"bin.mjs","antigravity-acp":"bin.mjs"},"cpu":["arm64","x64"],"bugs":{"url":"https://github.com/bamoo456/antigravity-acp/issues"},"dist":{"shasum":"cdfe3e409128690e76d8fabbf7cc7715503d948a","tarball":"https://registry.npmjs.org/@bamoo456/antigravity-acp/-/antigravity-acp-0.1.1.tgz","fileCount":9,"integrity":"sha512-6L3tNZThV3g4c0CtwJayPXqU8DsMKKAwhx0VVd3N6+YKYbPyWwUj6e891sKy5KcXxiVcL5g3gcG2sz2xT1Rf7Q==","signatures":[{"sig":"MEUCIQCQ/HFvulpj/vvs0G4fGz6YPXUKFnOmr7Dq3KObsvsXjAIgQQuCoyzp+Pu6qAfPqeVlv5mNm+zbiPhOXJdz0u1YLko=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCKgadSWymjslLDQghX86+ddMNmWNZ53oai4nS7iWAg8AIgFGsLF9Vm757ljehVCZNSSWBE/7RaoTZoKUfWRDG34ho="}],"unpackedSize":33638},"name":"@bamoo456/antigravity-acp","type":"module","engines":{"node":">=20"},"gitHead":"7f1985ffe32bd7f591166d9f90ae32d10f09cf2f","license":"MIT","scripts":{"test":"node --test test/unzip.test.mjs && node test/smoke.mjs","postinstall":"node install.mjs"},"version":"0.1.1","_npmUser":{"name":"bamoo456","email":"bamoo456@gmail.com"},"homepage":"https://github.com/bamoo456/antigravity-acp#readme","keywords":["acp","agent-client-protocol","antigravity","agy","google"],"repository":{"url":"git+https://github.com/bamoo456/antigravity-acp.git","type":"git"},"_npmVersion":"10.9.8","description":"Unofficial npm installer and launcher for Google's Antigravity ACP server (agy_acp_server), downloaded for the current platform at install time.","directories":{},"maintainers":[{"name":"bamoo456","email":"bamoo456@gmail.com"}],"_nodeVersion":"22.23.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/antigravity-acp_0.1.1_1788852424685_0.08624689959386433"}}},"time":{"created":"2026-09-08T07:03:43.384Z","modified":"2026-09-08T07:27:04.947Z","0.1.0":"2026-09-08T07:03:43.801Z","0.1.1":"2026-09-08T07:27:04.767Z"},"bugs":{"url":"https://github.com/bamoo456/antigravity-acp/issues"},"license":"MIT","homepage":"https://github.com/bamoo456/antigravity-acp#readme","keywords":["acp","agent-client-protocol","antigravity","agy","google"],"repository":{"url":"git+https://github.com/bamoo456/antigravity-acp.git","type":"git"},"description":"Unofficial npm installer and launcher for Google's Antigravity ACP server (agy_acp_server), downloaded for the current platform at install time.","maintainers":[{"name":"bamoo456","email":"bamoo456@gmail.com"}],"readme":"# @bamoo456/antigravity-acp\n\nUnofficial npm installer and launcher for Google's Antigravity ACP server\n(`agy_acp_server`). This package is independently maintained and is **not\naffiliated with, endorsed by, or sponsored by Google LLC**.\n\nNothing is reimplemented here: the package downloads Google's published binary\nfor the current platform and runs it on stdio, so an ACP client can spawn it the\nsame way it spawns `claude-agent-acp` or `codex-acp`.\n\n```sh\nnpm install @bamoo456/antigravity-acp\n```\n\n## ⚠️ Google Antigravity Terms of Service\n\nGoogle's current Antigravity Terms state that using third-party software, tools,\nor services to access Antigravity — including through Antigravity OAuth — is a\nbreach of the agreement and may result in account suspension or termination.\n\nThat means using this package with an Antigravity login from Zed,\n`cloud-acp-gateway`, or another third-party ACP client may fall within Google's\nstated restriction.\n\nGoogle's FAQ recommends using a Vertex AI or AI Studio API key when using a\nthird-party coding agent with Gemini. Enterprise and Google Cloud usage may be\nsubject to different applicable terms.\n\nSee:\n\n- <https://antigravity.google/terms>\n- <https://antigravity.google/docs/faq/>\n\nThis package does not bypass authentication or provide Google credentials. It\nonly downloads and launches Google's published ACP server binary. You are\nresponsible for ensuring that your authentication method and use comply with the\nterms that apply to your account.\n\n```jsonc\n// cloud-acp-gateway — agents.json\n{ \"antigravity\": { \"cmd\": \"node_modules/.bin/antigravity-acp\", \"args\": [], \"cwd\": \"/workspace\" } }\n```\n\n```jsonc\n// Zed — settings.json\n{ \"agent_servers\": { \"Antigravity\": { \"type\": \"custom\", \"command\": \"npx\", \"args\": [\"-y\", \"@bamoo456/antigravity-acp\"] } } }\n```\n\n## Why this exists\n\nGoogle publishes the ACP server as a per-platform zip listed in the\n[ACP registry](https://github.com/agentclientprotocol/registry/blob/main/antigravity-acp/agent.json),\nnot on npm. Consuming it directly means every host has to download the right\narchive, unpack it somewhere, and pass the right arguments — and the arguments\ndiffer by platform:\n\n| platform | binary | args | download | unpacked |\n| --- | --- | --- | --- | --- |\n| `darwin-arm64` | `agy_acp_server.par` | — | 301 MB | 876 MB |\n| `linux-x64` | `agy_acp_server.par` | `--uid=` | 650 MB | **1.9 GB** |\n| `linux-arm64` | `agy_acp_server.par` | `--uid=` | 626 MB | **1.8 GB** |\n| `win32-x64` | `agy_acp_server.exe` | — | 447 MB | 536 MB |\n| `win32-arm64` | `agy_acp_server.exe` | — | 447 MB | 532 MB |\n\nMiss `--uid=` on Linux and you have a puzzle, not an error message. This package\nkeeps that table in one place ([`releases.json`](releases.json)) and hides it\nbehind one command name.\n\nThere is no `darwin-x64` build — Google publishes none.\n\n## What the install does\n\n1. Downloads the archive for `${process.platform}-${process.arch}` over HTTPS\n   from `dl.google.com`.\n2. **Verifies its SHA-256** against the digest pinned in `releases.json`, and\n   refuses to install on a mismatch. The ACP registry publishes no digest for\n   this agent, so these were measured here against the published archives — this\n   check is the one thing you get that consuming the registry directly does not.\n3. Unpacks it with a small built-in zip reader (`unzip.mjs`) and checks each\n   entry's CRC-32. No `unzip` binary needed, which matters in slim container\n   images that don't ship one and where GNU `tar` cannot read zip.\n4. Writes `vendor/.installed.json` last, so an interrupted download is never\n   mistaken for a finished install.\n\n`bin.mjs` installs on first run too, so `npm ci --ignore-scripts` still works —\nthe first start is just slow.\n\n### Environment\n\n| variable | effect |\n| --- | --- |\n| `ANTIGRAVITY_ACP_DIR` | where the binary is unpacked (default: `vendor/` inside the package) |\n| `ANTIGRAVITY_ACP_STRICT_INSTALL` | make a failed `postinstall` fail `npm install` instead of deferring to first run |\n| `GEMINI_HOME` | where the server keeps credentials and settings (default `~/.gemini`) |\n\n## Authentication\n\nThe server authenticates **over ACP** — no CLI login step, and it does not use\nthe `agy` CLI's credentials. Its `initialize` reply advertises:\n\n```\noauth-personal   Log in with Google\noauth-business   Log in with Gemini Enterprise\ngemini-api-key   Use an API key with Gemini Developer API\nagent-platform   Gemini Enterprise Agent Platform (ADC or API key)\n```\n\nA client picks one and calls ACP `authenticate`. Credentials land under\n`$GEMINI_HOME` (`~/.gemini/antigravity-acp/`). A client that has no\n`authenticate` support cannot log this agent in — running `agy login` will not\nhelp, because there is no such subcommand and the CLI's keyring is not what this\nserver reads.\n\nBefore using `oauth-personal` or another Antigravity login through a third-party\nACP client, review the Terms of Service warning above.\n\n## Commands\n\n```sh\nnpx antigravity-acp             # run the ACP server on stdio (installs first if needed)\nnpx antigravity-acp --install   # force a re-download\nnpm test                        # spawn it and assert a real ACP `initialize` reply\n```\n\n## Updating to a new agy release\n\nThe registry index is re-generated hourly upstream, so check it rather than\nguessing, then re-measure each archive:\n\n```sh\ncurl -s https://cdn.agentclientprotocol.com/registry/v1/latest/registry.json \\\n  | jq '.agents[] | select(.id == \"antigravity-acp\") | {version, distribution}'\n\n# for each archive URL: the digest to pin\ncurl -sSL \"$URL\" | shasum -a 256\n```\n\nThen update `releases.json` (`agyVersion`, URLs, `sha256`, `bytes`,\n`unpackedBytes`) and cut a release. `npm test` must pass on at least one\nplatform before publishing.\n\n## Migrating off this package\n\nThis exists only until Google ships its own npm package. When it does, swap the\ndependency and the `cmd` in your agent config — two lines — and this package\nwill be deprecated pointing at the official one.\n\n## Licence\n\nThe MIT License applies only to the source code in this repository.\n\nThe Google Antigravity ACP server binary downloaded at install time is\nthird-party proprietary software published by Google LLC. It is **not** licensed\nunder this project's MIT License and remains subject to Google's applicable\nterms and licenses:\n\n<https://antigravity.google/terms>\n\nThis package downloads the binary from Google's published distribution URL; it\ndoes not include or redistribute that binary in the npm package or repository.\n\nGoogle and Antigravity are referenced only to identify the compatible product.\nThis project is not affiliated with, endorsed by, or sponsored by Google LLC.\n","readmeFilename":"README.md"}