| name | agent-search |
| description | Web search via Gemini CLI or OpenAI Codex CLI. Prints a structured response (query, raw results, answer per search) and saves full output and stderr to temp files for debugging. Use when built-in web_search is unavailable. Ask the user which provider to use, or default to gemini. |
Web Search (Gemini / Codex)
./search.sh "your query"
./search.sh --gemini "your query"
./search.sh --codex "your query"
Response is structured as (repeated per search query made):
## Search Query: <query>
### Raw Results
### Answer
Choosing a provider
- gemini — uses
gemini --model auto, auth via Gemini CLI login
- codex — uses
codex --search -m gpt-5.1-codex-mini, auth via OpenAI Codex CLI login
If one fails, try the other. Ask the user which they prefer if unsure.
Debug files
Both saved to /tmp/web-search-<id>.*:
.json — full output (gemini: single JSON; codex: NDJSON).stderr — stderr from the CLI
cat /tmp/web-search-<id>.json | jq '.stats'
cat /tmp/web-search-<id>.json | jq -r 'select(.item.type == "web_search") | .item.action.query'
