Skip to main content
Glama
README.md
<div align="center">

# ✦ Agent Quick Browse · Portable

Luna Decisions browser actions for Linux, WSL and Windows.

[![Issues](https://img.shields.io/github/issues/SkrudjReal/agent-quick-browse?style=for-the-badge&color=c4b5fd&labelColor=19152e)](https://github.com/SkrudjReal/agent-quick-browse/issues)
[![Pull requests](https://img.shields.io/github/issues-pr/SkrudjReal/agent-quick-browse?style=for-the-badge&color=a5b4fc&labelColor=19152e)](https://github.com/SkrudjReal/agent-quick-browse/pulls)
[![Stars](https://img.shields.io/github/stars/SkrudjReal/agent-quick-browse?style=for-the-badge&color=f0abfc&labelColor=19152e)](https://github.com/SkrudjReal/agent-quick-browse/stargazers)
[![Forks](https://img.shields.io/github/forks/SkrudjReal/agent-quick-browse?style=for-the-badge&color=c4b5fd&labelColor=19152e)](https://github.com/SkrudjReal/agent-quick-browse/forks)

[Quick start](docs/setup.md) · [Features](#features) · [Verification](docs/verification.md) · [Issues](https://github.com/SkrudjReal/agent-quick-browse/issues)

</div>

Portable adaptation of [Zach Sents's Agent Quick Browse](https://github.com/zachsents/agent-quick-browse), based on `f700139`. Maintained here for Linux, WSL and Windows; the upstream MIT attribution is preserved.

A decision model chooses browser actions while a calling agent supplies goals and text. Existing Chrome sessions stay available through the extension. Standalone release binaries include Bun.

## Features

| Capability           | Implementation                                    |
| -------------------- | ------------------------------------------------- |
| Luna Decisions       | Direct `OPENAI_API_KEY`, text or screenshot input |
| Other models         | Existing Jev and Clef adapters                    |
| Agent interface      | CLI and stdio MCP                                 |
| Linux                | Chrome / Chromium, private Unix socket            |
| Windows              | Chrome, per-user native host and named pipe       |
| WSL + Windows Chrome | Local executable bridge; model keys stay in WSL   |
| Release assets       | Linux x64 TAR.GZ, Windows x64 ZIP, SHA256SUMS     |

## Quick start

Download the archive for your OS from [Releases](https://github.com/SkrudjReal/agent-quick-browse/releases/latest), extract it, keep its files together and run:

```bash
./aqb setup
export OPENAI_API_KEY='YOUR_KEY'
./aqb run 'Open the Ask HN page' --url https://news.ycombinator.com --model luna
```

Load the extension folder printed by setup before the first browser command. On Windows use `aqb.exe` and PowerShell environment syntax. For WSL with Windows Chrome, configure `setup --windows-exe /mnt/c/.../aqb.exe`. See the [platform instructions and MCP configuration](docs/setup.md).

Supply input strings with `--fact name=value`. Split long workflows into small goals and verify their results. The DOM reader still does not traverse iframe or Shadow DOM; a model's `done` status is not an independent success check.

[Release notes](docs/releases.md) · [Test evidence](docs/verification.md) · [Original documentation and benchmarks](docs/upstream.md) · [MIT license](LICENSE)