webCLI

webCLI #

A family of browser tools that take a URL or a file and return an artifact, with your content processed on your device and no account; the paper explains the architecture. Loading code and models, and publishing to a repository, are the two declared exceptions below.

The contract #

Zero-egress is about your content, not about downloading the application. Each card declares what the tool fetches; hls and blog also publish to a repository when you ask them to.

The agent surface #

Implemented today by rig, look, portrait (3 of 12 tools). The other tools do not have it yet.

// wait for the operation to finish, then read the handle
await page.waitForSelector('body[data-webcli-status=done], body[data-webcli-status=error]');
const result = await page.evaluate(() => window.__webcli_result);

Tools #

12 tools, grouped by what they transform. In params, brackets mark optional values. A state of early names its limits; working links passing gates.

Video and audio #

ffmpeg-webCLI: a video drop zone, trim sliders and operations for converting, resizing, extracting audio and GIF.

ffmpeg no run= yet early #

in
a video, audio or image file from your device
out
that media trimmed, converted, scaled or compressed, or as a GIF or extracted audio
not
hls, which only builds and manages adaptive-streaming libraries; this one is the general transforms
egress
none: your content stays on the device
fetches
code:cdnjs, code:jsdelivr
repro
not verified

No gate table yet and no run= surface.

source · GPL-3.0

hls no run= yet working #

in
an MP4 and the git repository it should live in
out
a versioned adaptive-streaming release (ladder, segments, playlists) committed and tagged name/vN
not
ffmpeg, which does general transforms and keeps nothing; this one does exactly one thing
egress
user-initiated
fetches
not audited yet
repro
not verified

Publishing is a commit to your repository, so it is egress, and it is yours to start. H.264 only; variable-frame-rate and rotated files are refused by name.

source · GPL-3.0 · passing gates

whisper-webCLI: audio transcription and subtitle controls.

whisper no run= yet early #

in
an audio or video file from your device
out
a transcript as text, SRT or WebVTT
not
dub, which goes the other way, from subtitles to speech
egress
none: your content stays on the device
fetches
code:cdnjs, code:jsdelivr, weights:huggingface
repro
not verified

No gate table yet and no run= surface. The Whisper model is downloaded on first use.

source · GPL-3.0

dub-webCLI: subtitle input and timed speech controls.

dub no run= yet working #

in
an SRT file
out
one WAV with every cue spoken at its timestamp, and a report.json of overruns and collisions
not
whisper, which turns speech into text; this only writes speech, and never time-stretches a cue
egress
none: your content stays on the device
fetches
weights:huggingface
repro
same input, same bytes (tested)

Byte-identical output holds on the wasm device with q8, not on webgpu. No run= surface yet.

source · GPL-3.0 · passing gates

3D and motion #

3mf-webCLI: a 3D model preview and multi-material printing controls.

3mf no run= yet early #

in
a GLB model
out
a 3MF with its materials segmented by colour, for multi-material printing
not
rig, which bakes motion into an animated GLB; this converts one model to one print format and animates nothing
egress
none: your content stays on the device
fetches
code:cdnjs, code:jsdelivr
repro
not verified

GLB in, 3MF out, nothing else. No gate table yet and no run= surface.

source · GPL-3.0

mocap-webCLI: motion capture and recording controls.

mocap no run= yet early #

in
a webcam or a video file of a person
out
body motion as a BVH and face motion as ARKit blendshapes JSON
not
rig, which retargets motion onto a character you bring; this one only records, and bakes only onto its two bundled avatars
egress
none: your content stays on the device
fetches
nothing
repro
not verified

The source repository is private, so there is no open licence yet. One webcam cannot give studio-grade face and body at once. First load is about 100 MB.

source: private · unpublished

rig-webCLI: character, motion and retargeting controls.

rig run= yes early #

in
a skinned character (FBX, GLB or VRM) and motion files (BVH, FBX or GLB)
out
one optimized animated GLB carrying each motion as its own track
not
mocap, which records motion from a camera; this one watches nothing and retargets motion that already exists
egress
none: your content stays on the device
fetches
input-urls:user-named; if enabled: code:esm-run, weights:huggingface
repro
same input, same bytes (tested)
params
character= motion= (repeatable) [map=] [args=] [run=bake]
result
window.__webcli_result = { ok, op: 'bake', artifact: { mime, name, size, dataUrl } | null, error: string | null, meta: { tracks, frames, fps, mapped, bones, units, blendshapes } }
testids
character-input, motion-input, bake, command, run, result, download

The optional in-page assist is off by default; turning it on downloads about 1 GB of model weights. Its tests are not yet published as a gate table.

source · GPL-3.0

Images #

magick-webCLI: image input, processing controls and an output preview.

magick no run= yet early #

in
image files from your device
out
those images converted between 100+ formats, or edited with chained, batchable operations
not
look, which edits the textures and materials of a VRM avatar; this one edits pictures and knows nothing of avatars
egress
none: your content stays on the device
fetches
code:cdnjs, code:jsdelivr
repro
not verified

No gate table yet and no run= surface.

source · Apache-2.0

look-webCLI: a VRM chooser and texture, material and blendshape editing tabs.

look run= yes early #

in
a VRM avatar
out
the same avatar, as a VRM, with its textures, materials, outfits or accessories changed
not
portrait, which reads a face from a photo and binds it to a VRM; this one never sees a photo
egress
none: your content stays on the device
fetches
input-urls:user-named
repro
not verified
params
vrm= [run=export]
result
window.__webcli_result = { ok, op: 'export', artifact: { mime, name, size, dataUrl } | null, error: string | null, meta: { source, bytesIn, bytesOut, vrmVersion } }
testids
vrm-input, vrm-url, load, sample, download, result

The editor re-exports through its own writer, so the output is not a byte-audited edit of the input. Determinism is measured on the two bundled bases only.

source · GPL-3.0

portrait-webCLI: a face photo chooser, a base VRM picker and a Bind button.

portrait run= yes early #

in
a photo of one face and a base VRM
out
that VRM with its expressions bound to the face read from the photo
not
look, which edits an avatar's textures and outfits by hand; this one reads a face, and its result is not a likeness
egress
none: your content stays on the device
fetches
input-urls:user-named
repro
not verified
params
[vrm=male|female|<url>] [run=bind] [download=1]
result
window.__webcli_result = { ok, op: 'bind', artifact: { mime, name, size, dataUrl } | null, error: string | null, meta }
testids
bind, download, face-input, photo-input, result, status, vrm-input, vrm-url

Approximate, not a likeness. One clear front-facing face. The photo is read from a local file only, so a run needs a person or a runner with the file.

source · GPL-3.0

Text and publishing #

blog no run= yet early #

in
markdown posts in a GitHub repository
out
static HTML pages, a feed and a sitemap committed back to that repository
not
hls, which makes the video releases a post can embed; this one encodes no video
egress
user-initiated
fetches
not audited yet
repro
not verified

Publishing is a commit to your repository, so it is egress, and it is yours to start. Its own test suite had 5 failures of 598 on 2026-11-15. Every page it generates loads Font Awesome from cdnjs, with no way to turn that off.

source · GPL-3.0 (tool), MIT (runtime)

chat-webCLI: an on-device model selector and conversation interface.

chat no run= yet early #

in
text you type
out
a reply from a language model running on your own GPU
not
blog, which writes to a repository and publishes; this one keeps conversations in this browser and sends them nowhere
egress
none: your content stays on the device
fetches
code:cdnjs, code:jsdelivr, code:esm-run, code:github-raw, weights:huggingface
repro
not verified

Needs WebGPU. Model weights are downloaded on first use. Conversations are saved in this browser's localStorage. No gate table yet.

source · GPL-3.0

A worked example #

ImageMagick in a tab: sepia on a 480 by 320 PNG, nothing uploaded

magick-webCLI after a sepia run: the input gradient on the left, the sepia-toned output on the right, and the log line 'Done: sepia 80%'.
magick-webCLI after a sepia run: the input gradient on the left, the sepia-toned output on the right, and the log line 'Done: sepia 80%'.

14 requests during page load and the run: 9 to magick.webcli.app, 3 to cdnjs.cloudflare.com (icon font), 2 to cdn.jsdelivr.net (ImageMagick WebAssembly). All were GETs and none carried a body, so the image was in no request.

Historical measurement, verified 2026-10-20, Chromium, magick.webcli.app; not a new audit of the current application. Open DevTools, Network, then drop an image and press Process. magick has no run= surface yet, so this is the interactive path; the cards say which tools can be driven from a URL today.

What all twelve share #

Stated once here, so it cannot drift across twelve READMEs. The left column is the claim; the right is what has been measured, and where nothing has been measured it says so.

ClaimMeasured today
A persistent egress ledger that reads zero12 of 12 made no non-GET request, sent no request body and made no request after the network was cut, from load to idle (2026-11-16). A representative operation is written for 0 of 12.
connect-src 'none' once loaded0 of 12. 4 ship a Content-Security-Policy at all.
No credentials reachable from a workerNot measured.
Refusals by name rather than silent approximationNot measured across the family.
An open licence11 of 12; the source of mocap is not public yet.
Operates offline once loadedNot measured.

Two exceptions, and they are part of the claim. Loading is egress: fetching the WebAssembly core and any model is a request, always a GET with no body, and each tool's fetches in tools.json names what it fetches. Publishing is egress the user starts: hls and blog commit to a repository, and nothing is sent until you press Publish; hls says so in its Privacy and Egress section.

The ledger, per tool #

Each tool's origin was loaded in a fresh Chrome profile with the cache off, left idle for 8 s, then the network was cut and it was left idle for 5 s more; every request was logged from the DevTools protocol. Hosts other than the tool's own are what it fetched while loading, the first exception above. Non-GET and body bytes count anything that is not a bodiless GET. No tool was operated (that is 0 of 12 representative operations written), so this is load and idle, not use.

ToolRequests at loadHosts other than its ownNon-GETBody bytesAfter the cut
ffmpeg15cdn.jsdelivr.net, cdnjs.cloudflare.com000
hls22none000
whisper12cdn.jsdelivr.net, cdnjs.cloudflare.com000
dub7none000
3mf16cdn.jsdelivr.net, cdnjs.cloudflare.com000
mocap26none000
rig31none000
magick11cdnjs.cloudflare.com000
look15none000
portrait38none000
blog103none000
chat8cdn.jsdelivr.net, cdnjs.cloudflare.com, esm.run000

Measured on this page #

This page makes no request to any other host; CI loads it with a cold cache and fails on the first request that is not to its own origin, and the same check can be repeated in DevTools, Network, with Disable cache on.

Lab measurement of this page, median of 5: 0 JavaScript files, 3 requests, 148.7 KB transferred, first contentful paint 664 ms, largest contentful paint 664 ms, total blocking time 0 ms.

Method: blog-webCLI's cli/speed.mjs in headless Chrome: Slow 4G (1.6 Mbit/s down, 150 ms round trip), 4x CPU slowdown, a 390 px phone, a new browser profile for every run with the cache off, 5 runs, median reported; FCP and LCP from PerformanceObserver, total blocking time summed from long tasks after first paint; JavaScript counted from the network log. Lab data from one machine, served from 127.0.0.1, so the throttle supplies the latency but not DNS, TLS or distance; measured 2026-11-16.

For agents and scripts #

The tools are meant to be driven by a URL and to return an artifact; 3 of 12 (rig, look, portrait) have the run= surface today. tools.json is the machine-readable index of this page: for each tool its origin, what it fetches and, where it has one, that surface (parameters, window.__webcli_result, test ids). Nothing here needs an account; the two tools that publish are the exception stated above.

curl -s https://webcli.app/tools.json
curl -s https://webcli.app/tools.json | jq -r '.tools[] | select(.agent) | .origin'

The machine-readable index carries schema 3. A breaking change bumps that number; each entry declares its origin, state, inputs, outputs, egress, fetches and agent surface.

Privacy and licences #

Processing happens on your device. Loading can fetch code, models and input URLs; publishing is an explicit action that sends content to your repository. Each card names its boundary. This index itself makes no third-party requests and runs no JavaScript.

How the claim is checked:

Licences #

Vendored components keep their own notices.

Index updated 2026-11-15. tools.json · the paper (arXiv)