@usedetach/cli

The cms command for Detach storefronts.

npm install -D @usedetach/cli

cms login              # device flow; token stored in ~/.config/detach/credentials.json
cms init               # idempotent setup: config, .env.local, types, manifest registration
cms components push    # register this build's component manifest with an environment
cms content validate   # CI gate: does the environment's published content still render?
cms dev                # attach to a running dev server and expose it as an editor preview target
cms types generate     # typed content reads from the registered manifest

cms init is the path to run — and to re-run — when a storefront misbehaves; it never overwrites and reports every step. --check changes nothing.

In CI, CMS_CI_KEY / CMS_MANAGEMENT_KEY take precedence over stored credentials, so builds stay deterministic. cms content validate exits 1 on errors (a placed component the build no longer defines, a valued field removed or retyped), --strict also fails on warnings, and --json is for machines.