release: v0.2.1 (#58)

* docs: note Windows is not currently supported

* chore: align marketplace version with package.json

* docs: rewrite CHANGELOG with 0.2.0 as initial CLI release

* docs: remove zero startup cost from README features

* feat: add install-skill interactive command

* chore: add rustfmt and prettier with CI checks

* docs: simplify changelog

* docs: add _snapshotForAI to help output

* docs: expand LLM usage guide in help output

* feat: add --timeout flag for script execution

* feat: add snapshot helper for LLM-friendly page inspection

* docs: document snapshotForAI, remove custom snapshot helper

* docs: add approach guidance to LLM help

* release: v0.2.1

Author: SawyerHood

.claude-plugin/marketplace.json

@@ -10,12 +10,20 @@
       "source": "./",
       "description": "Browser automation skill with persistent page state for developers and AI agents",
       "strict": false,
-      "keywords": ["browser", "playwright", "automation", "testing", "debugging"],
-      "skills": ["./skills/dev-browser"]
+      "keywords": [
+        "browser",
+        "playwright",
+        "automation",
+        "testing",
+        "debugging"
+      ],
+      "skills": [
+        "./skills/dev-browser"
+      ]
     }
   ],
   "metadata": {
     "description": "Marketplace for the dev-browser skill",
-    "version": "1.0.1"
+    "version": "0.2.1"
   }
 }

.github/workflows/ci.yml

@@ -32,6 +32,22 @@ jobs:
             daemon/dist/daemon.bundle.mjs
             daemon/dist/sandbox-client.js
 
+  format:
+    name: Format Checks
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+        with:
+          version: latest
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+      - run: cd daemon && pnpm install
+      - run: cd daemon && pnpm run format:check
+      - uses: dtolnay/rust-toolchain@stable
+      - run: cd cli && cargo fmt -- --check
+
   daemon-tests:
     name: Daemon (TypeScript + Tests)
     needs: build-daemon

CHANGELOG.md

@@ -1,13 +1,20 @@
 # Changelog
 
-## [1.0.1] - 2025-12-10
+All notable changes to this project will be documented in this file.
 
-### Added
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-- Support for headless mode
+## [0.2.1] - 2026-03-19
 
-## [1.0.0] - 2025-12-10
+- Added an interactive `install-skill` TUI command to install the skill into `~/.claude/skills/` and `~/.agents/skills/`.
+- Added a `--timeout` flag for script execution with a 30-second default.
+- Documented `page.snapshotForAI()` for LLM-friendly page inspection.
+- Expanded the `--help` LLM usage guide with approach guidance, screenshots, waiting patterns, and error recovery.
+- Simplified the README, added a Windows-not-supported note, and attributed Do Browser.
+- Aligned marketplace versioning with `package.json` and added auto-sync support.
+- Added `rustfmt` and Prettier plus CI format checks.
 
-### Added
+## [0.2.0] - 2026-03-19
 
-- Initial release
+Initial CLI release.

README.md

@@ -2,6 +2,8 @@
   <img src="assets/header.png" alt="Dev Browser - Browser automation for Claude Code" width="100%">
 </p>
 
+Brought to you by [Do Browser](https://dobrowser.io).
+
 A browser automation tool that lets AI agents and developers control browsers with sandboxed JavaScript scripts.
 
 **Key features:**
@@ -10,7 +12,6 @@ A browser automation tool that lets AI agents and developers control browsers wi
 - **Persistent pages** - Navigate once, interact across multiple scripts
 - **Auto-connect** - Connect to your running Chrome or launch a fresh Chromium
 - **Full Playwright API** - goto, click, fill, locators, evaluate, screenshots, and more
-- **Zero startup cost** - Rust CLI binary, Node daemon runs in the background
 
 ## CLI Installation
 
@@ -19,6 +20,8 @@ npm install -g dev-browser
 dev-browser install    # installs Playwright + Chromium
 ```
 
+> Windows is not currently supported.
+
 ### Quick start
 
 ```bash
@@ -88,18 +91,7 @@ await readFile(name)              // Read file, returns content
 console.log/warn/error/info       // Routed to CLI stdout/stderr
 ```
 
-Pages are full [Playwright Page objects](https://playwright.dev/docs/api/class-page) — `goto`, `click`, `fill`, `locator`, `evaluate`, `screenshot`, and everything else.
-
-## Architecture
-
-```
-Rust CLI → Unix socket → Node.js daemon → QuickJS WASM sandbox → Playwright → Browser
-```
-
-- **Rust CLI** — near-instant startup, auto-starts the daemon
-- **Node.js daemon** — manages browser instances, persists between runs
-- **QuickJS sandbox** — scripts can't access filesystem, network, or host process
-- **Playwright** — drives Chromium via CDP
+Pages are full [Playwright Page objects](https://playwright.dev/docs/api/class-page) — `goto`, `click`, `fill`, `locator`, `evaluate`, `screenshot`, and everything else, including `page.snapshotForAI({ track?, depth?, timeout? })`, which returns `{ full, incremental? }` for AI-friendly page snapshots.
 
 ## Benchmarks