Initial commit

commands/query.md

@@ -0,0 +1,47 @@
+---
+description: Query Gemini with Google Search grounding
+argument-hint: prompt
+---
+
+Query Gemini with Google Search grounding for real-time web information with automatic citations.
+
+## Usage
+
+```bash
+gemini-google-search-tool query "PROMPT" [OPTIONS]
+```
+
+## Arguments
+
+- `PROMPT`: Search query (required, or use `--stdin`)
+- `--stdin` / `-s`: Read prompt from stdin
+- `--add-citations`: Add inline citation links to response
+- `--pro`: Use gemini-2.5-pro (default: gemini-2.5-flash)
+- `--text` / `-t`: Output markdown format (default: JSON)
+- `-v/-vv/-vvv`: Verbosity (INFO/DEBUG/TRACE)
+
+## Examples
+
+```bash
+# Basic query
+gemini-google-search-tool query "Who won euro 2024?"
+
+# With inline citations
+gemini-google-search-tool query "Latest AI news" --add-citations
+
+# From stdin
+echo "Climate change" | gemini-google-search-tool query --stdin
+
+# Pro model with debug output
+gemini-google-search-tool query "Quantum computing" --pro -vv
+```
+
+## Output
+
+**JSON (default):**
+- `response_text`: AI response with grounding
+- `citations`: Array of {index, uri, title}
+- `grounding_metadata`: Search queries and supports (with `-vv`)
+
+**Markdown (`--text`):**
+- Response text followed by citations list