Demo media¶
The board image and animation in the README and these docs (docs/assets/board.png, docs/assets/demo.gif, docs/assets/demo.webm)
are recorded from the real daemon and GUI, driven by a scripted stand-in for claude. Nothing in them is mocked
up by hand, and no real agent, GitHub account or network is involved.
Record¶
scripts/demo.sh
It needs, all from distro packages plus the Rust toolchain: Xvfb, ffmpeg (with libx264 and libvpx), git, xwininfo, Mesa software GL, cargo and sha256sum. It names whatever is missing and stops.
The script builds the daemon, the GUI and the demo binaries (release), then runs everything in a throwaway world: a
temp HOME under /tmp with its own config.toml and gui.toml (dark theme), the first
free port from 7990 and the first free X display from :90. Your own daemon and settings are never
read or touched. It records the window with ffmpeg, and on exit (also on failure or Ctrl-C) it stops only the
processes it started and removes the temp folder.
It writes:
docs/assets/demo.webm(the docs site's hero) anddocs/assets/demo.gif(the README's, which GitHub cannot play as video). The GIF is encoded at full width and 15 fps, and steps down only to stay under 5 MB,docs/assets/board.png, the frame atstill_at,demo/demo.lock, the fingerprint of the inputs the media was recorded from.
Regenerating is a deliberate change: look at the media, then commit docs/assets/ and demo/demo.lock together.
Recordings are never byte-identical, so commit them only when something the demo shows has changed.
What drives it¶
demo/scenarios/: one file per task. The demo agent (fleet-demo-agent, set as the temp daemon'sclaude_command) picks the scenario whosetaskmatches its prompt and plays it: transcript lines, tool calls, questions and permission prompts that wait for an answer, and files it writes and commits (fromdemo/scenarios/content/).demo/timeline.toml: the shot. The persona, when each task is started, when each answer and follow-up is sent, when the side panel opens on which tab and when it closes, the cliplengthand thestill_atmoment for the PNG.fleet-demo-directorplays it over the daemon's HTTP API, the same calls a click on a card makes. Before the GUI starts it also creates the productpiewith the demo's bakery repo, and the script names it asactive_productin the tempgui.toml, so the recording opens on that product's board.demo/bin/gh: a stand-inghthat reports logged in.
The GUI is steered only through a cue file (the FLEET_GUI_CUES environment variable, set by the script): the
director appends open <agent-id> terminal|diff or close, and the GUI acts on it as it would on a click. There is
no synthetic input. Tune the shot in the timeline and scenarios; the gate's demo step (cargo test -p fleet-demo)
checks the pacing.
Keeping the media current¶
scripts/demo.sh --check
It records nothing and needs only git and sha256sum. It hashes the tracked inputs that shape the media (listed in
DEMO_INPUTS in the script: the GUI and the crates it renders through, the daemon's status reducer, the hook
fixtures, the demo crate, the scenarios, timeline and gh stand-in, Cargo.lock and the script itself) and compares
the result with demo/demo.lock. When they differ the media is stale.
A pull request does not have to re-record stale media, and the open_pr gate does not check it. When a change to
those inputs lands on main, the Demo media GitHub workflow (.github/workflows/demo-media.yml) runs the check,
records on the runner if the media is stale, and opens one pull request, docs: re-record the demo media, from the
ci/demo-media branch. When that pull request changes only docs/assets/ media and demo/demo.lock, the workflow
rebase-merges it and redeploys the site, so the new media goes live without a review: it holds no code, and a bad take
is undone by reverting that one commit. If the branch holds anything else, the pull request stays open for a person.
If any step fails, the workflow opens or comments on an issue with the same title instead. It can also be started by
hand from the Actions tab.