crafter-station/petdex

Petdex is a fun project that adds animated companion pets to your coding workflow. Think of it like a Tamagotchi that lives on your screen while you code, but instead of just sitting there, the pet actually reacts to what your AI coding assistant is doing. When your agent is idle, running a task, hitting errors, or reviewing code, your pet plays a matching animation. The project has three parts that work together. There's a web gallery at petdex.dev where you can browse community-submitted pets and pick one you like. There's a command-line tool that installs any pet with a single command. And there's a desktop app that floats the pet on your screen and connects it to supported coding agents like Codex, Claude Code, OpenCode, and Gemini CLI. Once installed, your pet shows up in your agent's settings and reacts in real time to what's happening in your coding session. This is built for developers who spend a lot of time in AI-assisted coding tools and want a bit of personality in their workflow. If you're using Codex or Claude Code all day, having a little animated cat, robot, or custom character react to your successes and failures adds a lighthearted touch to the work. The community can also create and submit their own pets, so the gallery keeps growing with user-contributed characters. What's notable is how accessible the creation process is. Each pet is just two files: a metadata file describing its name and animation states, and a spritesheet image arranged in a grid. The animation states map directly to coding events, idle, running, failed, reviewing, so the pet visually mirrors what your AI agent is doing. The desktop app itself is built in Zig, which is an unusual choice, paired with a Node sidecar that handles the agent communication. The whole thing is open source under MIT, and already has over twenty other projects building on top of its public API and pet format.