﻿# Get started

OpenBrowserHarness ships as a Chrome/Edge MV3 extension. You build it from source and load it unpacked.

Prefer not to build? Every [GitHub release](https://github.com/clear2x/openbrowserharness/releases/latest) carries a ready-to-install zip: download it, unzip, and load the folder as unpacked — the rest of this page still applies.

## Requirements

- Node.js ≥24.9 and pnpm, to build (the workspace `engines` field enforces it).
- Chrome or Edge ≥134 — the side panel uses newer JavaScript features.

## Build and load

```sh
git clone https://github.com/clear2x/openbrowserharness.git openbrowserharness
cd openbrowserharness
pnpm install
NODE_OPTIONS=--max-old-space-size=4096 pnpm run build:lib
pnpm run build:extension
```

The lib build compiles the whole workspace package set and needs the larger heap shown above (the same setting CI uses); a default-heap build can fail with an out-of-memory error partway through.

In Chrome or Edge, open `chrome://extensions` (or `edge://extensions`), enable Developer mode, choose **Load unpacked**, and select `apps/extension/dist`.

The panel opens on a welcome screen:

![The OpenBrowserHarness welcome view: the product mark, one-line positioning, three example prompts, and the composer](./sidepanel-welcome.png)

## Configure a model

Click the extension's toolbar icon to open the side panel, open Settings, and pick a provider — DeepSeek and Zhipu GLM ship as presets — then paste your API key. See [Configure models](./providers.md) for custom endpoints and reasoning-effort settings.

## Run your first task

Type a task into the composer, for example: "Open the Google Chrome article on Wikipedia and summarize it in three takeaways."

The agent plans the task, opens a tab, reads the page, and answers in the panel. While it works you see the virtual cursor move over the real page, and the browser shows its "started debugging" banner because input is driven through the Chrome DevTools Protocol.

![A finished task: the tool call to tabs_open, then a three-point summary of the Google Chrome article](./sidepanel-task.jpg)

## Approvals

Depending on the permission tier, a tool action either runs at once or raises an approval card in the panel and waits for your click. New sessions start in full access; use the shield chip in the composer to tighten to per-change or per-action confirmation at any time. See [Permissions and safety](./permissions.md).

## Sessions survive restarts

Conversations are event-sourced into the browser's IndexedDB. If the browser reclaims the agent process, the next message repairs the session and resumes the same conversation.
