Agent Quick Browse
by SkrudjReal
README.md
<div align="center">
# ✦ Agent Quick Browse · Portable
Luna Decisions browser actions for Linux, WSL and Windows.
[](https://github.com/SkrudjReal/agent-quick-browse/issues)
[](https://github.com/SkrudjReal/agent-quick-browse/pulls)
[](https://github.com/SkrudjReal/agent-quick-browse/stargazers)
[](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)
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues