CodexTheme Tools
Create Theme
Source visible · explicit apply · backup first

Install a Codex Pet, and keep the way back.

Review a local Pet directory or ZIP, see the exact target and hashes, then opt into a staged install. Replacement and uninstall move the current package into a private backup first, so the returned transaction ID can restore it.

Download reviewed source ZIPSHA-256 fileInspect the Pet in browser

v0.1.0 · 15.6 KB · 065b9c414e11d1370f9dc7bb6fd34dc71ec9fb0a3d2ee844cd36cf84b194a74a

Local transactionPatchlet
restorable
Install appliedbackup → stage → rename → receipt
No download, account, prompt, code, or app-bundle patch
Real local lifecycle

Plan, apply, diagnose, remove, restore.

This source tool writes only inside the active Codex home's custom-Pet folder and its own private recovery directory. It never reads Codex auth, sessions, logs, memories, projects, or Desktop global state.

  • Strict manifest, file, archive, atlas structure, size, path and SHA-256 checks.
  • Files stage on the destination filesystem before an atomic rename.
  • Replacement and uninstall return a durable restore transaction.
  • Desktop selection remains explicit in Settings → Appearance → Pets.
Four review gates

This is not an opaque one-click installer.

The download is source code. Nothing runs until you extract it, review it, install its pinned dependency, inspect a local Pet, and add --apply yourself.

1

Review and plan

npm ci --omit=dev --ignore-scripts
node ./bin/codextheme-pet.mjs plan /ABSOLUTE/PATH/TO/PET.zip
2

Apply the reviewed plan

node ./bin/codextheme-pet.mjs install \
  /ABSOLUTE/PATH/TO/PET.zip --apply
3

Doctor and select

node ./bin/codextheme-pet.mjs doctor pet-id
node ./bin/codextheme-pet.mjs select pet-id
4

Uninstall or restore

node ./bin/codextheme-pet.mjs uninstall pet-id
node ./bin/codextheme-pet.mjs uninstall pet-id --apply
node ./bin/codextheme-pet.mjs restore TRANSACTION-ID --apply
Narrow write scope

Two owned locations, no remote service.

Package sources are local. The manager has no network client, registry, analytics, updater, login, or hidden postinstall script.

01 · Installed data

Custom Pet folder

CODEX_HOME/pets/<id> contains one validated kebab-case Pet with allowlisted, non-linked data files.

02 · Private recovery

Private recovery folder

CODEX_HOME/.codextheme-pet-manager keeps backups, receipts and recoverable trash local with private permissions.

03 · Selection boundary

Manual Desktop choice

The CLI returns Settings steps and an official one-session TUI override; it does not patch internal Desktop state.

What remains outside this release

This is not a signed native macOS or Windows application. A successful file transaction does not prove that Codex displayed the Pet, that every frame rendered, or that Desktop switched it. Refresh the custom-Pet list, choose the item manually, wake it with /pet, and keep the transaction ID until recovery is verified.

Windows-native and WSL behavior stay separate: upstream reports unresolved WSL custom-Pet discovery, so the doctor warns there rather than claiming universal compatibility.

Add the optional Companion bridgeRead the manual install guide