gsearch

name	gsearch
description	This skill should be used when the user asks to "search google", "find information online", "search the web", or needs real-time, grounded information from the internet.
user-invocable	true

Google Web Search CLI

A lightweight Rust binary for executing grounded Google Web Searches via the Gemini API. Use this instead of MCP-based search servers — it connects using the shared gemini-cli OAuth credentials, requires no background server process, and consumes very few tokens.

Prerequisites

If no valid OAuth token is found, the CLI will automatically trigger the login flow and open Chrome for authentication.

# To force a login flow manually:
gsearch --login

Core workflow

Run the gsearch command followed by your search query. Do not use quotes around the query unless necessary; the CLI handles spaced arguments automatically.

gsearch latest news about rust programming language

Commands

Search

gsearch <query...>          # Search Google and return summarized results

Authentication

gsearch --login            # Refresh or initiate OAuth authentication

Output Format

The binary returns a concise, summarized answer generated by Gemini, followed by a list of source citations mapping directly to markers in the text (e.g. [1], [2]).

Typical task pattern

1. Determine that external, up-to-date information is needed.
2. Formulate a precise search query.
3. gsearch <query> — execute the search.
4. Read the resulting summary and citations.
5. Use the provided information to fulfill the user's request, referencing the citations if helpful.