Claim: ./ckitty --dump --seed 123 sit prints the same frame on every run, without starting ncurses.
InputPose sit, seed 123, frame 0, 80×24 canvas
NeedsC11 compiler, ncurses headers, Python 3
Evidencecmp exit 0, OK, CLI OK, TERMINAL OK

Prerequisites

  • Git.
  • A C11 compiler (cc).
  • Wide-character ncurses headers and libm. On Debian or Ubuntu install libncurses-dev, on Fedora ncurses-devel, on macOS brew install ncurses. The Makefile finds Homebrew’s ncurses through brew --prefix ncurses.
  • Python 3 for the pseudo-terminal test in make check.

1. Build and check

make builds one ckitty binary from src/ckitty.c and src/ckitty_core.c, linked against real ncurses. make check then runs three suites. On 23 October 2026 at commit cd7d1fb on macOS they printed:

2. Render the same kitty twice

--dump seeds the core RNG, renders frame 0 onto an 80×24 canvas, prints the canvas trimmed to the cat, and exits before initscr(). The output has no ANSI escapes. In the run above both files were 120 bytes, cmp exited 0, and the frame was:
Each line in the file also keeps trailing spaces up to the cat’s widest row. To pick a different moment or canvas, add --frame N, --width W or --height H. Themes don’t change dump output.

3. Run the sanitizers

This cleans, rebuilds with -fsanitize=address,undefined, and runs make check again. It printed the same OK, CLI OK and TERMINAL OK lines. Run make clean && make afterwards if you want an uninstrumented binary back.

4. Meet the interactive kitty

Press Space to cycle poses, 1 to 4 for sit, sleep, play and walk, N for a new kitty, T for the next palette, ? for help, and Q to quit. The same program, compiled to WebAssembly, runs at ckitty.vercel.app.

Expected evidence

  • cmp exits 0 and the script prints identical.
  • The dump contains plain characters with no escape sequences.
  • make check prints OK, CLI OK and a TERMINAL OK line.
  • make sanitize prints the same lines with no sanitizer report.

This recipe does not prove

  • That interactive animation repeats. It depends on keypresses and the clock.
  • That the browser build behaves the same. It shares the core but swaps ncurses for src/web_curses.c. The Playwright key test (make test-web) is outside make check.
  • That every compiler and platform supports the sanitizers, or that the build works beyond macOS and Linux.
Remove the captures when you’re done: