A minimal headless browser for AI agents. One binary, no layout, no paint.
An agent reading a web page needs its text, its links and its controls. It does not need pixels. scrim drops everything that exists only to produce them — layout, painting, images, fonts, animations — and keeps everything that decides what the page says: the DOM, page JavaScript, the cascade rules that hide content, cookies, navigation and forms.
On a 34-task agent suite it passes everything headless Chrome passes, and reads visible text with
100.0 % recall and 99.9 % precision against Chrome's innerText.
Same machine (Apple M5), same page — a 1.4 MB saved copy of the Wikipedia article on Rust, served from localhost. Cold process per run, runs interleaved so a load spike hits every browser equally.
| scrim | Obscura 0.2.7 | Chrome 157 headless | |
|---|---|---|---|
| Peak memory reading the page | 20 MB | 52 MB | 804 MB |
| Binary | 50 MB, one file | 69 MB + 66 MB worker | 1.4 GB app bundle |
| Page load, p50 of 11 | 35.6 ms | 262.9 ms | 641.8 ms |
| Startup, trivial page, p50 of 11 | 8.5 ms | 15.6 ms | ~1200 ms to launch |
| Agent tasks passed, of 34 | 34 | not run | 34 |
| Visible-text recall / precision | 100.0 / 99.9 % | not run | reference |
| Anti-detect | none | built in (stealth build) | none |
40× less memory than Chrome, 18× faster to read the page, and the startup overhead is two orders of magnitude smaller. Anti-detect is the one row where Obscura wins outright: scrim has none.
scrim normally does no layout at all; these are its optional screenshot path (--screenshot),
which is the only place it runs one. Chrome is the reference.
| Chrome 157 | scrim | Obscura 0.2.7 |
|---|---|---|
![]() |
![]() |
![]() |
scrim matches Chrome's column widths, infobox placement and line breaking. Obscura's render of the same bytes overflows the infobox past the viewport and squeezes the article column to about a hundred pixels.
brew install strelov1/scrim/scrimOr take the binary straight from the release:
curl -L https://github.com/strelov1/scrim/releases/download/v0.1.0/scrim-0.1.0-macos-arm64.tar.gz | tar xz
./scrim --versionmacOS 14 or newer on Apple Silicon; the bundled V8 is built with chained fixups and will not link on anything older. Every other platform: build from source, below.
scrim fetch <url> [--dump text|markdown|snapshot|html|links] [--eval js]
scrim fetch <url> --screenshot out.png [--width W] [--height H] [--full-page]
scrim serve # JSON lines on stdin/stdout, one long-lived session
scrim --session DIR <command> [args] # stateless: one process per call, no daemonCommands in serve and --session: goto click fill select press scroll back
forward reload eval wait text markdown snapshot links html url cookies.
Elements are addressed the way an agent sees them in a snapshot, not by brittle CSS:
scrim --session /tmp/s goto https://example.com/jobs
scrim --session /tmp/s snapshot # accessibility-style tree with refs
scrim --session /tmp/s click 'role=button:All filters'
scrim --session /tmp/s fill 'label=Email' me@example.com
scrim --session /tmp/s textLocators: role=button:Save, label=Email, text=Continue, css=.foo, or a ref from the
snapshot such as e152.
Needs a Rust toolchain. On macOS the prebuilt V8 archive requires a 14.0 deployment target:
MACOSX_DEPLOYMENT_TARGET=14.0 cargo build --release --manifest-path scrim/Cargo.toml./cargo.sh build --release --manifest-path scrim/Cargo.toml does the same with a repo-local
CARGO_HOME and an empty environment, so the build depends on nothing outside the checkout.
The first build downloads a prebuilt librusty_v8.a (~147 MB); V8 itself is not compiled.
- No layout, no paint, no images or fonts. Nothing an agent reads depends on them.
- CSS reduced to what hides content. Only
display,visibilityandcontent-visibilityare kept;@mediais evaluated at a fixed 1280×800. - No JavaScript engine for script-less pages. Their cascade and text are computed in Rust
(
src/native.rs), a line-by-line port ofjs/style.jsandjs/agent.js. SettingSCRIM_NO_NATIVE=1forces the JS path; the two are kept byte-identical. - The engine fits the page. QuickJS for kilobytes of script because it starts faster; V8 above 256 KB because a JIT pays off for megabytes. One V8 isolate per process, reused.
- Virtual time. With nothing in flight the clock jumps to the next timer, so
setTimeoutchains and debounces cost nothing. - Settle, don't poll. Every action returns once microtasks, network, timers, navigations and frames are quiet.
Screenshots are the one exception: on request the current DOM is styled, laid out and painted by
Blitz (scrim/src/render.rs). Reading still needs no layout.
| Path | What |
|---|---|
scrim/src/ |
the Rust engine: parsing, CSS, network, JS hosts, native read path, rendering |
scrim/js/ |
the JS platform the page runs against: DOM, HTML, style, window, agent |
The corpus, the 34-task suite and the comparison harness the numbers above come from live in a separate research repository; this one is the browser.
- Dynamic
import()from a classic inline script fails (Error resolving module … from 'eval_script'): the resolver gets the eval's name instead of the document URL. Module scripts are fine. This is how Vite-built apps bootstrap, so SvelteKit, Astro and similar pages serve their SSR HTML correctly but never hydrate. - No WebGL, canvas pixels, media playback, service workers or extensions.
- Screenshots use the host's installed fonts; a page's webfonts load, but emoji coverage depends on the machine.
A scrim is the theatre gauze that looks like a solid wall or turns transparent depending on where the light is. Same idea here: the page's content comes through, its presentation does not.
MIT — see LICENSE.


