Skip to content

docs: add hero demo video playback workflow#106

Merged
ThomasK33 merged 2 commits into
mainfrom
workspace-1
May 29, 2026
Merged

docs: add hero demo video playback workflow#106
ThomasK33 merged 2 commits into
mainfrom
workspace-1

Conversation

@ThomasK33
Copy link
Copy Markdown
Member

Summary

  • document the Hero Demo video playback workflow for GitHub README-friendly recordings
  • add task-scoped mise tooling for the real-agent Hero Demo recorder/upload asset workflow
  • add a helper to prepare H.264 MP4 upload assets and apply GitHub user-attachment URLs back to README/manifest files
  • preserve and validate the new playback guide as part of the canonical Hero Demo bundle

Validation

  • mise run demo:agent-uses-agent-tty:upload-assets
  • npm run format:check
  • npm run lint
  • npm run typecheck
  • npm run validate-bundle -- dogfood/agent-uses-agent-tty --profile canonical
  • npx vitest run test/unit/tools/hero-demo.test.ts
  • GIT_CONFIG_GLOBAL=/dev/null mise run ci

Note: local mise run ci without GIT_CONFIG_GLOBAL=/dev/null was blocked by the workspace's global Git signing config pointing at a missing 1Password SSH signing binary; rerunning with the global Git config disabled passed.


Generated with mux • Model: openai:gpt-5.5 • Thinking: xhigh

ThomasK33 and others added 2 commits May 22, 2026 10:10
The thumbnail-link flow pointed each README thumbnail at a
https://github.com/user-attachments/assets/<uuid> URL, which 404s on direct
navigation — anonymous visitors clicking a thumbnail hit a 404 instead of a
player. GitHub only serves these assets when embedded inline in rendered
Markdown.

- Embed the recordings as inline HTML <video> players: root README as a
  side-by-side table, bundle README as an HTML table (GitHub does not render
  <video> inside GFM table cells).
- Bake the curated thumbnail in as the opening ~0.3s of each upload MP4, since
  GitHub strips <video poster>; the player's first-frame still then shows the
  end-state proof instead of a blank startup terminal.
- prepare-upload-assets prepends the poster frame; apply-video-urls rewrites the
  inline <video> src attributes; VIDEO_PLAYBACK.md documents the flow and the
  logged-out browser verification step.

Verified in a logged-out Chromium: every README <video> streams (readyState 4,
1600x900, 206 video/mp4) with the thumbnail as its still.

Change-Id: I00ba61404b32ae7111218b16fb6d42089b2faf25
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Signed-off-by: Thomas Kosiewski <tk@coder.com>
@ThomasK33 ThomasK33 merged commit 963a564 into main May 29, 2026
12 checks passed
@ThomasK33 ThomasK33 deleted the workspace-1 branch May 29, 2026 10:01
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