Skip to content

opencode

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

opencode

README.md

@cortexkit/opencode-antigravity-auth

One package for OpenCode 1.x (V1) and OpenCode 2.x general availability (GA), with server and terminal user interface (TUI) entries. Use Google sign-in for the Antigravity model catalog, a local account pool with rotation and quota limits, and the /antigravity menu/sidebar. The bundled antigravity-auth CLI provides account and quota commands; read its standalone login pool-replacement behavior before using it with an existing pool.

Using this plugin or any proxy for Antigravity violates Google's Terms of Service. Account holders have reported suspensions, bans, and shadow-bans. The project is not endorsed by Google; use it at your own risk. Never include credentials, account files, or raw request/response dumps in Git or support reports.

This guide describes the current source tree, not an announcement that an unreleased version is available on npm. See the project overview and current models and evidence caveats: Gemini 4 Argon's MEDIUM/HIGH thinking levels and toolConfig omission remain unverified live.

Host requirements and entries

Host field Required range
OpenCode engine >=1.17.13 <2 or >=2.0.22
V1 SDK peer (@opencode-ai/plugin) * (checkout pin 1.17.13)
GA SDK peer (@opencode/plugin) >=2.0.22 (checkout pin 2.0.22)
OpenTUI core/keymap/solid peers >=0.4.5 each
solid-js peer >=1.9.0
Node >=20

Peers are optional in the manifest because each host uses its matching runtime. The checkout pins V1 OpenTUI 0.4.5 and GA OpenTUI 0.5.14; declared peer ranges alone do not establish that every host/runtime combination has been tested or works.

  • . → dist/index.js, the legacy V1 root.
  • ./server → dist/server.js, the hybrid V1/GA server.
  • ./tui → src/tui/entry.mjs, the V1/GA TUI dispatcher.

Top-level server.js and tui.js forward directory-based loading to the public entries. There is no separate OpenCode 2 adapter package. Register the complete package, not a copy of dist/ alone.

Installation

Quit all OpenCode and Pi processes, then run:

npx @cortexkit/opencode-antigravity-auth setup

Read guided setup for explicit host selection, local versus approved-vault mode, dry-run, and bounded real-run metadata effects. Setup does not bypass stopped-host checks or complete OpenCode 2's native connection. See migration and rollback before upgrading an existing pool; a version pin alone is not an automatic-update hold.

After starting the host, open /antigravity for account, quota, routing, limits, diagnostics, and vault actions. Available actions depend on the active credential source. Commands covers the menu and standalone CLI.

Contributor build and TUI

From the repository root:

bun install --frozen-lockfile
bun install --cwd tools/common-auth-build --frozen-lockfile --ignore-scripts
bun run build
bun run --cwd packages/opencode smoke:tui

Use Bun 1.4.2 for TUI regeneration: bun run --cwd packages/opencode build:tui. The public loader selects src/tui-compiled/tui.js or the raw fallback src/tui-raw/tui.tsx for V1; OpenCode 2 has separate compiled/raw trees. Runtime support is probed before selection; unrelated import errors propagate. The private compiler and input archive are repository-only, never shipped.

smoke:tui installs fresh tarballs in a scratch consumer and checks resolution and renderer startup. It does not prove login, provider activation, or request serving in a real OpenCode host. Use an isolated host config/database for source work so test runs cannot change your usual accounts or conversations. See development and release for the complete gates.

Documentation

License

MIT. See LICENSE.