Google Grounding

v0.2.0模型接入

opencode-google-grounding

OpenCode plugin that adds a Google Search grounding tool for Gemini/Vertex-compatible providers.

维护活跃

#opencode #opencode-plugin #gemini #google-search #grounding #vertex-ai

GitHub 仓库 npm 页面官方主页

GitHub 星标

月装机量

近 7 天 1

综合评分SCORE

21.1

生态多维模型

快速安装与配置

opencode.json

写入当前项目的 opencode.json，只对这个仓库生效。

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["opencode-google-grounding@0.2.0"]
}

写入 ~/.config/opencode/opencode.json，对所有项目生效。

~/.config/opencode/opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["opencode-google-grounding@0.2.0"]
}

opencode 启动时会通过内嵌运行时自动加载 npm 依赖并缓存至本地目录，无需手动在全局环境执行安装。

README.md

查看原始文件→

OpenCode plugin that adds a google_grounding tool backed by Gemini Google Search grounding.

Any OpenCode model can call it. The active model can be GPT, Claude, Kimi, Grok, DeepSeek, or Gemini; the tool makes a separate grounded Gemini or Vertex request.

Install

Add it to ~/.config/opencode/opencode.json:

{
  "plugin": ["opencode-google-grounding"]
}

OpenCode installs npm plugins automatically at startup. You do not need to use Bun directly.

Auth

Google AI Studio / Gemini API:

export GOOGLE_API_KEY="..."

Custom proxy:

export OPENCODE_GOOGLE_BASE_URL="https://example.com/google/v1beta"
export GOOGLE_API_KEY="..."

Native Vertex AI:

export OPENCODE_GOOGLE_BACKEND="vertex"
export GOOGLE_CLOUD_PROJECT="my-gcp-project"
export GOOGLE_CLOUD_LOCATION="global"
gcloud auth login

Use

Ask OpenCode:

Use google_grounding to get the live Bitcoin price in USD and include sources.

The model sees the tool as:

google_grounding

Defaults

Tool name: google_grounding
Provider config checked by default: provider.opencode-google
Model: gemini-3-flash-preview
Gemini API URL: https://generativelanguage.googleapis.com/v1beta

API key lookup:

plugin option apiKey
env var named by apiKeyEnv
OPENCODE_GOOGLE_API_KEY
GOOGLE_API_KEY
GEMINI_API_KEY
provider.opencode-google.options.apiKey

Test

npm install
npm test
npm run coverage

OpenCode tool check:

opencode debug agent build | jq '.tools.google_grounding'

Plugin options

You only need this tuple form when overriding defaults. The first item is the package name; the second item is the options object passed to the plugin.

{
  "plugin": [
    [
      "opencode-google-grounding",
      {
        "backend": "gemini",
        "provider": "opencode-google",
        "model": "gemini-3-flash-preview",
        "baseURL": "https://example.com/google/v1beta",
        "apiKeyEnv": "OPENCODE_GOOGLE_API_KEY",
        "timeoutMs": 90000,
        "maxOutputTokens": 4096
      }
    ]
  ]
}

Provider/proxy config

If you already have a Google-compatible provider in OpenCode, the plugin can reuse it:

{
  "plugin": ["opencode-google-grounding"],
  "provider": {
    "opencode-google": {
      "options": {
        "baseURL": "https://example.com/google/v1beta",
        "apiKey": "..."
      }
    }
  }
}

When baseURL is explicit, the plugin still falls back to GOOGLE_API_KEY if no plugin/proxy key is set.

Native Vertex details

Native Vertex mode uses OAuth/Bearer auth instead of an API key.

{
  "plugin": [
    [
      "opencode-google-grounding",
      {
        "backend": "vertex",
        "project": "my-gcp-project",
        "location": "global",
        "model": "gemini-3-flash-preview"
      }
    ]
  ]
}

Access token lookup:

plugin option accessToken
GOOGLE_OAUTH_ACCESS_TOKEN
VERTEX_ACCESS_TOKEN
gcloud auth print-access-token

Install from source

git clone https://github.com/janaki-sasidhar/opencode-google-grounding.git
cd opencode-google-grounding
npm install

{
  "plugin": ["/absolute/path/to/opencode-google-grounding"]
}

Notes

This is an OpenCode tool, not native provider grounding inside every model call. The model chooses when to call google_grounding.

License

MIT