Skip to content

nudge 0.4.1

Choose a tag to compare

View all tags
@HongtaoYang HongtaoYang released this 08 Nov 05:01
· 18 commits to main since this release
v0.4.1
852eec8
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

nudge 0.4.1 adds built-in web search, and nudge now adapts each request to what the selected model supports.

Highlights

  • Web search. nudge uses Anthropic's server-side web_search tool (web_search_20260318). It's on by default and capped at 5 searches per request.

    • Searches show as WebSearch cards with each result's title and URL, live and when a session is resumed.

  • Dynamic filtering. On models that support it, Claude can write and run code in Anthropic's sandbox to filter search results before they reach the context. That means better accuracy with fewer tokens. Those steps show as a single "ran code in Anthropic's sandbox" notice.

  • Per-model capabilities. nudge reads each model's capabilities from Anthropic's Models API and shapes the request to match:

    • dynamic filtering or direct-only search;
    • adaptive or budgeted thinking.

    This fixes the adaptive thinking is not supported on this model error when switching to Claude Haiku 4.5.

  • Cited answers render cleanly. Answers that cite search results no longer break their markdown (tables, lists, bold) across fragments.

  • Long search turns finish. When the API pauses a long server-side turn (pause_turn), nudge continues it instead of ending it early.

Upgrade notes

  • Cost: web search costs about $10 per 1,000 searches plus result tokens. Code execution used for filtering is free.
  • No permission prompt: searches run on Anthropic's side, so they don't go through nudge's approval step. That includes auto mode and subagents.
  • Turning it off: set NUDGE_WEB_SEARCH=off (shell, project .env, or ~/.nudge/config.env). Any value other than on/off is rejected at startup.
  • ZDR/HIPAA: dynamic filtering isn't eligible for Zero Data Retention or HIPAA. Turn web search off if that applies to you.
  • Session compatibility: sessions that used web search contain new block types. nudge 0.4.1 reads older sessions fine, but older nudge versions can't fully read sessions created by 0.4.1 that used search. Upgrade every machine and daemon that shares a session store.

Build

  • The macOS (Apple Silicon) agent now builds on GitHub's macos-15 runner; macos-14 runners were retired. 0.4.0 was tagged but shipped no binaries; 0.4.1 is the first installable release with these changes.
Assets 10
Loading