What problem does it solve? Terminal demos are usually one-off screen recordings that cannot be versioned, edited, or reproduced. DemoStage turns demos into code: it captures a session as events, normalizes them into a clean demo.toml score, replays that score deterministically, and exports the result to gif or mp4. ## Core Features & Use Cases - Capture and normalize: Record an interactive PTY session into a raw macro, then normalize human imperfections into a clean demo.toml score. - Deterministic replay and export: Execute the score with demo record to produce a .rec file, then compile it to gif or mp4 with demo export, with auto-provisioned ffmpeg and Chromium. - Multi-pane compositions: Combine terminal, browser, and PDF panes in scenes with layout strings, captions, scrolling, and focus control. - Use Case: Author a demo.toml by hand that types cargo build --release, waits for "Finished", then reveals a browser pane showing the rendered PDF, and export a reproducible mp4 for your README. ## Quick Start Ask the agent to capture a terminal session with demo capture, then record the resulting demo.toml and export it as a gif.
