cc-gifs: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Overview

A creative playground for generating Clawd (Claude Code mascot) pixel art spinner GIFs. The project produces animated GIF spinners that display during Claude Code loading states — each with a whimsical "-ing" word and a unique Clawd scene.

Project Structure

• generate_clawd_gifs.py — Unified generator script: draws Clawd pixel art, defines both full frames_*() animations and compact sc_*() scenes, and outputs transparent GIFs
• generated/ — Runtime output directory for generated GIFs (kept out of git)
• spinner-words.md — Catalog of 195 spinner entries (165 drawn ✅, 30 pending ⏳, 8 repo extensions ★) with status tracking, Chinese translations, scene descriptions, and an "官方语义" column noting upstream verb intent. Cross-checked against Claude Code 2.1.153's 187 default spinnerVerbs.
• README.md — Public repo overview and usage guide
• AGENTS.md — Pointer file for Codex and other coding agents, redirects to CLAUDE.md
• requirements.txt — Minimal runtime dependency list (Pillow)
• LICENSE — MIT license for repository code
• .gitignore — Excludes generated/, *.gif, *.png, *.jpg, *.jpeg, .DS_Store, __pycache__/
• Local-only reference screenshots, reference GIFs, and sticker/source assets are intentionally excluded from this public repository

GIF Generation

python3 generate_clawd_gifs.py

• Requires: Pillow (pip install Pillow)
• Output: official spinner GIFs at generated/Clawd-{Word}.gif (400×400px, transparent background, 170ms per frame)
• Default compact scenes render at 6 frames, but some handcrafted frames_*() scenes now use longer timelines
• Known longer animations:
  • Catapulting — 8 frames
  • Cultivating — 12 frames
  • Germinating — 12 frames
  • Gesticulating — 8 frames
  • Cascading — 10 frames
  • Channelling — 8 frames
  • Choreographing — 8 frames
  • Hatching — 10 frames
  • Nucleating — 8 frames
  • Osmosing — 8 frames
  • Prestidigitating — 8 frames
  • Recombobulating — 8 frames
  • Wrangling — 8 frames
  • Whirlpooling — 10 frames
  • Unfurling — 8 frames
  • Topsy-turvying — 10 frames
  • Transmuting — 8 frames
  • Tinkering — 8 frames
  • Thundering — 8 frames
• The generator currently produces 165 GIFs (157 official spinner verbs + 8 repo extensions); 30 additional official verbs are catalogued as pending in spinner-words.md
• generate_clawd_gifs.py supports two internal scene styles:
  • handcrafted frames_*() functions that return complete frame lists
  • compact sc_*() scene functions rendered through make_frames()
• main() merges both generator styles into one output registry
• Current pipeline:
  • pixel font + shared color constants
  • grid-based draw_clawd() and scene helpers
  • frames_*() or sc_*() scene construction
  • make_frames() for compact scene wrapping
  • main() registry merge and batch generation
  • save_gif() palette conversion and animated GIF export
• Clawd-Dancing.gif and other visual references remain local-only assets and are excluded from this public repository