About

Homiedex is the codex of Black homies

37+ Black & African American pop culture legends as tiny animated pixel pets. Drop one in your terminal and ship code with the GOATs.

What Homiedex is

Homiedex is a public, open-source codex. Every entry is a homie pack — a tiny bundle of metadata and pixel art celebrating a Black or African American pop culture icon. Think of it as a Pokédex, but for the GOATs.

The catalog spans music, film, sports, comedy, civil rights, and literature. Find a companion by mood — cozy or focused.

How a homie pack works

Each homie is two files. pet.json defines the metadata — name, the 9 animation states, frame durations — and spritesheet.webp holds the pixel art as a horizontal strip. Codex loads them at startup and swaps states based on what's happening in your session.

FAQ

What is Homiedex?

Homiedex is a codex of Black & African American pop culture icons — musicians, athletes, actors, comedians, civil rights figures, writers — reimagined as tiny animated pixel pets. Each entry is a small spritesheet with 9 states (idle, working, sleeping, etc.) that can live in the Codex CLI or anywhere else you want a chibi homie cheering you on.

How do I install a homie?

Open any homie's detail page and click Download on pet.json and spritesheet.webp. Move both files into a folder named after the homie's slug (e.g. ~/.codex/pets/biggie/). Then in Codex go to Settings → Appearance → Pets and select the homie. Use /pet inside Codex to wake it.

Where do the homies come from?

Hand-curated. Each homie is a pixel sprite generated and reviewed individually — the featured set covers a broad sweep (Biggie, Prince, Bey, T'Challa, Ali, MLK), and the catalog grows as new homies get pixel-arted and committed to the repo.

Can I add a new homie?

The repo is open. Fork it on GitHub, add public/pets/<slug>/pet.json + public/pets/<slug>/spritesheet.webp, and open a pull request. The site auto-rebuilds on merge.

Is Homiedex free and open source?

Yes. Every homie is free to install and use, and the site itself is open source on GitHub.

What's a vibe? What's a kind?

Each pet is tagged with a kind (musician, athlete, character, …) and a few vibes (cozy, playful, focused, mystical, …). These power the gallery filters and per-vibe / per-kind landing pages so you can find the right homie without scrolling.

How does Homiedex make money?

It doesn't. It's a labor-of-love project. No ads, no upsells.