zhengyici/nailong-pet-skill

★ 11PythonAudience · developerComplexity · 1/5Setup · easy

Mindmap

mindmap
  root((Nailong Pet Skill))
    What it does
      Custom Codex pet
      Nailong character
      9 animation states
    Animation states
      Idle standing
      Running left or right
      Task complete wave
      Failure crouch
    How to install
      Python install script
      skills.sh command
      Restart Codex
    Custom character
      8x9 sprite sheet
      Config file swap
      Template included

mindmap root((Nailong Pet Skill)) What it does Custom Codex pet Nailong character 9 animation states Animation states Idle standing Running left or right Task complete wave Failure crouch How to install Python install script skills.sh command Restart Codex Custom character 8x9 sprite sheet Config file swap Template included

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Replace the default Codex desktop pet with the Nailong meme character using the one-command install script.

USE CASE 2

Use this repository as a template to create your own custom animated desktop pet for Codex with any character you design.

USE CASE 3

Learn how Codex's pet system works, sprite sheet format, configuration files, and animation state triggers, so you can build on it.

Tech stack

Python

Getting it running

Difficulty · easy Time to first run · 5min

Requires OpenAI Codex to be installed, install via a single Python script or the skills.sh command-line tool.

No license information is provided in the repository.

In plain English

This repository adds a custom animated desktop pet to OpenAI Codex, which is an AI-powered coding assistant with a visual interface. Codex has a built-in feature where a small animated character can sit on your screen while you work, and this project lets you swap in a character called Nailong, a popular internet meme character from Chinese social media. The repository contains the animation sprite sheet (a single image file where all the character's frames are laid out in a grid), a preview image, and a Python installation script. Running the script copies the image and a configuration file into Codex's pet folder. After restarting Codex, the Nailong character appears as an option in the settings under the pets section. The character has nine animation states that correspond to what Codex is doing at any moment: standing still when idle, running left or right when you drag it, waving when it finishes a task, crouching when something fails, and tilting its head with a question mark during code review, among others. The project is written in Chinese and also functions as a template for anyone who wants to add a different custom character to Codex. The README walks through how to prepare your own sprite sheet (which must follow a specific grid layout of 8 columns by 9 rows at fixed pixel dimensions), swap in your own images, and update the configuration files to use your character's name and trigger words. Installation can also be done through a command-line tool called skills.sh with a single command.

Copy-paste prompts

Prompt 1

I want to create a custom animated pet for OpenAI Codex using my own character art. Walk me through preparing an 8-column by 9-row sprite sheet at the right pixel dimensions and updating the config files.

Prompt 2

I've installed the nailong-pet-skill. How do I open Codex settings and switch the active pet to the Nailong character?

Prompt 3

Show me how the Codex pet configuration file maps animation states like idle, running, and task-complete to specific rows in the sprite sheet.

Prompt 4

I want to add a 10th animation state to a custom Codex pet. How do I extend the sprite sheet and update the config to support it?

Open on GitHub → Explain another repo

← zhengyici on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.