Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Web Research

GHOST can search the web and fetch page content for research tasks.

Uses the Brave Search API for web queries.

Requires BRAVE_API_KEY environment variable.

ghost web search "rust error handling best practices"
ghost web search "latest AI news" -n 10

Web Fetch

Extracts readable content from web pages. Supports two modes:

  • Readability — article extraction (Mozilla Readability algorithm)
  • Raw — full HTML output
ghost web fetch https://example.com
ghost web fetch https://example.com --readability
ghost web fetch https://example.com --raw

Optionally uses Crawl4AI as a backend when standard web fetching doesn’t yield good results:

[web]
crawl4ai_url = "http://localhost:11235"

Caching

All web fetches are automatically cached to $WORKSPACE/.web-cache/. The reflection agent triages those artifacts when it runs, creating sources linked to the fetched data.

How GHOST Uses Web Tools

During conversation, your GHOST proactively:

  1. Searches the web when current information is needed
  2. Fetches full pages to read beyond search snippets
  3. Caches results for later reference
  4. Cites sources in responses

The deep-research agent takes this further — it performs iterative multi-source research, fetching multiple full pages before drawing conclusions.