Riferimento CLI
Il CLI kotao viene con il tuo tema come dipendenza di sviluppo (@kotao/cli). Eseguilo dentro il progetto come bun x kotao così risolve l’installazione locale.
Autenticazione
Sezione intitolata “Autenticazione”kotao auth login
Sezione intitolata “kotao auth login”Accedi per pubblicare CLI interattivo. Usa --device per il flusso OAuth device: il CLI stampa
un URL, lo approvi nel browser (entro ~10 minuti) e la sessione viene salvata globalmente in
~/.config/kotao/cli-session.json.
| Flag | Purpose |
|---|---|
--device |
OAuth device authorization flow (recommended) |
--no-open |
Do not auto-open the browser during device login |
--token <jwt> |
Store an already-minted API bearer token |
--accounts-token <token> |
Store an accounts session token for workspace switching |
kotao auth status / kotao auth logout
Sezione intitolata “kotao auth status / kotao auth logout”Stampa il target della sessione salvata, o rimuovi la sessione salvata.
Destinazioni
Sezione intitolata “Destinazioni”kotao workspace select [workspace-id]
Sezione intitolata “kotao workspace select [workspace-id]”Scegli l’area di lavoro attiva per la pubblicazione CLI. Interattivo se non è dato l’id; la scelta è ricordata.
kotao storefront select [site-id]
Sezione intitolata “kotao storefront select [site-id]”Scegli il target del negozio online per la pubblicazione. Ricordato finché non riconsideri.
La toolchain del negozio online
Sezione intitolata “La toolchain del negozio online”kotao storefront create <directory>
Sezione intitolata “kotao storefront create <directory>”Genera la struttura iniziale di un tema (bun create kotao-storefront esegue questo comando per te). I parametri di connessione
(--shop-id, --site-id, --storefront-api-endpoint, --storefront-api-token, …) precompilano
.dev.vars; --yes esegue il comando senza interazione.
kotao storefront dev / build / preview
Sezione intitolata “kotao storefront dev / build / preview”Local dev server with untrusted-mode parity (dev), a production-parity build (build),
and a local server for the built output (preview). --port <n> where applicable.
kotao storefront codegen
Sezione intitolata “kotao storefront codegen”Genera GraphQL tipizzato dai tuoi documenti #graphql.
| Flag | Purpose |
|---|---|
--schema-url <url> |
Introspect a running Storefront API (default: $STOREFRONT_API_ENDPOINT) |
--schema <file> |
Read the SDL from a file (offline) |
--documents <dir> |
Directory scanned for #graphql documents (default: app) |
--out <file> |
Output (default: app/graphql/storefrontapi.generated.d.ts) |
kotao storefront publish
Sezione intitolata “kotao storefront publish”Pacchetta la tua sorgente tema committed e pubblicala tramite l’API Workspace sul
sito selezionato. Richiede un repository git con bun.lock e kotao.theme.json committati.
| Flag | Purpose |
|---|---|
--site-id <uuid> |
Target site (default: the selected one / $KOTAO_SITE_ID) |
--deployment-id <id> |
Immutable deployment id (default: generated UUID) |
--token <token> |
Workspace API key (default: $KOTAO_API_TOKEN) |
kotao storefront deploy
Sezione intitolata “kotao storefront deploy”La variante CI/servizio di build di publish: passa la sorgente direttamente a un servizio di build tramite
--build-service-url / --shop-id / --token (o le variabili d’ambiente $KOTAO_*).
kotao storefront migrate shopify-theme <directory>
Sezione intitolata “kotao storefront migrate shopify-theme <directory>”Audit a Shopify Liquid or Hydrogen theme export for Kotao migration; --json for
machine-readable output, --out <dir> to emit a migration draft.