codex-petkit
v0.3.2
Published
CLI for Codex Pet: browse, install, submit, and run desktop pets.
Downloads
958
Readme
codex-petkit
Command line tools for Codex Pet.
Use
npx codex-petkit list
npx codex-petkit install boba
npx codex-petkit install desktop
npx codex-petkit up
npx codex-petkit login
npx codex-petkit submit ./my-petinstall reads the public Codex Pet manifest, downloads the selected pet, and writes it to:
~/.codex/pets/<slug>/Then activate it inside Codex:
Settings -> Appearance -> PetsCommands
login,logout,whoami: authorize the CLI with your Codex Pet account.list: show public pets from the Codex Pet manifest.install <slug>: download a pet into Codex.install desktop: install the native desktop pet runtime bundled with the npm package.desktop <start|stop|status>: manage the floating desktop pet.hooks <install|on|off|toggle|status>: let Codex/Claude Code drive the desktop pet state.init,up,down,toggle,update: shortcuts for the desktop runtime.submit <folder|zip>: upload a pet folder or zip containingpet.jsonandspritesheet.png/webp.doctor: check local setup.telemetry <on|off|status>: manage the local telemetry preference.
Config
Point the CLI at another deployment:
CODEX_PET_URL=https://your-domain.example npx codex-petkit listRequires Node.js 18+.
