gemini-web-bridge 0.0.0-stage → 0.3.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 azrinaldi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,18 @@
-# Temporary Holding Version
+# gemini-web-bridge
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Use your **Gemini Web** subscription inside **opencode** and **agy** through one small local daemon: OpenAI-compatible API, several accounts with quota-aware rotation, a dashboard, and one-command setup.
+
+```sh
+npx gemini-web-bridge start      # guided setup: sign in, configure opencode and agy, test
+npx gemini-web-bridge login      # add an account (a one-time page on this computer)
+npx gemini-web-bridge ui         # open the dashboard
+npx gemini-web-bridge status     # quota, resets and usage per account
+```
+
+Or install it once: `npm install -g gemini-web-bridge`, then use `gsb` or `gemini-web-bridge`.
+
+Linux x64 and arm64. The package ships a prebuilt binary through an optional platform package; set `GSB_BINARY=/path/to/gsb` to use your own build.
+
+> **Risk:** this drives a personal Gemini Web session by impersonating Chrome, which may violate Google's Terms of Service and could get the account restricted. Use an account you own and can afford to lose.
+
+Source, docs and security notes: https://github.com/techbysakh963/gemini-web-bridge

package/bin/gsb.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+'use strict'
+const { main } = require('../lib/run')
+
+const code = main(process.argv.slice(2))
+if (code !== null) process.exit(code)

package/lib/platform.js

@@ -0,0 +1,47 @@
+'use strict'
+const fs = require('node:fs')
+
+/** An error whose message is meant to be shown to the user as-is (no stack trace). */
+class LauncherError extends Error {}
+
+const PACKAGES = {
+  'linux/x64': 'gemini-web-bridge-linux-x64',
+  'linux/arm64': 'gemini-web-bridge-linux-arm64',
+}
+
+function packageFor(platform, arch) {
+  return PACKAGES[`${platform}/${arch}`] || null
+}
+
+/**
+ * Finds the gsb binary: GSB_BINARY if set, else the binary shipped by the matching
+ * platform package (installed as an optional dependency of this package).
+ */
+function resolveBinary({ platform, arch, env, resolve }) {
+  if (env.GSB_BINARY) {
+    if (!fs.existsSync(env.GSB_BINARY)) {
+      throw new LauncherError(`GSB_BINARY points at ${env.GSB_BINARY}, which does not exist.`)
+    }
+    return env.GSB_BINARY
+  }
+  const pkg = packageFor(platform, arch)
+  if (!pkg) {
+    throw new LauncherError(
+      `gemini-web-bridge has no prebuilt binary for ${platform}/${arch}. Supported: ${Object.keys(PACKAGES).join(', ')}.\n` +
+        `Build it from source instead (needs Go): go build -o gsb ./cmd/gsb, then set GSB_BINARY=/path/to/gsb.`,
+    )
+  }
+  try {
+    return resolve(`${pkg}/bin/gsb`)
+  } catch (e) {
+    if (e && e.code === 'MODULE_NOT_FOUND') {
+      throw new LauncherError(
+        `The binary package ${pkg} is not installed. It is an optional dependency, so it is skipped when npm runs with --omit=optional / --no-optional.\n` +
+          `Reinstall without that flag (npm install gemini-web-bridge), or install the binary directly: npm install ${pkg}.`,
+      )
+    }
+    throw e
+  }
+}
+
+module.exports = { packageFor, resolveBinary, LauncherError, PACKAGES }

package/lib/run.js

@@ -0,0 +1,49 @@
+'use strict'
+const { spawn } = require('node:child_process')
+const fs = require('node:fs')
+const { resolveBinary, LauncherError } = require('./platform')
+
+const FORWARDED = ['SIGINT', 'SIGTERM', 'SIGHUP', 'SIGQUIT']
+
+/** Runs gsb with the given arguments, wiring stdio, signals and the exit status through. */
+function main(argv, { env = process.env, platform = process.platform, arch = process.arch, resolve = require.resolve } = {}) {
+  let bin
+  try {
+    bin = resolveBinary({ platform, arch, env, resolve })
+    try {
+      fs.accessSync(bin, fs.constants.X_OK)
+    } catch {
+      fs.chmodSync(bin, 0o755) // npm can drop the executable bit on some setups
+    }
+  } catch (e) {
+    if (e instanceof LauncherError) {
+      process.stderr.write(`gemini-web-bridge: ${e.message}\n`)
+      return 127
+    }
+    throw e
+  }
+
+  const child = spawn(bin, argv, { stdio: 'inherit', env })
+  const relay = (sig) => () => {
+    if (!child.killed) child.kill(sig)
+  }
+  const handlers = FORWARDED.map((sig) => [sig, relay(sig)])
+  for (const [sig, h] of handlers) process.on(sig, h)
+
+  child.on('error', (e) => {
+    process.stderr.write(`gemini-web-bridge: could not start ${bin}: ${e.message}\n`)
+    process.exit(126)
+  })
+  child.on('exit', (code, signal) => {
+    for (const [sig, h] of handlers) process.removeListener(sig, h)
+    if (signal) {
+      // End the same way the child did, so shells and supervisors see the real cause.
+      process.kill(process.pid, signal)
+      return
+    }
+    process.exit(code === null ? 1 : code)
+  })
+  return null
+}
+
+module.exports = { main }

package/package.json

@@ -1,6 +1,41 @@
 {
   "name": "gemini-web-bridge",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.3.1",
+  "description": "Use your Gemini Web subscription in opencode and agy: a local OpenAI-compatible bridge with multi-account rotation, a dashboard and one-command setup.",
+  "keywords": [
+    "gemini",
+    "opencode",
+    "agy",
+    "openai-compatible",
+    "bridge",
+    "proxy"
+  ],
+  "license": "MIT",
+  "bin": {
+    "gemini-web-bridge": "bin/gsb.js",
+    "gsb": "bin/gsb.js"
+  },
+  "files": [
+    "bin",
+    "lib",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "optionalDependencies": {
+    "gemini-web-bridge-linux-arm64": "0.3.1",
+    "gemini-web-bridge-linux-x64": "0.3.1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/techbysakh963/gemini-web-bridge.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "test": "node --test \"test/*.test.js\""
+  }
+}