Skip to content

It looks like you're writing code. ðŸ“ŽÂ¶

Would you like a paperclip to watch? Clippy Pet is an unofficial, open-source animated pet for the ChatGPT desktop app and the Codex CLI. It idles, waves, runs, jumps, fails gracefully, waits patiently, and follows your cursor through sixteen look directions.

curl -fsSL https://adammatthewsteinberger.github.io/clippy-pet/install.sh | sh

Also: macOS .dmg / .pkg · .deb / .rpm / .apk / Arch · package managers. One command, one directory, zero background processes.

Clippy Pet idle Clippy Pet waving Clippy Pet running Clippy Pet jumping Clippy Pet review Clippy Pet failed

It looks like you'd like to know what happens when you run that command. Good instinct. It downloads one release tarball, checks its SHA-256 against the published SHA256SUMS, and copies two files (a pet.json and a spritesheet.webp) into ~/.codex/pets/clippy-pet/. That's it. Read the whole script.

What you get¶

  • Nine animation states


    Idle, waving, jumping, running (right, left, and toward you), failed, waiting, and review, on a transparent 1536×2288 WebP atlas built to the pet v2 contract.

    See every animation

  • Sixteen look directions


    22.5° clockwise increments so the eyes track your pointer instead of staring into the middle distance. Every direction was blind-tested and the results are published.

    The look directions

  • Real installers, honestly labelled


    One-line install, .dmg/.pkg/.app for macOS, .deb/.rpm/.apk/Arch for Linux, reproducible tarballs, and a status page that says exactly which package managers are live yet.

    Installers & packages

  • The receipts


    A validator, blind direction QA, semantic QA, look-continuity measurements, and chroma-cleanup evidence, all checked in and all reproducible. The numbers are real, including the warnings.

    QA evidence

  • Remixable source


    Normalized per-state frames and row strips ship in the repo under MIT. Recolor it, re-rig it, or use the pipeline to hatch a pet that isn't a paperclip at all.

    Make your own

  • A little history


    Why a paperclip, why 1996 keeps coming back, and why this project is unofficial and says so on every page.

    The paperclip story

Where it shows up¶

Install, then open Settings → Pets in the ChatGPT desktop app (Codex lives inside it on macOS, Windows, and the Linux preview) and pick Clippy Pet. Reload the app if it doesn't appear immediately.

Install, then type /pets in the Codex CLI and choose clippy-pet. Pets render in terminals with image support (iTerm2 3.6+, Kitty, or Sixel-capable terminals).

Web pets are uploaded, not installed, and the uploader takes the older v1 sheet. Grab spritesheet-v1.webp from the latest release and upload it under Settings → Personalization → Pet.

Full selection guide

Honesty corner¶

Clippy Pet is not made by, endorsed by, or affiliated with Microsoft or OpenAI. "Clippy" and "Clippit" may be Microsoft trademarks; the paperclip artwork here is original and the notice travels with every artifact. The whole project is one JSON file and one image, plus a shell script that copies them. Nothing runs in the background, nothing phones home, and this site uses cookie-free analytics only if the maintainer turns them on. If any page says a package manager is "planned", that means it isn't published yet. We'd rather tell you than sell you.

It looks like you've read to the bottom of a landing page. Would you like to install a paperclip, star the repo, or show us your remix?