ckitty is a C11 program that draws an animated ASCII cat in your terminal, in four poses and three palettes. The same C code, compiled to WebAssembly, runs in the browser at ckitty.vercel.app, and --dump prints one seeded frame without starting ncurses.
StatusShipped, v1.1.0 binaries and web build
RuntimeC11, ncurses, libm, 65 KB wasm in the browser
Proof hooks--dump --seed, make check, make sanitize

How it works

src/ckitty_core.c has no terminal code. It seeds a small RNG, picks a cat’s pose and coat variations with ckitty_kitty_randomize, and draws a frame into a character canvas with ckitty_render_frame(kitty, frame, canvas). The frame number drives blinks, ear twitches, the tail swish and walking steps, so the same seed, pose, frame and canvas size always give the same characters. src/ckitty.c parses options with getopt_long. With --dump, it builds an 80×24 canvas (or --width by --height), renders frame 0 (or --frame), prints the canvas trimmed to its bounding box, and exits before it would call initscr(). Otherwise it runs the ncurses loop: input with a timeout, layout, palettes, help, pause, the live reveal (-l) and the screensaver (-S). The file picks its curses at compile time. Under #ifdef CKITTY_WEB it includes src/web_curses.h, and otherwise <ncurses.h>. Only make web compiles the shim. The native build links -lncurses -lm on macOS and -lncursesw -lm on Linux, and the Makefile finds Homebrew’s keg-only ncurses through brew --prefix ncurses. src/web_curses.c implements the curses calls ckitty.c uses (initscr, getch, mvaddch, addnwstr, init_pair, refresh and a few more) on top of a cell grid. refresh() flushes the grid as ANSI to the page through an EM_JS hook. getch() waits in emscripten_sleep slices, which Asyncify turns into yields to the browser event loop, and returns keys the page queued with the exported ckitty_web_key. make web compiles ckitty.c, ckitty_core.c and web_curses.c with emcc -O3 -sASYNCIFY -DCKITTY_WEB into web/public/ckitty.js and ckitty.wasm. Both are committed, with the xterm.js dist, so the Vercel config serves web/public as static files with no build step. web/public/ckitty-page.js starts the program with --live, or with no flags when the viewer prefers reduced motion.

Verify it

These ran on 23 October 2026 at commit cd7d1fb on macOS with Homebrew ncurses.
make check printed OK (core tests), CLI OK, and TERMINAL OK (controls, palettes, Unicode messages, compact help, quiet, pause/help, slow timing, live progress, screensaver, resizes). make sanitize rebuilt with AddressSanitizer and UndefinedBehaviorSanitizer and printed the same three lines. The dump printed an 8-line, 120-byte sitting cat, and two runs compared equal with cmp. ./ckitty --version printed ckitty 1.1.0. With Emscripten 6.0.13 installed, make web WEB_OUT=/tmp/ck/ckitty.js produced a 65,023-byte ckitty.wasm that was byte-identical to the committed web/public/ckitty.wasm. The Playwright key test was not run. The Build and Test workflow runs make check on Ubuntu and macOS, a headless --dump check, and make sanitize on Ubuntu. The Release workflow runs make check on each tag and attaches linux-x86_64 and macos-arm64 tarballs with SHA-256 files.

Limits

  • Building needs a C11 compiler, wide-character ncurses and libm. Sanitizer support depends on the compiler.
  • There is no Homebrew formula. The fortunexbt/homebrew-tap repo holds only a cask for another project. Install with install.sh, from source, or from a release tarball.
  • Release binaries cover Linux x86_64 and Apple silicon only. v1.1.0 (8 September 2026) predates the web build, so the WebAssembly code exists only on main.
  • --dump repeats for a given seed, pose, frame and size. Interactive animation timing depends on terminal input and the clock.
  • The browser build leaves out the screensaver loop, --message, NO_COLOR and piping --dump, according to the README.
  • GPL-3.0. Redistributed binaries carry its source and notice obligations.

Source

Prove a kitty repeats

Render the same seeded frame twice, compare it byte for byte, and run the native checks.