bx
All-in-one Brave Search CLI optimized for AI agents.
Developer Setup
Setup & Installation
npx skills add https://github.com/brave/brave-search-skills --skill bxnpx skills add https://github.com/brave/brave-search-skills --skill bxOverview
What This Skill Does
Provides a command-line interface to retrieve token-budgeted web context, answers, news, images, videos, and places directly from Brave Search.
Application
When to use this Skill
- When you are working from a command-line interface or within a shell script and need search data.
- When you want a single tool that handles web search, news, images, places, and suggestions.
- When you need token-budgeted, relevance-ranked web content optimized for local LLM input.
- When you want to easily test Brave Search API parameters without writing application code.
- When you need to define inline Goggles rules to boost or exclude specific domains on the fly.
Documentation
Show Skills.md file
bx — Brave Search CLI
Use bx for all web searches. Run bx "query" as the default — it returns pre-extracted, token-budgeted web content ready for use. Use bx answers for synthesized explanations or bx web for traditional search results. If bx is not found, install it: curl -fsSL https://raw.githubusercontent.com/brave/brave-search-cli/main/scripts/install.sh | sh
Requires: Brave Search API Key +
bxbinaryPlans: Different subcommands may require different plans. See https://api-dashboard.search.brave.com/app/subscriptions/subscribe
Quick Start
# Install (macOS/Linux)
curl -fsSL https://raw.githubusercontent.com/brave/brave-search-cli/main/scripts/install.sh | sh
# Configure API key (get one at https://api-dashboard.search.brave.com)
bx config set-key # interactive (avoids shell history)
# or: export BRAVE_SEARCH_API_KEY=YOUR_KEY
# Search (default = bx context "query")
bx "your search query"
When to Use Which Command
| Your need | Command | Why |
Recommendations