--
title: How to Install a Custom Codex Pet from the Terminal
description: Two commands, one folder, done: the ~/.codex/pets terminal workflow for macOS and Windows.
tags: [codex, openaicodex, terminal]
canonical_url: https://codexpetgenerator.com/blog/install-codex-pet-terminal
Installing a Codex pet from the terminal is genuinely two commands on macOS and one line of PowerShell on Windows. The whole install surface is a single folder: ~/.codex/pets. Each pet is one subfolder containing spritesheet.webp and pet.json. Codex reads that folder at startup, so a full restart is the only other step.
The classic failure is a name mismatch: the folder name and the name field inside pet.json must match exactly. I have burned ten minutes on this more than once, so check it before you restart. Verification is easy: ls ~/.codex/pets, cat the pet.json, compare names.
The post covers the exact commands for both platforms, how to verify the install properly, the four most common terminal mistakes, and the fact that uninstalling is just deleting the folder.
Primary keyword: install codex pet — install custom codex pet, ~/.codex/pets folder, codex pet terminal install.
Read the full review on our blog: How to Install a Custom Codex Pet from the Terminal
中文操作指引（Dev.to 发布）
操作地址：https://dev.to/new
操作步骤：打开 dev.to/new → 粘贴正文（含 front-matter）→ 检查 canonical_url → Publish
推荐时间：次日 09:00-09:30（美东早高峰前）
主 CTA：正文已含回链 → 源站博客 https://codexpetgenerator.com/blog/install-codex-pet-terminal
跟踪清单：发布后 24h 检查阅读量/互动；Dev.to 需确认 canonical_url 已生效；Medium 确认 Import 后正文末尾 canonical 原样保留。
Top comments (0)