Windows Setup

  

Windows setup

With the installer (recommended)

1. Download BrowserForge-Setup-<version>.exe from the latest release (file BrowserForge-Setup-0.2.0.exe). Windows 10 or newer, 64-bit.
2. Run it. If Windows says "Windows protected your PC", choose More info, then Run anyway. The installer is not code-signed yet (tracked here).
3. It installs for your user only (no administrator rights) into %LOCALAPPDATA%\Programs\BrowserForge, with its own copy of Node.js, and adds the browserforge command to your PATH.
4. On the last page keep Show the setup steps ticked: it prints your extension token and the command to connect Claude Code or Codex.
5. Install the extension from the Chrome Web Store or Firefox Add-ons, open its popup, paste the token, press Connect.

Start menu: BrowserForge server (keep this window open while your agent works), BrowserForge dashboard, Setup steps and tokens, store links. Tick Start the BrowserForge server when I sign in if you want it to start automatically.

Your data (settings, tokens, flows, logs) lives in %APPDATA%\browserforge. Uninstalling removes the program and its PATH entry and keeps that folder.

Connect Claude Code from PowerShell

claude mcp add --transport http browserforge http://127.0.0.1:7345/mcp --header "Authorization: Bearer $((Get-Content "$env:APPDATA\browserforge\mcp-token").Trim())"

browserforge setup prints this with your real paths. For Codex see Connect-an-Agent.

Without the installer

Install Node.js 22, then npm install -g @el-makina-ai/browserforge-mcp and browserforge setup. Plugins that run programs (RenderCV) need the program's full path in their settings, for example C:\Users\you\rendercv\.venv\Scripts\rendercv.exe.

Known differences on Windows

• Windows does not enforce the private-folder modes Linux uses; the folder is protected by your user profile's permissions. Do not move it to a shared drive.
• Chrome shows a "Disable developer mode extensions" notice after each restart if you load the extension unpacked; the store version does not.
• Everything was first written and run on Linux. Please report problems.

Details: docs/INSTALL.md.