Usage
Run without installing using npx:
npx browserwire [options]
Flags
| Flag | Description | Default |
|---|
--host | Address the server listens on | 127.0.0.1 |
--port | Port the server listens on | 8787 |
--debug | Enable verbose debug logging | false |
--llm-provider | LLM provider to use: openai, anthropic, gemini, or ollama | — |
--llm-api-key | API key for the selected LLM provider | — |
--extension-path | Print the path to the bundled Chrome extension directory and exit | — |
--help | Show usage information and exit | — |
Configuration precedence
CLI flags take the highest precedence. When the same option is set in multiple places, the order is:
CLI flags > environment variables / .env > ~/.browserwire/config.json > defaults
This means a --port flag always overrides BROWSERWIRE_PORT in your environment, which in turn overrides the value in your config file.
Examples
Start the server with defaults:
Start on a different port:
Start on all interfaces (accessible from other devices on the network):
browserwire --host 0.0.0.0
browserwire --llm-provider anthropic --llm-api-key sk-ant-...
browserwire --extension-path
BROWSERWIRE_LLM_PROVIDER and BROWSERWIRE_LLM_API_KEY are required for discovery to work. If you prefer not to use flags, set them as environment variables or in ~/.browserwire/config.json.
