[samartomar]

The README's GIF now shows Flow Home, the main window, for the whole 33 seconds, with the pill resting below it. It goes through every page in the rail's order. On Conversations, the pill dictates a question into the composer, the question pastes there, and Enter asks it. The GIF is 1100×708 and 663 KB.

scripts/home_reel.py records it, and re-records it after a page changes:

uv run --no-sync --with pillow --with playwright python scripts/home_reel.py

• Flow Home is the real page, server and API, running over flow.home.demo's pretend session. Playwright drives Windows' own Edge headless (channel="msedge"), so no browser is downloaded.
• The pill is the real CompactPill, recorded by compact_reel.Tap from the bitmaps it hands Windows. The two recordings are joined at the moment the talk keys go down.
• Nothing on the screen is read, and the real pointer never moves. The title bar, the pointer, the key hints and the strip of desk under the window are drawn.
• The session's clock is set to the afternoon, so "today" reads as a day whenever the GIF is recorded.
• History's footer names C:\Users\you\.flow\history.jsonl, because the demo's temporary folder has the user name in its path.
• The usage trace is written with flow.diag.Diag, as the session writes it. That also keeps test_bench_identity's rule that only benches write JSON.

Two Flow Home layout bugs the recording turned up (first commit):

• Settings: at the default 1200 px window, the Shortcuts card overflowed. The Save buttons stood past its edge, and the boxes for new keys shrank to about 20 px. At 1100 px the Hold/Toggle switch was cut off too. A row now wraps when it cannot fit, and a box wraps together with its Save onto a line of their own.
• History: "Today: N words, M pastes" stacked one word per line at about 1000 px. It now takes a line of its own instead.

compact_reel.py now writes docs/pill.gif by default, so running it cannot overwrite the README's GIF.

The suite has 3205 tests. Locally, the only failures are the 13 known test_refine ones.

🤖 Generated with Claude Code

[chatgpt-codex-connector]

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review	Status	Commit	Review trigger
📝 Code Review	✅ Completed 2026-09-24T06:17:49.190776Z	f510b77	PR opened

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.