browse: Browser & Native App Automation for AI Agents

Target Decision — ALWAYS check this first

Before running any browse command, decide the correct target:

User wants to...	Target	Command pattern
Open a URL, test a website, scrape web content	Browser (default)	`browse goto <url>`
Test a local dev server (`localhost`)	Browser	`browse goto http://localhost:3000`
Browse a site that blocks bots (Cloudflare, Turnstile)	Camoufox	`browse --runtime camoufox --headed goto <url>`
Browse with a specific camoufox fingerprint profile	Camoufox	`browse --runtime camoufox --camoufox-profile <name> --headed goto <url>`
Search Google, YouTube, Amazon, etc.	Browser	`browse goto @google "query"`
Interact with an iOS app (Settings, Safari, custom app)	iOS Simulator	`browse --platform ios --app <bundleId> <cmd>`
Interact with an Android app (Settings, Chrome, custom app)	Android Emulator	`browse --platform android --app <package> <cmd>`
Interact with a macOS desktop app (System Settings, TextEdit)	macOS App	`browse --app <name> <cmd>`
Install and test an iOS .app or .ipa file	iOS Simulator	`browse sim start --platform ios --app ./MyApp.app --visible`
Install and test an Android .apk file	Android Emulator	`browse sim start --platform android --app ./app.apk --visible`