---
description: Web search when a task needs information beyond the local project or when the user mentions searching the web.
---

Run the script next to this file when a task needs current or external information (docs, versions, error messages, news, "what is X"):

```sh
~/.config/hax/skills/web-search/web_search.py [-n N] QUERY...
```

- Prints `N` results (default 5) as numbered `title / url / snippet` blocks, plain text.
- Exit status 2 with a message on stderr means the search backend rate-limited or served a bot challenge: wait and retry once, then tell the user that search is unavailable.
- Search in the language the user wrote in. For error messages, search the exact message text quoted.