gitwtfhub

wtf is awesome_pets?

nitrogen216/awesome_pets — explained in plain English

Analysis updated 2026-05-18

59Audience · developerComplexity · 1/5Setup · easy

TL;DR

awesome_pets is a small collection of custom animated companion pets, starting with a frog character, that you can install into the Codex coding app.

Mindmap

mindmap
  root((awesome pets))
    What it does
      Custom Codex App pets
      Nai Frog character
      Spritesheet animation
    Tech stack
      JSON metadata
      WebP spritesheet
    Use cases
      Install a pet
      Create your own pet
    Status
      Early stage
      More pets planned

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Install a custom animated pet like Nai Frog into your Codex App for a friendlier coding experience.

REASON 2

Package your own pet by creating a pet.json file and a matching spritesheet image.

REASON 3

Follow along as new companion pets are added to the collection over time.

What's in the stack?

JSONWebP

How it stacks up

nitrogen216/awesome_pets0xsha/wp2shellandrewrk/mcserve
Stars595959
LanguagePythonJavaScript
Last pushed2013-04-10
MaintenanceDormant
Setup difficultyeasymoderatemoderate
Complexity1/55/53/5
Audiencedeveloperdeveloperops devops

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Requires the Codex App installed, only copy the individual pet folder, not the whole repo.

No license has been added, all rights remain with the repository owner until one is added.

Wtf does this do

awesome_pets is a small collection of custom virtual pets for the Codex App, a coding assistant application from OpenAI. The idea is to make the app feel more cheerful by adding animated companions you can install and interact with while you work. The first pet included is Nai Frog, described as a cheerful, round yellow frog with a cream belly, bright green eyes, and a signature belly-holding laugh animation. Each pet is packaged as a folder containing a pet.json metadata file, which describes the pet and its animation settings, along with a spritesheet image file that provides the actual animation frames. To install a pet, you clone the repository, then copy the specific pet's folder, such as naifrog, into the Codex App's custom pets directory, usually located at a hidden .codex folder in your home directory. After copying the files, you refresh the pet list inside the app's settings and select the new pet to activate it. The README is careful to note that you should copy just the individual pet folder, not the whole repository, since the app expects to find the pet's files directly inside its own folder. The project is early-stage, with Nai Frog described as only the first companion, and more pets planned for future updates. No license has been added yet, so all rights currently remain with the repository owner, meaning others should not assume they can freely reuse or redistribute the pet files.

Yoink these prompts

Prompt 1
Walk me through installing Nai Frog from awesome_pets into my Codex App on macOS.
Prompt 2
What files do I need to create my own custom pet in the same format as Nai Frog?
Prompt 3
Explain the folder structure the Codex App expects for custom pets.

Frequently asked questions

wtf is awesome_pets?

awesome_pets is a small collection of custom animated companion pets, starting with a frog character, that you can install into the Codex coding app.

What license does awesome_pets use?

No license has been added, all rights remain with the repository owner until one is added.

How hard is awesome_pets to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is awesome_pets for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.