Fresh

fresh websearch

Search the general web for any topic

The websearch command searches the general web for any topic. Results can be fetched with fresh get.

Usage

fresh websearch <QUERY> [OPTIONS]

Examples

# Basic search (uses DuckDuckGo - free)
fresh websearch "python async tutorial"

# Limit results
fresh websearch "react hooks" --count 5

# Table output
fresh websearch "rust ownership" --table

# Verbose mode
fresh websearch "python" --verbose

Options

OptionShortDescription
--count-nMaximum number of results (default: 10)
--engine-eSearch engine: auto, ddg, brave
--json-jOutput as JSON (default)
--table-tOutput as table
--verbose-vShow verbose output

Search Engines

DuckDuckGo (Default)

Free, no API key required. Uses DuckDuckGo HTML interface.

Set BRAVE_API_KEY environment variable for better results:

export BRAVE_API_KEY="your-api-key"
fresh websearch "python" --engine brave

Fetching Results

Once you find a result, use fresh get <URL> to fetch it as Markdown:

fresh websearch "python best practices"
# Returns URLs...
fresh get https://example.com/article/

On this page