CoderBhoid / gemini-bridge
git clone https://github.com/CoderBhoid/gemini-bridge.git
Just a sophisticated way to turn dumb chatbox llms into agents.
—
stars, 24h
+53
stars, 7 days · #853
+53
stars, 30 days · #5,575
53
★ total · +53% this week
7
forks · 0 open issues
Star history starts 2026-10-20; the chart appears after the second daily snapshot.
LanguageJavaScript
LicenseMIT
Created2026-10-14 (6d ago)
Last push6d ago
Watchers1
OwnerUser
Links
README excerpt
Gemini Bridge Universal Webchat Harness and OpenAI Proxy for Local Developer Agents Developer: Bhoid ( @CoderBhoid · bhoid.sednium.com ) --- Gemini Bridge connects local coding agents to active browser sessions on Google Gemini, ChatGPT, and Claude. It lets you use web interfaces directly from your terminal or IDE, executes local developer tools (`run_command`, `read_file`, `write_file`), and exposes a local OpenAI-compatible API on `http://localhost:8765/v1`. You can also use your Android phone as a **Pocket Server running Laya for System 1 models**. Laya runs on-device via Oorty (APK releases) or standalone Termux to handle fast-path gating, safety checks, and token reducing before prompts ever reach your cloud webchat session. --- ## 🛡️ Visible Browser Tab Mode (Recommended for Account Safety) Running Gemini Bridge with a normal, visible Chrome tab is the **strongly recommended setup** for zero ban risk and complete peace of mind. ### Why visible tab mode protects your account 1. **Authentic browser session**: Uses your regular logged-in Google, OpenAI, or Anthropic account session with standard cookies and security tokens. 2. **Real hardware fingerprint**: Runs with your genuine graphics card driver, authentic Canvas rendering, WebGL context, audio stack, and genuine screen resolution. 3. **Legitimate extension runtime**: Executes as a standard Manifest V3 content script inside Chrome, indistinguishable from normal extension activity (like Grammarly or Vimium). 4. **Zero automation flags**: Avoids all `navigator.webdriver` flags, automated testing attributes, and headless browser markers that anti-bot services (Cloudflare, reCAPTCHA Enterprise, Arkose) look for. ### Why you should keep Chrome open For maximum safety, keep Chrome running with your webchat tab open. You do not need to actively watch it—it can sit on a secondary monitor or in a background workspace while you code. Keeping the window alive ensures the browser maintains active render frames and authentic user presence. ### Built-in Human Safety Mode Safety Mode is enabled by default across both the CLI orchestrator and Chrome extension: - **Randomized paste jitter**: Waits a random delay between 1200ms and 2400ms before sending text to the chat input (never 0ms instant submissions). - **Simulated pointer events**: Dispatches full `pointerdown`, `mousedown`, `pointerup`, `mouseup`, and `click` sequences with simulated client coordinates instead of raw programmatic clicks. - **Reading pace pause**: Enforces a 1500ms human reading pace pause before sending subsequent automated tool prompts. - **Token flood protection**: Restricts tool outputs in `tools.js` to 50 lines and 2000 characters so rolling token buckets do not exhaust. --- ## What It Does - **Works with any model selected in the web app**: You choose the model in the UI (like **Argon**, **GPT-6.1 Sol**, **GPT-6 Astra**, **Fable 5.5 / 5.1**, or **Claude Opus 5.5**), and the bridge uses it dynamically. - **Universal webch