docs(promo): add Claude↔Codex demo GIFs to README + docs site#145
Merged
Conversation
Two short demos rendered from asciinema casts that are generated deterministically from real `ctxrelay` output (no live capture; sanitized paths/ids; representative token-refresh review scenario): - contextrelay-pair.gif: `ctxrelay status` shows both agents attached to one ledger. - contextrelay-handoff.gif: a Claude->Codex review handoff via `ledger list`/`show`. Embeds: pair GIF as the README hero + docs intro hero; handoff GIF in the README "See a Handoff" section and after the docs launch commands. Includes the generator (scripts/gen-demo-casts.mjs) and source .cast files so the demos are reproducible and reviewable. Verified: `bun run check` green; `docusaurus build` succeeds (image paths resolve). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
![github-advanced-security[bot]](https://avatars.githubusercontent.com/in/57789?s=60&v=4){kind=small}
| const comment = (text) => { | ||
| out(PROMPT); | ||
| const s = `${DIM}# ${text}${RST}`; | ||
| for (const ch of `# ${text}`) { wait(0.018); } |
| const comment = (text) => { | ||
| out(PROMPT); | ||
| const s = `${DIM}# ${text}${RST}`; | ||
| for (const ch of `# ${text}`) { wait(0.018); } |
…nest framing Codex cross-review (artifact 367bd776), P2/P3 honesty + reproducibility: - gen-demo-casts.mjs: seed the typing jitter (mulberry32) so regeneration is byte-identical (verified: two regens produce matching SHA-256). Drop the "captured live" claim; rename cast 2 from "real" to "representative" handoff. - Regenerate the .cast files + GIFs from the now-deterministic generator. - Add a "scripted demo, sanitized values" caption under each GIF in the README and the docs intro, so the authenticity posture is explicit. Verified: bun run check green; docusaurus build succeeds. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
nillo
added a commit
that referenced
this pull request
Jun 18, 2026
Update the introduction "Current version" callout and the docusaurus config fallback literal from 3.4.0 to 3.5.0 now that 3.5.0 is the published release (npm latest = 3.5.0). Layered on top of #145 so the demo GIFs are preserved. Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds the two demo GIFs (approved by the human) to the README and the docs site.
What's here
contextrelay-pair.gif(~14s) —ctxrelay --version+ctxrelay statusshowing Claude + Codex both attached/idle on one ledger. Embedded as the README hero and the docs intro hero.contextrelay-handoff.gif(~16s) — a Claude→Codex review handoff viactxrelay ledger list+ledger show. Embedded in the README "See a Handoff" section and after the docs "first run" commands.How they were made (provenance for review)
scripts/gen-demo-casts.mjs→ asciicast v2.cast→ GIF viaagg. No live capture.ctxrelayoutput captured live; values are sanitized (abs home paths →~/code/acme-api, real instance/session IDs → placeholders,statusJSON trimmed to representative fields, relatable token-refresh scenario instead of the meta PR-docs(promo): Phase 0 discoverability — README badges, handoff demo, comparison, npm keywords #144 handoff)..castsources committed alongside the GIFs for reproducibility.Verification
bun run checkgreen.docusaurus buildsucceeds → the/img/contextrelay-*.gifdoc paths resolve (build fails on a missing image).Asks for Codex
statusfields, the handoff format)?🤖 Generated with Claude Code