Skip to content

docs(readme): replace the static screenshot with a 30-second web UI recording - #970

Merged
agentforce314 merged 1 commit into
mainfrom
docs/readme-web-demo-recording
Oct 20, 2026
Merged

agentforce314 merged 1 commit into
mainfrom
docs/readme-web-demo-recording

Conversation

@agentforce314

Copy link
Copy Markdown
Owner

Summary

The README hero was a static TUI screenshot. This PR replaces it with a 30-second recording of the web UI (clawcodex web) and keeps the old image only where the Chinese README still needs it.

  • assets/clawcodex-web-demo.gif (1120×720, 12 fps, 5.8 MB) is embedded in the README header; GitHub plays it inline.
  • assets/clawcodex-web-demo.mp4 (1.35 MB) is linked under it for a crisp, pausable version.
  • assets/clawcodex-screenshot-1.png is untouched because docs/i18n/README_ZH.md still embeds it.

What the recording shows

A fresh session against a tiny sample project (an argparse CLI with two pytest tests). The prompt asks for a --json flag on taskflow list, a test for it, and a test run. The agent lists and reads the project, edits the CLI and the test file, runs pytest (4 passed), and ends on a short summary with file references. Typing is real-time; the agent's work is shown at about 1.3× so the whole session fits in 30 seconds.

How it was made

  • clawcodex web --no-open --workspace <sample project> --model deepseek-v4-flash on a freshly built ui-web/dist, with CLAWCODEX_CONFIG_DIR pointed at a throwaway profile that holds a single provider entry, so no real sessions or settings appear.
  • Captured headless with Playwright's recordVideo using the @playwright/test already pinned in ui-web/package.json, dark theme, reading preferences set to the detailed tool trail that stays open after the turn.
  • Re-timed and encoded with ffmpeg (palette-optimised GIF plus an H.264 MP4).

Test plan

  • README renders the GIF and the MP4 link in the centered header block (same markdown-in-HTML pattern the old image used)
  • No personal paths, keys, or session history visible in any frame
  • Only README.md and the two new assets are in the diff

🤖 Generated with Claude Code

…ecording

The README hero was a plain TUI screenshot. Replace it with a recorded
session of `clawcodex web`: the user asks for a `--json` flag on a small
sample CLI and the agent reads the project, edits the code and the tests,
runs pytest, and reports back, all within 30 seconds. Shipped as an animated
GIF (GitHub plays it inline in the README) with an MP4 alongside for a
crisp, pausable version.

The old PNG stays in assets/ because docs/i18n/README_ZH.md still embeds it.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@agentforce314
agentforce314 merged commit 1662ce2 into main Oct 20, 2026
6 of 7 checks passed
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