gemini-bridge

Expose a local REST API and CLI for querying Gemini via Safari automation.

2|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/yangtuo8/gemini-bridge --skill gemini-bridge
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gemini-bridge
Source: https://github.com/yangtuo8/gemini-bridge/tree/main
Command: npx skills add https://github.com/yangtuo8/gemini-bridge --skill gemini-bridge

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Automates querying Gemini without API keys by exposing a local REST API and CLI that orchestrate Safari automation to interact with gemini.google.com, enabling keyless access to Gemini-powered responses.

Core Features & Use Cases

  • Zero API key requirement: uses your existing Gemini session.
  • REST API + CLI: accessible programmatic interfaces for integration and automation.
  • Local execution: runs on macOS with Safari, suitable for scripting, batch processing, and internal tooling.
  • Use cases include app integrations, batch processing of queries, and rapid prototyping of AI-assisted workflows on macOS.

Quick Start

Start the REST API server via start_server.sh and then send requests to http://localhost:19999/chat to get Gemini responses.

Frequently Asked Questions about gemini-bridge

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I query Gemini without an API key?

You can query Gemini without an API key by using Safari automation to interact with gemini.google.com, leveraging your existing browser session to expose a local REST API and CLI workflow.

Can I use Safari automation to batch process Gemini prompts on macOS?

Yes, Safari automation supports batch processing of Gemini queries on macOS by injecting JavaScript into the browser, allowing you to script multiple prompts and retrieve responses programmatically.

How does a local REST server interact with Gemini via Safari?

A local REST server interacts with Gemini by sending queries to Safari using AppleScript and JavaScript injection, routing requests through a running browser session to extract and deliver responses.

Do I need an active Gemini session in Safari to use this REST API?

Yes, an active Gemini session in Safari is required, as the REST API and CLI rely on GUI automation and your existing logged-in browser state to function without requiring API keys.

What are the limitations of using AppleScript to automate Gemini queries?

Limitations of using AppleScript for Gemini queries include dependency on a running Safari browser session and macOS environment, meaning GUI automation may break if the web interface layout changes.

What's the best way to integrate Gemini into my local apps without keys?

The best way to integrate Gemini into local apps without keys is to run a local REST server endpoint, sending HTTP requests to programmatically trigger Safari automation and receive responses.