Skip to content

nudge 0.5.0

Choose a tag to compare

@HongtaoYang HongtaoYang released this 08 Nov 11:04
· 16 commits to main since this release
b2f9d49

nudge 0.5.0 adds web fetch, so nudge can read full web pages and PDFs as well as search, completing search → read → answer.

Highlights

  • Web fetch. nudge uses Anthropic's server-side web_fetch tool (web_fetch_20260318), up to 5 fetches per request. Each fetch shows as a WebFetch card with the URL and a one-line summary (size, or the error code), live and on resume. It never shows the page itself.
  • Safe by default. nudge only fetches URLs that came from you or from web search/fetch results. Links that appear only in files or command output are refused (url_not_in_prior_context); paste them into the chat instead. This blocks a prompt-injection trick where a tool prints a URL with secrets in it and the model then fetches it.
  • Per model. Fetch follows the same capability rules as search: dynamic filtering on models that support it, direct calls elsewhere (e.g. Claude Haiku 4.5).
  • Old fetch results are cleared automatically. On models that support context editing, Anthropic clears old fetch results from the prompt once a conversation passes ~100k input tokens. A one-line notice tells you when; your saved session is unchanged. Long sessions with big fetches keep working, including after switching to a model with a smaller context window.

Upgrade notes

  • NUDGE_WEB_SEARCH now covers both search and fetch; off turns off both.
  • Page cap: web pages are capped at about 25k tokens each and may be cut off without notice.
  • PDFs are returned whole (the cap doesn't apply to them) and can cost 100k+ tokens. nudge steers the model toward HTML pages where possible.
  • Fetch can't render JavaScript-heavy pages or reach localhost or private pages.
  • Cost: fetch has no extra fee beyond the tokens of the fetched content.
  • Session compatibility: sessions that used fetch contain new block types; open them with 0.5.0. Older versions keep them but show no fetch cards.
  • Known limitation: old PDF data is still uploaded with every request, even though it's cleared from the prompt. Reducing that is planned.