| name | bx-search |
| description | Web search using the Brave Search CLI (`bx`). Use for ALL web search requests — including "search for", "look up", "find", "what is", "research", and any task needing current or external information. Also for: documentation lookup, troubleshooting research, news, and fetching fresh info beyond training data. |
bx — Brave Search CLI
Agent Directive
When this skill is active, use bx via the bash tool for all web
searches. Run bx context "query" as the default — it returns
pre-extracted, token-budgeted content ready for use (one call replaces
search + scrape + extract). Fall back to bx answers for synthesized
explanations or bx web when search operators are needed.
bx is installed on PATH and the API key is configured by Bakin — no setup
needed. If bx reports a missing or invalid key, report that honestly and
stop; the key is managed in Bakin's Settings → Integrations & Keys.
When to Use Which Command
| Your need | Command | Why |
|---|
| Look up docs, errors, code patterns | bx context "query" --max-tokens 4096 | Pre-extracted text, token-budgeted |
| Get a synthesized explanation | bx answers "question" --no-stream | AI-generated, cites sources |
| Search a specific site (site:) | bx web "site:docs.rs axum" --count 5 | Supports search operators |
| Find discussions/forums | bx web "query" --result-filter discussions | Forums often have solutions |
| Latest versions/releases/news | bx news "query" --freshness pd | Fresh info beyond training data |
Response Shapes
bx context (recommended):
{ "grounding": { "generic": [
{ "url": "...", "title": "...", "snippets": ["extracted content...", "..."] }
] } }
bx answers --no-stream:
{"choices": [{"message": {"content": "..."}}]}
bx web: full search results under web.results[] (title, url,
description), plus optional news/videos/discussions sections.
Rules
- Always cite source URLs from results in your output.
- Never fabricate search results — if a search fails, say exactly what
failed and complete the task with an honest failure summary.
- Do not assume
jq is installed; read raw JSON or filter with available
tools.
- Prefer one well-scoped
context call over many broad searches.
