install-codex-pet

Install shared Codex pet packages into Omnibot with the official codex-pets npm CLI. Use when the user asks to add, install, download, import, or sync a pet by slug or collection, especially requests containing commands such as "npx codex-pets add".

Jump to install

Repository: omnimind-ai/OmniBot
Last source activity: July 18, 2026 at 16:43
Detected SKILL.md language: English
Stars: 1,963
Forks: 139

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/omnimind-ai/OmniBot --skill install-codex-pet

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer

3 files

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

Install Codex Pet

Install pets into Omnibot's selectable pet directory while preserving the official Codex package format.

Workflow

Extract the lowercase pet slug or collection slug from the request. Do not guess when no slug is present.

Confirm node, npm, and npx are available. If they are missing, report that the embedded {{OMNIBOT_TERMINAL_DISTRIBUTION}} environment needs its base packages installed.

Point the official CLI at Omnibot's Codex-compatible pet root, then run the requested command:

export CODEX_HOME=/workspace/.omnibot npx --yes codex-pets add claude-pixel

For a collection:

export CODEX_HOME=/workspace/.omnibot npx --yes codex-pets add-collection cats

Validate each installed pet:

sh /workspace/.omnibot/skills/install-codex-pet/scripts/validate_codex_pet.sh claude-pixel

Report the installed display name and /workspace/.omnibot/pets/<pet-id>/. The appearance page discovers the package automatically; do not copy it into another pet directory.

Rules

Keep CODEX_HOME=/workspace/.omnibot for every codex-pets command. The package defaults to /root/.codex, which the Omnibot appearance scanner does not use.

Use the npm CLI directly. Do not generate replacement art, rewrite the downloaded manifest, or hand-build a package.

Accept only lowercase slugs made from letters, digits, and hyphens.

Treat command failures, missing pet.json, missing spritesheet.webp, an id mismatch, or an unexpected spritesheetPath as installation failures.

Never expose credentials or add API keys to commands. CODEX_PETS_API_BASE may be used only when the user explicitly provides a trusted alternate service.

name	install-codex-pet
description	Install shared Codex pet packages into Omnibot with the official codex-pets npm CLI. Use when the user asks to add, install, download, import, or sync a pet by slug or collection, especially requests containing commands such as "npx codex-pets add".