What is awesome-codex-pet AGENTS.md?

Repository instructions for Awesome Codex Pet, a collection and distribution project for installable Codex pet characters. It explains the finished pet files, sprite-sheet versions, installation materials, and submission workflow.

Use them when creating, maintaining, submitting, or packaging a Codex pet, generating preview animations, or choosing between the version 1 and version 2 sprite-sheet workflows.

They distinguish final files from temporary artwork and require the pet metadata, folder names, image dimensions, and version settings to agree.

How legeling/awesome-codex-pet configures Codex and OpenCode

About the project

Awesome Codex Pet is a community gallery and source catalogue of installable animated pets made for Codex, with previews, creator information, and collection metadata. Codex users can browse, install, request, and contribute pets across supported desktop platforms. The catalogue entries provide skills and an instruction for working with this pet collection.

legeling/awesome-codex-pet · 1,253 stars · on GitHub · codexpet.top

Reuse

Borrowing it

Nothing to install: this file belongs to legeling/awesome-codex-pet. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file

curl -O https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/AGENTS.md

Clone the repo

git clone --depth 1 https://github.com/legeling/awesome-codex-pet

Made for: Codex, OpenCode.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/instructions/legeling/awesome-codex-pet/agents-md/github.svg)](https://agentmods.dev/instructions/legeling/awesome-codex-pet/agents-md)

Your own site

<a href="https://agentmods.dev/instructions/legeling/awesome-codex-pet/agents-md"><img src="https://agentmods.dev/badge/instructions/legeling/awesome-codex-pet/agents-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/instructions/legeling/awesome-codex-pet/agents-md"><img src="https://agentmods.dev/badge/instructions/legeling/awesome-codex-pet/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 2,294 This file is loaded in full into every session.

When invoked 2,294 The same file — it is already loaded in full.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.02294	$0.02294
Opus 5.5	$0.00918	$0.00918
Sonnet 5.5	$0.00459	$0.00459
Haiku 4.5	$0.00229	$0.00229

Measured 1mo ago against content hash 110dde84a8f8, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

awesome-codex-pet AGENTS.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

AGENTS.md · 206 lines

How it starts

The opening of the file, as written. The whole thing — 206 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Awesome Codex Pet Agent Guide

本文件面向在本仓库内工作的 AI coding agents。

默认要求：

默认使用中文与用户沟通，除非用户明确要求英文。
优先做出可提交的仓库改动，而不是只停留在分析。
不要把过程产物混进最终 pet 包。

Pet Skill 版本

$submit-codex-pet 是统一投稿入口：区分“请求社区制作”“制作或提交自己的宠物”和“高级 PR”，优先通过 GitHub API 操作，避免为了三个成品文件完整克隆大型素材仓库。
$hatch-pet-v1 是仓库保留的旧版产线，输出 8x9、1536x1872 的 v1 spritesheet；维护现有仓库 pet 时使用它。
$hatch-pet-v2 是从当前 Codex App 内置 skill 同步的 v2 产线，输出 8x11、1536x2288 的 spritesheet，并要求 pet.json.spriteVersionNumber: 2 与 16 个环视方向。
调用时必须显式选择版本。v1 与 v2 都可以收录，但 spriteVersionNumber、图集尺寸和实际行数必须匹配。

1. 项目是什么

awesome-codex-pet 是一个收集和分发 Codex 小宠物的仓库。

它同时承担三件事：

收录最终可安装的 pet 成品
生成 README 里的精选动图与完整文字索引
提供无需 clone 仓库的一键安装方式

这个仓库不是宠物制作运行目录本身。制作过程中的参考图、QA 视频、调试文件、临时输出，可以保留在本地，但不应该成为 Git 跟踪内容。

2. 仓库里的真成品

每个 pet 目录只允许保留以下三个文件：

pets/<pet-slug>--<author-slug>/
├── submission.json
├── pet.json
└── spritesheet.webp

必须遵守：

目录名格式固定为 pet-slug--author-slug
pet.json.id 必须与目录名完全一致
pet.json.spritesheetPath 固定为 spritesheet.webp
v1 的 spriteVersionNumber 可以省略或设为 1，spritesheet.webp 必须是 1536x1872 的 8x9 图集
v2 必须设置 spriteVersionNumber: 2，spritesheet.webp 必须是 1536x2288 的 8x11 图集，最后两行包含 16 个环视方向
spritesheet.webp 必须是最终运行时资源，不要放过程版

不要把这些文件放进 pets/<pet-id>/：

qa/
videos/
*.mp4
contact-sheet.png
参考图
layout guides
prompts
decoded frames
repair archive

3. 生成物与来源文件

仓库中允许在本地或 CI 生成的自动生成物主要有：

assets/previews/<pet-id>/contact-sheet.png
assets/previews/<pet-id>/gifs/*.gif
README.md
docs/zh-CN/README.md
pets.json
install-manifest.json

其中 assets/previews/<pet-id>/ 默认视为本地产物或部署产物，不作为长期 Git 跟踪内容。

这些文件不是手写维护优先项。除非只是极小文案修正，否则应优先修改生成脚本，再重新生成。

README 使用 readme-featured.json 固定精选 15 只宠物，参考公开排名并兼顾角色多样性，按 3 行 × 5 列展示网站托管的待机动图：https://codexpet.top/assets/previews/<pet-id>/webp/idle.webp，链接到网站详情页。沿用网站的动态 WebP，不使用 GitHub raw 或仓库相对图片路径。全部宠物以折叠的纯文字索引保留名称、作者和版本；完整动作由网站提供。所有语言遵循同一生成规则。

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

1mo ago Changed · -4 lines · +28 tokens per session scan C → A 110dde84a8f8
1mo ago Changed · +2 lines · +136 tokens per session 41dc58c92d0a
2mo ago First seen · 208 lines · 2,130 tokens per session scan C 9c51271f312d

Subscribe to this mod's changes

awesome-codex-pet AGENTS.md is an instructions file published in the GitHub repository legeling/awesome-codex-pet (1,253 stars, last pushed yesterday), licensed MIT. It adds 2,294 tokens to every session, about $0.0092 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

ai chatgpt codex codex-pet codex-pets pets

awesome-codex-pet AGENTS.md next to 6 instructions from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
awesome-codex-pet AGENTS.mdlegeling/awesome-codex-pet	Instructions file	1.3k	yesterday	MIT	A	2,294	Codex, OpenCode
vscode buildNext.instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	9,719	GitHub Copilot
next.js AGENTS.mdvercel/next.js	Instructions file	143k	yesterday	MIT	A	7,461	Codex, OpenCode
langchain AGENTS.mdlangchain-ai/langchain	Instructions file	149k	yesterday	MIT	A	4,680	Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	5,516	GitHub Copilot
vscode copilot-instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	3,093	GitHub Copilot
deepseek-harness AGENTS.mddeepseek-ai/deepseek-harness	Instructions file	274k	2d ago	MIT	A	4,313	Codex, OpenCode

awesome-codex-pet: Instructions file for Codex