0.11.6 (2026年05月11日)

Features

• Clip Data protocol support — bb-browser provider now handles DataCommand from the Hub, enabling pinix data browser read/write/list/delete/stat operations. Per-clip file storage at ~/.pinix/data/browser/.
• Screenshot returns pinix:// URI — browser screenshot saves PNG to clip data and returns pinix://browser/screenshots/{timestamp}.png by default. Base64 dataUrl is only included when explicitly requested (includeBase64), keeping responses lightweight for cross-clip consumption.

Usage

# Screenshot → pinix:// URI (no more inline base64)
pinix invoke browser screenshot
→ {"path":"pinix://browser/screenshots/1234567890.png"}
# Cross-clip: perceive reads browser's screenshot
pinix invoke perceive analyze --file pinix://browser/screenshots/1234567890.png
# Direct data operations
pinix data browser list screenshots/
pinix data browser read screenshots/1234567890.png

0.11.5 (2026年05月07日)

Bug Fixes

• Stale highlight overlays no longer accumulate — Previously, calling snapshot -i multiple times (especially in SPAs) caused old highlight boxes to pile up. Now each snapshot starts clean by removing previous overlays before building the new tree. Closes #173.
• Screenshot captures are clean — screenshot now automatically removes any highlight overlays before capturing, ensuring screenshots are never polluted by numbered ref boxes.

0.11.4 (2026年05月07日)

Bug Fixes

• Daemon self-healing on CDP disconnect — When Chrome is killed while the daemon is running, subsequent commands no longer return 503. The daemon detects the broken CDP connection and automatically restarts Chrome + daemon. (#207)
• Cookie persistence on headless/remote machines — Added --use-mock-keychain to managed Chrome launch args. On machines where macOS Keychain is inaccessible (e.g. Mac Mini via SSH), cookies now persist across Chrome restarts. This is the same approach used by chromedp, Playwright, and Cypress. (#207)
• provider: preserve large integer precision in decodeInput (561c002)

Features

• bb-browser daemon start — New subcommand for explicit background daemon startup. bb-browser daemon now supports the full lifecycle: start / status / stop.
• bb-browser daemon status hints — Shows actionable next steps: how to start when not running, how to stop when running, and a warning with recovery steps when CDP is disconnected.

0.11.3 (2026年04月09日)

Features

• unified command registry for CLI/MCP/Edge Clip (#171) (fd0d795)
• warn when local adapter overrides community version (#178) (#179) (3a24359)

Bug Fixes

• preserve structured error from site CLI in provider (#187) (0da5e48)

0.11.2 (2026年04月03日)

Bug Fixes

• CDP 503 returns diagnostics immediately instead of 30s timeout (#157) (67efdd3)
• remove extension packaging from publish workflow (#155) (1931c55)

0.11.1 (2026年04月03日)

Bug Fixes

• auto-launch Chrome when daemon starts (#152) (9243517)
• consolidate daemon state into daemon.json with PID liveness check (6d52b22)
• align daemon host defaults and restore daemon command (#137) (37f8d64)
• remove Chrome Extension package (already shipped in 0.11.0) (7936566)

Breaking Changes

• 去掉 Chrome Extension 依赖 — Daemon 现在直接通过 CDP WebSocket 连接 Chrome,不再需要安装扩展
• Tab ID 从数字序号改为字符串短 ID — --tab 0 → --tab c416(4 位 hex,稳定跨 session)
• MCP tools 的 tab 参数类型从 number 改为 string

New Features

• Daemon 统一 — 合并 daemon + cdp-monitor 为单一 CDP 直连后端,所有 CLI/MCP 命令走同一进程
• Per-tab 事件缓存 — network/console/errors 按 tab 隔离存储(RingBuffer,不会 OOM)
• 增量查询 — --since last_action 只返回上次操作后的事件,cursor 支持分页轮询
• 查询过滤 — --method POST、--status 4xx、--limit 20 精确筛选 network 请求
• MCP 新增 browser_console、browser_errors tools,支持 since/filter/limit

Bug Fixes

• 无效 tab ID 现在报错而不是静默 fallback 到随机 tab
• --tab <id> tab close 现在正确关闭指定 tab
• tab_new 在零 tab 时不再死锁
• console.warn() 正确捕获为 type: "warn"
• 空查询结果的 cursor 返回 since 阈值而不是 0(防止轮询死循环)
• Daemon shutdown 防重入保护
• CDP 端口发现的 timer 泄漏修复

Harness Engineering

• 111 个测试(单元 + 契约 + protocol drift)
• CI 流水线(build + lint + test on PR)
• Pre-commit hook(husky)
• 7 条设计不变量写入 AGENTS.md 并由测试覆盖
• 6 个 harness 测试场景文档

Docs

• AGENTS.md 重写(中文,新架构 + 设计不变量)
• protocol.ts 类型更新(tab/seq/cursor/since)
• README 移除 Extension 安装说明,更新架构图

0.10.0 (2026年03月22日)

Features

• bb-browserd — Pinix capability adapter (3af2b4c)
• bb-browserd CDP direct connection (replaces daemon HTTP) (2ce47c5)
• bb-browserd migrate from WebSocket to Connect-RPC ProviderStream (e730b0e)

Bug Fixes

• open new tabs in background to avoid bringing Chrome to foreground (6d8f18b)

0.9.0 (2026年03月19日)

Features

• add bb-browser-sites skill for OpenClaw (facd29d)
• add fetch and recipe commands (5668470)
• add history, site recommend, site info, --jq, and Agent UX guide (fdb8288)
• add MCP instructions + bb-browser guide command (f0869aa)
• Agent UX guide system + history, site recommend/info, --jq (c1c9bc4)
• cli,mcp: add setup hints when extension/daemon not connected (1f15f3e)
• cli: add --mcp flag to start MCP server (cb28e81)
• cli: add CDP monitor background process for persistent monitoring (Phase 1, #77) (94c94b7)
• cli: add CDP monitor for persistent monitoring (aa3010f)
• cli: add star command and hint in site update (00ed75f)
• cli: auto-check for CLI updates on site update, bump to 0.7.0 (0551493)
• cli: categorize --help output, promote site system (#14) (bed7fbd), closes #13
• daemon: add --host flag to configure listen address (3a69040)
• guide: add bb-browser site adapter as gh CLI alternative (bd9e896)
• mcp: add MCP server for AI agent integration (537e553)
• mcp: add site adapter tools (22d38c1)
• mcp: add site adapter tools (7804f06)
• mcp: auto-start daemon when not running (fa33c5a)
• network requests --with-body captures full request/response data (a2e1f29)
• open 命令支持 --tab 参数,解决并发打开页面冲突 (9582e10)
• set managed Chrome profile name to "bb-browser" (7e5c227)
• site: add --openclaw mode to run adapters via OpenClaw CDP browser (701fa7b), closes #28
• site: add reportHint in error output for agents (de713a2)
• site: auto-detect auth errors and show login hint (c68653b)
• site: include bb-browser site adapter as report alternative (847a995)
• site: silent background update after every site command (638020d), closes #20
• tab select/close 支持按 tabId 操作 (1acfb60)
• v0.8.0 — CDP direct connection, managed Chrome, no extension needed (59ab96b)
• v2.0 CDP 架构迁移 - 使用 chrome.debugger 实现所有 DOM 操作 (827f24d)
• 全局 --tab 参数支持多 tab 并发隔离 (7acd596)
• 切换 snapshot 到 CDP Accessibility Tree (9095463)
• 切换 snapshot 到 CDP Accessibility Tree (e66256a), closes #4
• 实现 bb-browser 核心功能 (601f4ae)
• 实现 close 命令 (b92a8b1)
• 实现 get 命令组 (text/url/title) (028478b)
• 实现 hover 命令 (260e8ce)
• 实现 press 命令 (16f3d84)
• 实现 screenshot 命令 (29c335e)
• 实现 scroll 命令 (0d60f93)
• 实现 wait 命令 (247e21c)
• 实现导航命令 (back/forward/refresh) (91a3398)
• 插件支持配置上游 URL (ca78b45), closes #2
• 插件支持配置上游 URL + 修改后立即重连 (44761b8)
• 添加 check/uncheck 命令 - 复选框操作 (6385279)
• 添加 dialog 命令(accept/dismiss) (8d6e6c1)
• 添加 eval 命令 - 执行 JavaScript (7e6bf96)
• 添加 frame 命令(切换 iframe) (394d7e7)
• 添加 network/console/errors 调试命令 (02edcb4)
• 添加 Phase 3 命令 (eval/type/check/uncheck/select) (bbfda3f)
• 添加 reload 命令支持 CDP 热重载扩展 (530e992)
• 添加 tab 命令(list/new/select/close) (a608124)
• 添加 trace 命令 - 录制用户操作 (f02b081)
• 添加 type 命令 - 逐字符输入 (de22235)

Bug Fixes

• CDP direct mode bugs (snapshot, tab list, discovery) (b0cb83a)
• cli: --tab flag works correctly for all commands (a882809)
• cli: add Chrome Dev/Canary/Beta/Arc to browser detection (#42) (#43) (e7de67c)
• cli: add guide command to help text (09ac697)
• cli: avoid double-inserting typed text (600244d)
• cli: daemon command works in npm-published layout (c3fa112)
• cli: harden OpenClaw JSON parsing (b0b7c7b)
• cli: persist selected target for get commands (578e10f)
• cli: tolerate noisy OpenClaw JSON output (28e0867)
• cli: use viewport coordinates for click targets (92fa9f7)
• cli: wait for extension connection before sending commands (b478226)
• cli: wire top-level status command (3a15411)
• cli: wire top-level status command (c8b1aab)
• cross-pr...

Bug Fixes

• Browser detection: Add Chrome Dev, Chrome Canary, Chrome Beta, and Arc to macOS browser candidate list (#42)
  • Previously, users with Chrome Dev but no standard Chrome would get Edge launched instead
• Build fix: Remove obsolete daemon-era commands (start/stop/status/reload) that caused compilation errors

Install / Update

npm install -g bb-browser@0.8.3

Source: https://x.com/normanmises_/status/2033374248862109929