docs(demo): rebuild hero GIF around the "which agent needs you" story#59
Merged
Conversation
The old recording opened with three static tables (status → stats →
activity) and never showed `muxa attend` — the most visceral feature.
Panes ran bare `cat`, so any teleport/attach landed on an empty shell,
which is why the demo leaned on popups instead of real panes.
Rework it into a four-beat narrative that ends on the money shot:
1. muxa status — the overwhelm (working / blocked / waiting)
2. muxa stats — where the day actually went
3. muxa watch — the god view, with a real prompt/response preview
4. muxa attend — teleport to the longest-blocked agent (codex,
mid shell-approval), the strongest note to end on
- add docs/demo-paint.sh: paints believable claude/codex/gemini frames
into the panes so attend/attach arrive somewhere that reads as genuine
- demo-setup.sh: paint the codex/gemini panes instead of `cat`; resolve
tmux via MUXA_DEMO_TMUX so the tape renders on Homebrew macs too, not
just /usr/bin/tmux (Docker/CI)
- regenerate docs/demo.gif (rendered in the isolated VHS Docker image)
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
… path cargo-deny went red on two newly-published quick-xml advisories: - RUSTSEC-2026-0194 (quadratic runtime on duplicate attribute names) - RUSTSEC-2026-0195 (unbounded namespace allocation in NsReader, DoS) Both reach us only via notify-rust -> tauri-winrt-notification -> quick-xml, a Windows-only (WinRT toast) dependency that isn't compiled into the Unix builds we ship. They are DoS-on-untrusted-XML issues, and muxa never feeds attacker-controlled XML through this crate. A clean bump isn't possible yet — tauri-winrt-notification 0.7.2 pins quick-xml ^0.37, so 0.41 (the fixed release) can't be selected. Ignore with a revisit note. Co-Authored-By: Claude Opus 4.8 (1M context) <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
1 participant
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.
What
Rebuilds the README hero GIF. The old recording opened with three static tables (
status→stats→activity) and never showedmuxa attend— the most visceral feature. Its panes ran barecat, so any teleport/attach landed on an empty shell, which is why the old flow leaned on popups instead of real panes.New recording is a four-beat narrative that ends on the money shot:
muxa statusmuxa statsmuxa watchmuxa attendChanges
docs/demo-paint.sh(new) — paints believable claude/codex/gemini frames into the demo panes soattend/attach arrive somewhere that reads as genuine, not an emptycat.docs/demo-setup.sh— paints the codex/gemini panes instead ofcat; resolves tmux viaMUXA_DEMO_TMUX(falls back to/usr/bin/tmux) so the tape also renders on Homebrew macs, not just Docker/CI.docs/demo.tape— rewritten visible flow; all shell commands run from the bash pane first,attend(which moves us off the shell) comes last.docs/demo.gif— regenerated in the isolated VHS Docker image (1200×720, ~19s, 306 KB, down from 699 KB).docs/demo-README.md— documents the story arc, the new file, and the Docker-fallbackdocker cpstep fordemo-paint.sh.Verification
Rendered in the official
ghcr.io/charmbracelet/vhsDocker image (fully isolated Linux — no host muxad/tmux/shell), then verified frame-by-frame with ffmpeg:attendlands on the painted codex approval screen,statsrenders the duration table, andwatchpreview shows the seeded prompt/response. No real terminal content leaks into the recording.🤖 Generated with Claude Code