Repository navigation
π Browser4 v4.14.1 Release Notes
Release Date: 2026-10-17 05:40:34 UTC
Java Version: 25+
Built by: @galaxyeye
Browser4 4.14.1 is the first maintenance release of the 4.14 line: two large issue batches from the scenario evaluations land as fixes, and two defects that broke everyday CLI commands are gone.
- Every command with a positional argument works again. The option validation added with the 20261013 batch treated the dispatcher's positional slot as a misspelled flag, so
open <url>failed with "unknown option --url" - together withgoto,new-tab,crawl,console,scrollintoview,highlight,snapshot grep,webminer install,code replaceandmousemove. --jsonprints exactly one document.network requests --jsonemitted the raw buffer plus the envelope (whichjqrejects), andnetwork routesclaimed e2e coverage it never had; both now record native JSON inside the envelope, and the routes command is asserted end to end.- Two issue batches closed. 139 issues from the 20261013 evaluations and 132 from the 20261015 ones are fixed and verified across agent lifecycle, the five plugin modules, snapshot/htmlsnapshot/inspect, crawl/loop and attach/session/tabs/window - counts, envelopes, selector quoting and liveness reasons were the recurring themes. The 20261016 batch (19 issues) is filed for triage.
- Agent retries stop swallowing cancellation.
run()rethrows CancellationException instead of retrying past it, gates retries onRetryStrategy.shouldRetry, applies the backoff its timeout budget already accounted for, and reports an inference timeout as a timeout instead of a user cancellation. - New launch switch.
browser.extensions.inherit=falseadds--disable-extensionsat the single launch funnel, so a profile's live extensions can no longer inject their content script into a session that must stay pure (the default staystrue). The base library moves to the released 4.11.25.
π¦ Release Highlights
π Release Statistics
| Metric | Value |
|---|---|
| π JAR Size | 105MB |
| π Commits | 22 |
| π₯ Contributors | 1 |
| ποΈ Build Date | 2026-10-17 05:40:34 UTC |
π Changes Since Last Release
- fix(cli-tests): exercise disconnect so the e2e coverage self-check passes (3ac459cd4b)
- chore(release): 4.14.1 (27c86e9778)
- chore(issues): file the 20261016 evaluation batch into draft (34b3d5c985)
- test(real-world-scenarios): close the disconnect/network-routes/tool-list gaps (6f345190a6)
- test(production): stop Phase C asserting a history entry the page pruned (8af8d8e574)
- chore(issues): archive the 20261015 batch into review/done/2026/1015 (d160ae2b8c)
- fix: repair the 20261015 scenario issue batch (52d242dcf5)
- docs(config): drop the Claude Code [1m] annotation from the DeepSeek example (78e21695d1)
- fix(scripts): stop shadowing the read-only $HOME before every agent launch (fc8a00fb17)
- Merge feat/eval-world-and-issue-fixes into 4.14.x: the 20261013 issue batch, main-world eval, and the base 4.11.25 release (43830cedfb)
- test(e2e): align the last three scenarios with the batch's behaviour (e0cac9427d)
- build: consume the released base library 4.11.25 (fe6fba5c78)
- fix(cli): make the 20261013 batch's behaviour changes match their tests (b776c0268f)
- fix(cli): stop rejecting the positional arguments every command declares (7fd8d531ff)
- fix: repair the 20261013 scenario issue batch (8b71b27dfd)
- chore(issues): archive every issue artifact into review/done (d2bbd419a4)
- fix(agentic): repair run() retry loop cancellation, backoff and timeout reporting (1deeb1e7fe)
- docs(copilot): file the environment-purity switch design and stealth probes (716c1a2b35)
- feat(browser): add browser.extensions.inherit to control user extensions at launch (c40bc909c9)
- Merge 4.14.x into main: the v4.14.0 release, its CI e2e budget fix, and the 4.14.1-SNAPSHOT bump (8cfc588592)
- Auto-bump version to 4.14.1-SNAPSHOT (2801d1d1fc)
- Merge 4.14.x into main: the nightly's two newly-run suites, and the rc.10 bump (eaebaec498)
π Quick Start
Self-contained install
Use the CLI to download the matching Browser4 runtime bundle for your platform:
browser4-cli install
browser4-cli openCLI & SKILLS
# Open a new browser window
browser4-cli open
# Navigate to a page
browser4-cli goto https://browser4.io
# Inspect the page β note the eN labels on interactive nodes
browser4-cli snapshot
# Interact using refs from the snapshot
browser4-cli click e15
browser4-cli type e15 "Hello World"
browser4-cli press e15 Enter
browser4-cli keydown Shift
browser4-cli mousemove 150 300
browser4-cli mousewheel 0 100
browser4-cli keyup Shift
# Take a screenshot and save it to disk
browser4-cli screenshot
# Use a custom server URL
browser4-cli open --server http://localhost:9090
# Execute multiple commands in one process
browser4-cli batch "open https://browser4.io" "snapshot"
# Stop on the first batch failure
browser4-cli batch --bail "open https://browser4.io" "click e1" "screenshot"
# Advanced: pipe batch commands as JSON via stdin
echo '[
["goto", "https://example.com/form-filling"],
["click", "#reset-btn"],
["fill", "#first-name", "Bob"],
["fill", "#last-name", "Smith"],
["fill", "#email", "bob@example.com"],
["select", "#country", "uk"],
["check", "#agree-terms"],
["click", "#submit-btn"]
]' | browser4-cli batch --json
# Close the session when done
browser4-cli closeπ Full Changelog
Built with β€οΈ by the Browser4 team
browser4-cli
This release also includes prebuilt browser4-cli binaries for:
- Linux x64
- Linux ARM64
- Linux musl x64
- Linux musl ARM64
- Windows x64
- macOS x64
- macOS ARM64
npm package:
npm install -g browser4-cli
CLI package version in this release workflow:
4.14.1
Self-contained Browser4 runtime bundles
This release also includes self-contained Browser4 runtime bundles with:
- a
lib/directory containingBrowser4Bundle.jarand all runtime dependencies - a minimal
jlink-built JRE underruntime/ - platform-specific launcher scripts in
bin/
Runtime model:
runtime/bin/java -cp "lib/*" <MainClass>
Supported release assets:
browser4-bundle-runtime-windows-x64.zipbrowser4-bundle-runtime-linux-x64.tar.gzbrowser4-bundle-runtime-darwin-arm64.tar.gz
Recommended install flow:
browser4-cli install
Full Changelog: v4.14.0...v4.14.1