CLI Reference

Flags

Flag	Default	Description
`--port`	`9222`	CDP WebSocket server port
`--binary`	auto-detect	Path to Firefox or Camoufox binary
`--headless`	`false`	Run browser in headless mode
`--profile`	—	Firefox profile directory
`--backend`	`juggler`	Backend protocol: `juggler` or `bidi`
`--bidi-url`	—	Connect to an existing BiDi WebSocket endpoint instead of launching Firefox
`--bidi-port`	`9223`	Port for BiDi WebSocket when auto-launching Firefox with `--backend bidi`


foxbridge --binary ~/.camoufox/camoufox --port 9222


foxbridge --binary /path/to/camoufox --headless --port 9222


foxbridge --backend bidi --binary /usr/bin/firefox --port 9222

Firefox is launched with --remote-debugging-port and foxbridge connects to the BiDi WebSocket automatically.


foxbridge --backend bidi --bidi-url ws://localhost:9223/session --port 9222


foxbridge --binary /path/to/camoufox --profile /tmp/foxbridge-profile --port 9222

Endpoint	Description
`GET /json/version`	Browser version info + WebSocket URL
`GET /json/list`	Active page targets with WebSocket URLs
`GET /json`	Alias for `/json/list`
`WS /devtools/browser/`	Main CDP WebSocket connection
`WS /`	Convenience alias for WebSocket

If --binary is not specified, foxbridge searches for Firefox/Camoufox in this order:


# Run all tests with race detector
go test -race ./...
 
# Build only
go build ./...

CI runs automatically via GitHub Actions on every push to main.