Repository navigation
Dolly v0.1.5
Dolly v0.1.5: a modular POSIX-like userspace in a browser tab, built from source inside the tab from a C/C++ compiler seed.
This version is https://slopshare.dev/v0.1.5/.
New since v0.1.4
- npm: each package carries the files it serves, so
npm installis the only step that downloads anything. Beside the runtime,dolly-buildand the host modules, npm has the imagesdefault,pi-minimalandpython-dataand the packagescc,git,libffi,python,numpy,python-dateutil,pandas,matplotlibandseaborn, each depending on the packages it installs. A Dollyfile'sFROMandINSTALLrows name installed images and packages:npx dolly-build init NAME PACKAGE...writes one onpi-minimal, andnpx dolly-build Dollyfile-NAME OUTbuilds the image in the local Chrome or Firefox into a directory any static host serves. In the release checks, the README's flow ran afternpm installin Chrome and Firefox with only loopback reachable and made no request beyond the machine. - Lean 4.35 as an amy package (
nena enable stack && amy install lean), built inside Dolly from upstream's stage0.leanchecks a file or runs one with--run, andlakemakes and builds a package, whose Ccccompiles. In the release checks, installing it from the served site and proving anomegatheorem took 44 s in Chrome and 58 s in Firefox. - The demos page (https://slopshare.dev/v0.1.5/agents/) has 34 recordings of Claude Opus 5.5 working in Dolly: in Dollyfile Studio it writes a program and its Dollyfile from one prompt, tests it and builds the image in the browser (games, simulations, a path tracer, a demoscene intro, terminal programs in Python and Go); it lays a pixel-art heart in ClassiCube and learns to bunnyhop in Airtime. Added on 2026-11-07, after the release.
html@0and thehtmlcommand, indefaultandsystem:html [FILE]shows an HTML page or form in a popup and prints the fields the user submits. The popup fetches nothing and runs none of the document's scripts. Pi asks the user questions with it (ask_user) and shows reports (show_html).amy installhasnenaenable the host modules a package needs, in an image that declaresnena@0, asdefaultdoes: thereamy install tmuxenablespty@0andsockets@0, and the browser asks beforeamy install speech-to-textgets the microphone.- Python runs threads, a Worker each and up to 32 a process, where
threading.Threadtargets ran one after another; extension modules andctypescallbacks work in every thread. pip builds an sdist as upstream builds its wheels. - In the repository, not in the site's catalog (
npm run image -- NAMEbuilds them; npm haspython-data):ffmpeg, FFmpeg 9.0.2 with its own codecs, formats and filters, configured by its ownconfigureunder Slop;python-data, NumPy 2.5.4, pandas 3.0.5, Matplotlib 3.10.9 and seaborn 0.13.2 built inside Dolly from PyPI's releases, where a plot saved as PNG shows in the terminal in one kitty graphics escape; andopenblas, OpenBLAS for wasm64. - Rust panics unwind, and
cargo testruns a crate's tests and, with therustdoctherustpackage now holds, a library's doc tests. Cargo fetches a Git dependency withgitthrough the HTTP broker. - C and C++: a C++
catchin a library loaded throughdso@0catches, and a threaded program built withcc -pthread -rdynamicloads libraries and makes FFI closures in every thread.cc -vandcc --versionprint Clang's banner, as configure scripts read it, andcc -Wp,ARGpasses ARG to the preprocessor. - Zig 0.17 and Ghostty 1.4.0 throughout: the
zigandzig-llvmpackages (zig-llvmagainst LLVM 22, thellvm22package), the terminal's Ghostty VT, andghostty-x11, Ghostty's GTK application, which now renders through Mesa's EGL. - An image's packs stay in the browser, checked against their digests at each use: a second start of an image and an opened session download none of them again. The sessions page shows their size and clears them. A save keeps each file's modification time, and an image's files are dated 1980-01-02, so
makein a reopened session sees the times its files had. - The terminal starts in the mode
stty saneleaves, withICRNL, and a non-canonical read honoursVMIN0 andVTIME. Line and block characters fill their cell. Its font is the 0.9 MB of IosevkaTerm's 7.7 MB that holds the glyphs it draws. - A program holding
touch@0shows up to 12 buttons in the page's bar beside Paste.pi-phonehas Speak, Send, Clear and a Menu that shows Pi's models, thinking levels and commands in a popup, and the phone's keyboard shrinks the page instead of covering the bar. - HTTP: a request body may be 64 MiB (it was 8 MiB), and the policy's timeout bounds each wait, not the whole transfer, so a model's answer that streams for more than ten minutes finishes.
- In Chrome, a threaded program no longer stops with
memory access out of boundsafter another thread grows its memory: a process's memory takes its maximum before its second thread starts. A process's memory goes when it ends, not at the browser's next garbage collection. - An upload in Chrome no longer waits forever before its first byte, and in Firefox a session's first run of a large executable, such as
ccafteramy install cc, no longer stays at "preparing … WebAssembly executable": in both, the browser's garbage collector took work that was still pending. - Processes: the kernel knows which signals a program ignores, and they stay ignored across
posix_spawnandexec.systemandpopenrun/bin/slop -cas POSIX has them, zsh'sexecreplaces the shell, and Janis ignores SIGPIPE, as Node does. An image's first process starts in/workspace. - Slop runs
test,[,echo,printf,trueandfalseitself, as other shells have them built in: FFmpeg'sconfiguretakes 31 s in its image build instead of 225 s. Slop hasset -f, splitsread's fields as POSIX does, refuses Bash's((...)),<<<and<(...)by name, and Tab completes under~and in dot directories.gzipcompresses;tarextracts pax and GNU archives, asgit archiveand GitHub write them, with their modification times;sleeptakes a decimal number of seconds;mkdir -m,rm -v -d,diff -sand--brief,xargs -r,patch -l -f. - The
bhopandclassicubegame agents take an Anthropic API key, beside OpenRouter and a local Codex relay.
What stops working
- GitHub Pages (https://daugasauron.github.io/dolly/) is no longer deployed: the one Cloudflare deployment serves slopshare.dev and daugasauron.com.
defaultdeclares ten host modules, no longerthreads@0,dso@0,sockets@0,touch@0oraudio@0.amy installenables those a package needs; a program built in the session that needs one is refused, naming the command (nena enable threads).- A
dolly-buildproject from v0.1.4 movesindex.html,theme.jsonandworkspace/intopublic/, imports./dolly/src/browser.mjsand./image/index.mjswith the isolation linesdolly-build initwrites, dropsserve.mjs(any static server serves the site) and removes its old image directory once. - Dollyfiles:
EXPORTS ENV NAME APPEND VALUEis gone, andREQUIREStakes onlyHOST,TOOL,LIBandHEADER./bin/cdis gone:cdis the shell's. Thellvm21package is nowllvm22.
Known gaps
- An installed package's files are held in the session's memory and its save: after
amy install leana session holds about 3.5 GB more, and a session holdingzig-llvmandcc(580 MB) is over the 512 MiB a save holds. - 0 A.D. in Firefox needs WebGPU on a display with hardware GL.
mojo runwould need a JIT and refuses, saying to usemojo build. File modes andumaskare not part of Dolly.- The Rust seed (stage 0), Dolly's kernel and its libc are still built outside Dolly.
The domain version's file list (deployment.sha256) has SHA-256 f51552e808f035645ac0806c5b1899bb2638b5dc314c81a241fc3b8054ef1444.