Skip to content

docs(readme): hero cast — clean-host hub-pull → fork 100 microVMs#252

Merged
WaylandYang merged 1 commit into
mainfrom
docs/readme-hero-cast
Jun 19, 2026
Merged

docs(readme): hero cast — clean-host hub-pull → fork 100 microVMs#252
WaylandYang merged 1 commit into
mainfrom
docs/readme-hero-cast

Conversation

@WaylandYang

Copy link
Copy Markdown
Contributor

Proof-first conversion move. The README led with prose — a watcher couldn't see the headline ("Fork 100 microVMs in 101 ms") being true without reading + setting up a host. This pins an unedited asciinema cast at the top: forkd pull a now-portable hub snapshot (post-#242), then fork 100 microVMs — 100/100 alive, ~200 ms wall-clock (~82 ms of it the parallel restore).

  • Real run on a clean host (privileged container, zero prior forkd state).
  • 152 KiB GIF; the .cast is committed too, so it's re-recordable in ~60 s when the numbers improve (e.g. once the FC MAP_SHARED RFC lands and live-fork needs no vendored fork).
  • Honest caption: first pull also fetches the rootfs sidecar once; cached in this recording.

Pairs with the (internal) runner-vs-watcher scoreboard now baselined — the cast is the artifact that gives the unfired r/rust war-story something that converts instead of landing curiosity on prose.

Test plan

  • GIF renders in the README preview
  • CI green (docs only)

🤖 Generated with Claude Code

Conversion-funnel move (the "proof first" plan): the README led with
prose; a watcher couldn't see the headline claim being true without
reading and then setting up a host. This pins an unedited asciinema
cast at the top — `forkd pull` a now-portable hub snapshot (post-#242),
then fork 100 microVMs: 100/100 alive in ~200 ms wall-clock, ~82 ms of
that the parallel restore.

Real run, recorded on a clean host (privileged container, no prior
forkd state). The .cast is committed alongside the .gif so the artifact
is re-recordable in ~60 s when the numbers improve (e.g. once the
Firecracker MAP_SHARED RFC lands and the live path needs no vendored
fork). Honest caveat in the caption: first pull fetches the rootfs
sidecar once; it's cached in this recording.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@WaylandYang WaylandYang merged commit 63d3909 into main Jun 19, 2026
2 checks passed
@WaylandYang WaylandYang deleted the docs/readme-hero-cast branch June 19, 2026 20:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant