hyperframes browser
Manage the bundled Chromium build that powers HyperFrames renders. Install, list, and prune browser versions.
hyperframes browser manages the Chromium build HyperFrames uses to capture frames. The CLI ships pinned to one Chromium version per release so that renders are deterministic; this command lets you install, list, and prune those builds on disk.
Synopsis
bash
hyperframes browser <subcommand> [flags]Subcommands: install, list, prune.
Subcommands
install
Download and verify the Chromium build matching the current CLI version.
bash
hyperframes browser install [flags]| Flag | Default | Meaning |
|---|---|---|
--version <ver> | matching CLI | Install a specific Chromium build (e.g. 124.0.6367.91). |
--force | off | Re-download even if present. |
--dir <path> | ~/.hyperframes/browsers | Install location. |
list
Print every Chromium build on disk.
bash
hyperframes browser list [--json]prune
Remove Chromium builds no installed CLI version requires.
bash
hyperframes browser prune [--dry-run] [--keep <n>]| Flag | Default | Meaning |
|---|---|---|
--dry-run | off | Print what would be removed; remove nothing. |
--keep <n> | 1 | Keep the n most recent builds in addition to the active one. |
Common invocations
$ hyperframes browser install
downloading chromium 124.0.6367.91 (138 MB)
verified sha256:9f1c...
installed at ~/.hyperframes/browsers/chromium-124.0.6367.91JSON output
json
{
"command": "browser.list",
"status": "ok",
"exit_code": 0,
"active": "124.0.6367.91",
"browsers": [
{ "version": "124.0.6367.91", "path": "/home/me/.hyperframes/browsers/chromium-124.0.6367.91", "size": 412000000, "active": true },
{ "version": "122.0.6261.94", "path": "/home/me/.hyperframes/browsers/chromium-122.0.6261.94", "size": 401000000, "active": false }
]
}browser.install returns the installed version and path; browser.prune returns the removed versions and reclaimed bytes.
Exit codes
0— subcommand succeeded.1— invalid flags or unknown subcommand.5— download or extraction failed (network, disk, or signature mismatch).
Tips
- In CI, run
browser installas a cache-warming step before the render job. Cache~/.hyperframes/browsersbetween runs. - Each Chromium build is 300–500 MB. On dev laptops,
prune --keep 1keeps disk usage flat. - Never copy a Chromium build across operating systems. Always install per-host.
- The active build is whichever version the currently invoked CLI requires — it changes when you
upgrade.
Next
- HyperFrames CLI — full command index.
hyperframes doctor— confirm the installed browser is healthy.