Give your agent a real browser.

Headless turns browser QA into a small, inspectable command surface, so an agent can navigate, test, record, and explain without screen coordinates or a brittle script stack.

See the workflow Read the docs

github.com

live inspect

$headless --session qa inspect --interactive --text

>64 elements · refs @e1–@e64

P2 benchmark / 17 Jul 2026

Smallest agent surface.
Measured, not claimed.

One fresh Linux ARM64 container per case. The same dashboard visit, recording, transition, and final screenshot.

Tokens · vs Selenium + Python64%

fewer estimated agent tokens

Tokens · vs Puppeteer71%

fewer estimated agent tokens

CPU time · vs Selenium + Python56%

less CPU time per run

CPU time · vs Puppeteer66%

less CPU time per run

Agent token footprint / lower is better

Headless warm = 1×

Wall time vs CPU time per run

The gap is waiting, not computing

Workflow	Estimated tokens	Wall time	CPU time	Peak memory
Headlesswarm	147	4.753 s	842 ms	276 MiB
Headlesscold	194	5.002 s	1.478 s	279 MiB
SeleniumPython	410	3.134 s	1.900 s	280 MiB
Puppeteer	499	2.850 s	2.441 s	319 MiB

Warm starts with the Headless host and session ready. Cold includes starting both.Estimated tokens measure workflow source size, not billed LLM tokens. Point-in-time snapshot; repeat before comparing a change.

Read the method

The control loop

From intent to evidence—

without touching the desktop.

Visit

Open a local or authenticated page.

Act

Click, fill, press, scroll, and wait by meaning.

Prove

Return recordings, screenshots, reports, and diffs.

hermes-vm — headless

secure local session

$ headless start ✓ ready

$ headless session create qa

$ headless --session qa visit localhost:3000/designers/dashboard

$ headless --session qa record start --fps 10

$ headless --session qa click --role button --name Continue

$ headless --session qa report create --output pr-report.json ✓ evidence ready

Made for real QA

When the page breaks,
the agent can look closer.

Deep diagnostics are available on demand, not forced into every interaction.

Observe

Accessible elements, rendered media, console, network, CSS, cookies, and storage—only when the agent needs them.

Capture

Browser-pixel MP4 recordings and private PNG artifacts built for frontend QA and PR review.

Reproduce

Reusable flows, visual comparisons, throttling, offline mode, and exact API mocks.

Contain

A private Unix socket, no exposed DevTools port, bounded commands, and safe navigation rules.

Run it where your agent runs

Your VM has a browser
now. Use it.

One CLI protocol. The same commands over MCP. Purpose-built for the last mile of software QA.

Open Headless

Headless began as a fork of antiwork/chromeless . With thanks to Sahil Lavingia for the original foundation.