What’s different about the desktop app
With the CLI, you install the Chrome extension separately and use a Chrome sidepanel to control discovery. The desktop app replaces both:- The embedded browser pane is fully instrumented — no extension installation needed
- Discovery controls sit alongside the browser in the same window
- The same REST API runs on port
8787, so any agent or tooling that works with the CLI also works with the desktop app
Getting started
Download the latest release for your platform from the BrowserWire releases page. Open the downloaded file and follow the standard installation steps for your OS.On macOS, if you see a Gatekeeper warning on first launch, right-click the app and choose Open to bypass it.
Configuring your LLM provider
Before you can run a discovery session, you need to configure an LLM provider. The desktop app needs a vision-capable model to analyze page content during discovery.- Open Settings from the menu bar (BrowserWire → Settings) or press
Cmd+,/Ctrl+, - In the Settings panel, select your LLM provider (OpenAI, Anthropic, Gemini, or Ollama)
- Enter your API key
- Save your settings
| Provider | Default model | Requires API key |
|---|---|---|
| OpenAI | gpt-4o | Yes |
| Anthropic | claude-sonnet-4-20250514 | Yes |
| Gemini | gemini-2.5-flash | Yes |
| Ollama | llama3 | No |
Panels
The desktop app has four main panels, accessible from the activity bar on the left side of the window.Discovery
The default view. The embedded browser takes up most of the window, with a control panel on the right.- Use the address bar at the top to navigate to a site
- Click Start Exploring to begin a session — the browser is now instrumented and capturing
- Browse the site normally: navigate pages, open menus, interact with forms
- Click Stop Exploring when done — the app processes the session and builds the manifest
History
Review past exploration sessions. Select a session to see what was captured: which pages were visited, how many snapshots were taken, and the resulting manifest content. After you stop exploring, the app switches to the History panel automatically and selects the session you just completed.Execution
Test discovered actions and workflows directly from the desktop app, without needing to usecurl or a separate API client. Select a site, choose an operation, fill in any inputs, and run it — the embedded browser executes the action on the live page.
Settings
Configure your LLM provider, API key, and other preferences. Changes take effect for the next discovery session.The REST API
The BrowserWire server runs on port8787 while the desktop app is open, exposing the same REST API as the CLI: