Skip to content

CLI reference

Use shoplifter --help or shoplifter <command> --help for installed-version syntax. The following covers CLI 0.1.8 and marks skill installation in the prepared 0.1.10 release.

Command Arguments Behavior
init <directory> <id> [sdk-tarball] [contract-tarball] Create a new standalone project.
scaffold <homepage|header|footer> Create a missing component; never replace an existing component.
fields / editor / assets / data / design <set|remove|append> <path> [json] Validate and edit project contracts.
migrations <set|remove|append> <path> [json] Edit versioned declarative migrations.
fixtures [generate|reset] Generate or explicitly replace fixtures.
types — Generate fixture data and TypeScript declarations.
validate [output] Validate project inputs, or also built image output.
dev — Generate and start npm run dev.
files — Inspect the exact upload file selection and sizes.
dependencies sync [sdk-archive] [contract-archive] Explicitly update the approved runtime and dependency lock.
login [channel-code] Request dashboard approval for a channel.
logout — Revoke the current credential.
publication <action> <channel> [revision] [language] Perform a channel-scoped publication operation.
skills (0.1.10 after publication) install --agent <codex|claude|all> [--global] [--version <version>] [--force] Install the official skill bundle.

Publication actions: upload, stage, preview, preview-link, build, publish, status, logs, retry, retry-deployment, activate, rollback. Only preview-link accepts --reset. See publishing for prerequisites and revision requirements.

All commands require Node 24. Runtime downloads and skill installation need network access but no dashboard login. Remote publication requires channel authorization. Skill installation defaults to the current directory; --global selects your home directory.