@ulpi/browse 1.4.4 → 2.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ulpi/browse",
-  "version": "1.4.4",
+  "version": "2.3.0",
   "homepage": "https://browse.ulpi.io",
   "repository": {
     "type": "git",
@@ -13,12 +13,13 @@
     "better-sqlite3": "^11.0.0",
     "diff": "^7.0.0",
     "playwright": "^1.58.2",
-    "playwright-core": "^1.58.2"
+    "playwright-core": "^1.58.2",
+    "yaml": "^2.8.3"
   },
   "bin": {
     "browse": "bin/browse"
   },
-  "description": "Fast headless browser CLI — persistent Chromium daemon via Playwright.",
+  "description": "Fast headless browser and native app automation CLI for AI coding agents. Android, iOS, and macOS.",
   "engines": {
     "node": ">=18.0.0"
   },
@@ -26,6 +27,10 @@
     "bin/",
     "dist/",
     "skill/",
+    "browse-ios-runner/BrowseRunnerApp/",
+    "browse-ios-runner/BrowseRunnerUITests/",
+    "browse-ios-runner/project.yml",
+    "browse-ios-runner/build.sh",
     "LICENSE",
     "README.md"
   ],
@@ -36,9 +41,14 @@
     "headless",
     "cli",
     "ai-agent",
-    "claude"
+    "claude",
+    "android",
+    "ios",
+    "macos",
+    "mobile-testing",
+    "accessibility"
   ],
-  "license": "MIT",
+  "license": "Apache-2.0",
   "publishConfig": {
     "access": "public"
   },

package/skill/SKILL.md

@@ -53,6 +53,7 @@ To avoid being prompted on every browse command, tell the user they can pre-allo
 - The browser persists between calls — cookies, tabs, and state carry over.
 - The server auto-starts on first command. No manual setup needed.
 - Use `--session <id>` for parallel agent isolation. Each session gets its own tabs, refs, cookies.
+- Use `--context` for state changes, `--context delta` for ARIA diff with refs, `--context full` for complete snapshot with refs after write commands.
 - Use `--json` for structured output (`{success, data, command}`).
 - Use `--content-boundaries` for prompt injection defense when reading untrusted pages.
 - Use `--allowed-domains domain1,domain2` to restrict navigation to trusted sites.
@@ -126,6 +127,20 @@ browse provider save browserbase <api-key>
 browse --provider browserbase goto https://example.com
 browse provider list
 browse provider delete browserbase
+
+# Native app automation (Android, iOS, macOS)
+browse sim start --platform android --app com.android.settings --visible
+browse sim start --platform ios --app com.apple.Preferences --visible
+browse --platform android --app com.android.settings snapshot -i
+browse --platform ios --app com.apple.Preferences snapshot -i
+browse --app "System Settings" snapshot -i              # macOS
+browse --platform android --app com.android.settings tap @e3
+browse --platform android --app com.android.settings swipe up
+browse --platform android --app com.android.settings press back
+browse --platform ios --app com.apple.mobilesafari type "example.com"
+browse --app TextEdit press "cmd+n"                     # macOS modifier combos
+browse sim stop --platform android
+browse sim stop --platform ios
 ```
 
 ## Command Reference
@@ -173,6 +188,20 @@ browse attrs @e6          Get attributes of ref @e6
 
 Refs are invalidated on navigation — run `snapshot` again after `goto`.
 
+### Native App Automation
+```
+browse sim start --platform ios|android --app <id> [--visible]  Start simulator/emulator + app
+browse sim stop --platform ios|android                          Stop simulator/emulator
+browse sim status --platform ios|android                        Check runner status
+browse --platform ios --app <bundleId> <command>                Target iOS app
+browse --platform android --app <package> <command>             Target Android app
+browse --app <name> <command>                                   Target macOS app
+```
+
+Supported commands on all app platforms: `snapshot`, `text`, `tap`, `fill`, `type`, `press`, `swipe`, `screenshot`.
+macOS also supports modifier combos: `browse --app TextEdit press "cmd+n"`.
+Android auto-installs adb, Java, SDK, and emulator on first use (macOS via Homebrew).
+
 ### Interaction
 ```
 browse click <selector>        Click element (CSS selector or @ref)
@@ -399,6 +428,10 @@ browse perf-audit [url]                  Full performance audit (Web Vitals, res
 browse perf-audit [url] --no-coverage    Skip JS/CSS coverage collection (faster)
 browse perf-audit [url] --no-detect      Skip framework/SaaS/infrastructure detection
 browse perf-audit [url] --json           Output as structured JSON (for programmatic use)
+browse perf-audit save [name]            Save audit report to .browse/audits/ (auto-names from URL + date if omitted)
+browse perf-audit compare <base> [curr]  Compare saved baseline vs current page or another saved audit (regression detection)
+browse perf-audit list                   List saved audit reports (name, size, date)
+browse perf-audit delete <name>          Delete a saved audit report
 browse detect                            Detect tech stack: frameworks, SaaS platforms, CDN, protocol, compression, caching, DOM complexity, third-party inventory
 browse coverage start                    Start JS/CSS code coverage collection
 browse coverage stop                     Stop collection and report per-file used/unused bytes

package/skill/references/commands.md

@@ -461,6 +461,24 @@ browse react-devtools owners <sel>     Parent component chain
 browse react-devtools context <sel>    Context values consumed by component
 ```
 
+## Performance audit
+```
+browse perf-audit [url]                  Full performance audit (Web Vitals, resources, images, fonts, DOM, coverage, stack detection, recommendations)
+browse perf-audit [url] --no-coverage    Skip JS/CSS coverage (faster)
+browse perf-audit [url] --no-detect      Skip framework/SaaS detection
+browse perf-audit [url] --json           Structured JSON output
+browse perf-audit save [name]            Save audit report to .browse/audits/ (auto-names from URL + date)
+browse perf-audit compare <base> [curr]  Compare saved baseline vs current page or another saved audit
+browse perf-audit list                   List saved audit reports
+browse perf-audit delete <name>          Delete a saved audit
+browse detect                            Tech stack fingerprint (frameworks, SaaS, CDN, infra)
+browse coverage start                    Start JS/CSS code coverage collection
+browse coverage stop                     Stop and report per-file used/unused bytes
+browse initscript set <code>             Inject JS before every page load
+browse initscript show                   Show current init script
+browse initscript clear                  Remove init script
+```
+
 ## Server management
 ```
 browse status                  Server health, uptime, session count