Skip to main content

​
Changelog

All notable changes, in reverse chronological order. The full version lives in CHANGELOG.md.

​
v0.3.3

August 5, 2026

​
New Features

  • Added a runtime-flow architecture page (concepts/runtime-flow.mdx) - CLI entrypoint → MCP dispatcher → tool dispatch → CDP backend → engines, with a request-flow diagram and a symptom→layer failure table.
  • reference/tools.mdx gains a tool-to-code map (each tool family → implementation file, browser vs no-browser, shared vs engine-specific).
  • concepts/browsers.mdx gains an engine capability matrix (Chrome / Obscura / Lightpanda / fetch_http).
  • Light/dark logo variants for the Mintlify theme + a GitHub icon in the navbar.

​
Bug Fixes

  • webrain upgrade now spawns the package-manager update (brew / scoop) detached and exits, so Scoop no longer sees the upgrade command itself as a running instance of webrain and refuses to replace the binary.

​
v0.3.2

August 5, 2026

​
Documentation

  • Added a full Mintlify docs site in docs/ - overview, quickstart, installation, browsers/challenges concepts, extraction / scrape-at-scale / auth-and-login guides, a full 51-tool reference, CLI + env reference, deployment, troubleshooting, and contributing. Existing docs/*.md files left in place, untouched.
  • Added the docs/changelog.mdx changelog map, linked in the Project nav.
  • quickstart.mdx and the README now show the full MCP client setup (stdio + HTTP transports, VS Code / Claude Desktop / Cursor configs, webrain_guide verification).
  • Added a Prerequisites section to the README and docs site.
  • Added .mintignore so the ADR / legacy markdown files stay on disk but out of the Mintlify build (fixes the ADR MDX parse error).
  • Refreshed ADR-001 graph note - 875 nodes / 2287 edges, 3 entry points, 51 MCP tools, new hotspots.

​
Improvements

  • Upgraded skills/webrain/SKILL.md to a full agent-skill contract - richer frontmatter, When to use, recommended limits, and a 7-step end-to-end invocation flow.
  • Ran cargo fmt on the mcp session-routing match indent.

​
v0.3.1

August 5, 2026

​
New Features

  • webrain install --engine lightpanda now downloads the lightpanda binary from the lightpanda-io/browser GitHub release into the engine cache, mirroring --engine obscura; find_lightpanda() also discovers the cached build. No Windows binary - the install bails with the Docker fallback instead of silently installing Chrome.

​
Improvements

  • webrain install --engine <unknown> now errors clearly instead of silently installing Chrome.

​
Bug Fixes

  • webrain_open_session(cdp_url=…) now actually routes tools to that session - every browser tool accepts an optional session_id.
  • A browser kill/restart no longer wedges the cached backend forever - dead-socket errors drop the backend so the next call reconnects.
  • The CDP WebSocket connect retries once with a longer budget (20s), tolerating obscura’s slow cold-start handshake.

​
v0.3.0

August 5, 2026

​
New Features

  • webrain_page_info - just-in-time page context (viewport/page size, scroll position, position %).
  • webrain_save_state / webrain_restore_state - export/import a profile’s auth state (cookies + localStorage) across machines.
  • webrain -v / --version / version.

​
Bug Fixes

  • webrain install failed with “response body is larger than request limit” - ureq’s 10 MB cap was too small for the Chrome/Obscura engine zips; now reads via the unlimited reader.

​
Improvements

  • Rewrote the README - install-first, “Why webrain?”, use-cases, Scoop extras.
  • Moved the Dockerfile into docker/ and added docker-compose.yml (persistent vault/profile/cache volumes).
  • Deduped the JS→JSON parse chain in tools.rs into parse_json_str / arr_len.

​
v0.2.0

August 5, 2026

​
New Features

  • webrain upgrade - updates to the latest release (Homebrew/Scoop-aware, else self-updates the binary in place).
  • One-line installers - scripts/install.sh (Linux/macOS) and scripts/install.ps1 (Windows).
  • Submitted to the official Scoop extras bucket and published a Homebrew tap (prokopis3/homebrew-webrain).
  • Added CONTRIBUTING.md, README badges, and the Quick Start + Traditional Selectors + Commands + Updating sections.

​
v0.1.1

August 4, 2026

​
New Features

  • All-OS install one-liners (PowerShell + curl) and the working scoop bucket (prokopis3/scoop-webrain).

​
Bug Fixes

  • The Linux release binary now builds on ubuntu-22.04 (glibc 2.35) - the previous ubuntu-latest build required glibc 2.39.

​
v0.1.0

August 4, 2026

​
New Features

  • Cargo workspace (resolver 3, edition 2024, Rust 1.85) with webrain-core / webrain-mcp / webrain-cli; MIT license; CI + release + changelog-enforce workflows.
  • Rust CDP browser-automation agent - one BrowserBackend trait over CDP WebSocket (CdpBackend) driving Chrome, Edge, Lightpanda, or Obscura; SessionPool isolation; STEALTH_JS anti-bot injection.
  • stdio MCP server owning the CDP connection, 25-tool dispatch table.
  • Single webrain binary, match-based subcommands (no clap) mirroring the MCP tool surface.
  • Page interaction (navigate/eval/click/type/press/scroll/snapshot, multi-tab, a11y), capture (screenshot, PDF, PixelRAG vision tiles + cosine VectorStore), extraction (extract_json / extract_regex / eval), spider + web search, batch + download.
  • webrain doctor - full install diagnosis.
  • agent-browser-style engine install - webrain install downloads Chrome for Testing (and --engine obscura); webrain lightpanda / webrain obscura spawn CDP servers.