Skip to content

Releases: nicobailon/surf-cli

v2.6.0

22 Feb 04:15

Choose a tag to compare

Added

  • AI Studio provider (surf aistudio) - Query Gemini models via aistudio.google.com using your browser session. Supports --model for best-effort model selection and --with-page to include current page context. Extracts responses from both DOM and network (GenerateContent RPC), with thinking-model support. (co-authored by @w-winter)
  • AI Studio App Builder (surf aistudio.build) - Automate AI Studio's App Builder to generate web apps from a text prompt. Downloads the result as a zip file and optionally extracts it to --output. Supports --model, --timeout, and --keep-open.
  • Windows support - Named pipes for socket paths, SURF_TMP for temp files, ImageMagick quoting fixes, skip Unix-only unlinkSync/chmodSync. (@marcfargas)
  • Helium browser support - Detect and connect to Helium browser alongside Chrome. (@aliou)
  • Env var overrides - SURF_SOCKET_PATH, SURF_HOST_PATH, and SURF_MANIFEST_PATH for package manager installs. (@aliou)
  • Skills in npm package - Skills directory now included in published package. (@aliou)

Fixed

  • CLI --version - Read version dynamically from package.json instead of a hardcoded constant. (@davidguttman)

Dependencies

  • Bump vite-plugin-node-polyfills from 0.24.0 to 0.25.0

v2.5.2 - Version display fix & docs update

28 Jan 18:37

Choose a tag to compare

Fixed

  • CLI version display - Fixed hardcoded VERSION constant showing "2.0.0" instead of actual version

Docs

  • SKILL.md overhaul - Comprehensive update with all v2.1-2.5 features:
    • Semantic locators (locate.role, locate.text, locate.label)
    • Text search (search/find)
    • Element styles inspection
    • Dropdown select command
    • Tab grouping commands
    • Named workflows with arguments, loops, step outputs
    • Frame context switching
    • Window isolation
    • And more...

Install/Update

npm install -g surf-cli@2.5.2
surf install <extension-id>

v2.5.1 - Fix Gemini HTTP hanging

28 Jan 18:06

Choose a tag to compare

Fixed

  • Gemini client hanging - Fixed HTTP requests hanging indefinitely when called through native messaging host. Root cause was missing content-length header - Node.js failed to auto-calculate content length in the native messaging stdio context.
  • Gemini SSL/TLS - Added rejectUnauthorized: false for Gemini API requests
  • Gemini host header - Added explicit host: gemini.google.com header required by Google's servers

Improved

  • HTTP request robustness - Added explicit timeouts, better error handling, and debug logging
  • Buffer handling - Proper UTF-8 encoding for POST request bodies

Install/Update

npm install -g surf-cli@2.5.1
surf install