Menu
Google Custom Search CLI operations via gws. Use when users need to perform web searches using Google Programmable Search Engine. Triggers: google search, custom search, web search.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Google Chat CLI operations via gws. Use when users need to list/create/manage chat spaces, read/send messages, manage members, track read state, handle attachments, or monitor space events. Triggers: google chat, gchat, chat spaces, chat messages.
Google Drive CLI operations via gws. Use when users need to list, search, upload, download, manage files/folders, permissions, approvals, revisions, comments, shared drives, and more. Triggers: drive, files, upload, download, folders, google drive, file management, permissions, approvals, share, shared drives.
Google Chat CLI operations via gws. Use when users need to list/create/manage chat spaces, read/send messages, manage members, track read state, handle attachments, or monitor space events. Triggers: google chat, gchat, chat spaces, chat messages.
Google Drive CLI operations via gws. Use when users need to list, search, upload, download, manage files/folders, permissions, approvals, revisions, comments, shared drives, and more. Triggers: drive, files, upload, download, folders, google drive, file management, permissions, approvals, share, shared drives.
Google Gmail CLI operations via gws. Use when users need to list emails, read messages, send email, manage labels, drafts, attachments, batch operations, or trash messages. Triggers: gmail, email, inbox, send email, mail, labels, archive, trash, drafts, attachments.
Google Gmail CLI operations via gws. Use when users need to list emails, read messages, send email, manage labels, drafts, attachments, batch operations, or trash messages. Triggers: gmail, email, inbox, send email, mail, labels, archive, trash, drafts, attachments.
| name | gws-search |
| version | 1.0.0 |
| description | Google Custom Search CLI operations via gws. Use when users need to perform web searches using Google Programmable Search Engine. Triggers: google search, custom search, web search. |
| metadata | {"short-description":"Google Custom Search CLI operations","compatibility":"claude-code, codex-cli"} |
gws search provides CLI access to Google Programmable Search Engine (Custom Search) with structured JSON output.
Disclaimer:
gwsis not the official Google CLI. This is an independent, open-source project not endorsed by or affiliated with Google.
Before executing any gws command, verify the CLI is installed:
gws version
If not found, install: go install github.com/omriariav/workspace-cli/cmd/gws@latest
Requires separate API credentials beyond standard OAuth:
GWS_SEARCH_ENGINE_ID and GWS_SEARCH_API_KEY environment variables, or add search_engine_id and search_api_key to your config file| Task | Command |
|---|---|
| Web search | gws search "query" |
| Limit results | gws search "query" --max 5 |
| Search a site | gws search "query" --site example.com |
| Image search | gws search "query" --type image |
| Paginate results | gws search "query" --start 11 |
| Override API key | gws search "query" --api-key <key> --engine-id <id> |
gws search <query> [flags]
Flags:
--max int — Maximum number of results, 1-10 (default 10)--site string — Restrict search to a specific site--type string — Search type: image or empty for web--start int — Start index for results pagination (default 1)--api-key string — API Key (overrides config)--engine-id string — Search Engine ID (overrides config)Examples:
gws search "golang best practices"
gws search "kubernetes deployment" --max 5
gws search "release notes" --site github.com
gws search "logo" --type image
gws search "query" --start 11 # Page 2 of results
gws search "query" --format json # Structured JSON (default)
gws search "query" --format yaml # YAML format
gws search "query" --format text # Human-readable text
--format json (the default) for programmatic parsing--start to paginate--site flag is useful for searching within a specific domain--type image) returns image URLs and metadata