docs · updated 2026-05-03

Use the CLI

The optional command-line path for search, inspect, and install.

Run three commands

The CLI stays small: search the catalog, inspect a pet, install the selected package. The App owns the visible overlay after install.

bashterminal

npx the-hatchery list
npx the-hatchery inspect kernel
npx the-hatchery install kernel

Use the same home

Set CODEX_HOME only when you intentionally run multiple Codex homes. Most users should leave the default path alone so the App and terminal see the same pets.

bashterminal

CODEX_HOME="$HOME/.codex" npx the-hatchery install kernel