Naar hoofdinhoud gaan

​
Kazzle CLI

Gebruik de Kazzle CLI om app-commando’s uit te voeren in ontwikkeling en preview: 
kazzle run -- <command>
Alles na -- is het werkelijke commando. Kazzle injecteert eerst de runtime-omgeving. kazzle run is alleen voor ontwikkeling en preview. Het hoort in het dev-script, nooit in start. In productie injecteert de geïmplementeerde runtime PORT, HOST en secrets rechtstreeks, en is het productiecommando het basiscommando (bijv. bun run index.ts). De kazzle CLI is niet geïnstalleerd in geïmplementeerde images, dus een productiecommando dat kazzle run aanroept, crasht met kazzle: command not found.

​
Wat kazzle run injecteert

  • secrets uit de env-entry van de component in kazzle.config.ts
  • PORT en HOST
  • URL’s van sibling-componenten zoals KAZZLE_APP_COMPONENT_SERVER_URL
  • Kazzle runtime-identiteit zoals app-ID en componentnaam

​
Voorbeeld

{
  "scripts": {
    "dev": "kazzle run -- bun --watch server/index.ts",
    "start": "bun server/index.ts"
  }
}
dev wordt uitgevoerd via kazzle run zodat Kazzle de preview-poort en runtime-omgeving kan injecteren. start is het basiscommando — productie injecteert PORT/HOST/secrets zelf. Plaats geen geheime collectienamen in package.json. Plaats ze in kazzle.config.ts. 
components: [
  {
    name: 'server',
    type: 'process',
    path: './server/index.ts',
    env: { collection: 'my-app', environment: 'local' },
  },
]

​
Een checkout aan een app koppelen

kazzle run moet weten welke app deze directory is. Resolutievolgorde:
  1. --app=<appId> op de commandoregel
  2. KAZZLE_APP_ID omgevingsvariabele (automatisch ingesteld wanneer Kazzle een bewaakte component start)
  3. .kazzle/link.json omhoog gelopen vanuit de huidige directory
Als geen van deze opgelost wordt, sluit kazzle run af met: 
Error: This directory is not linked to a Kazzle app. Run `kazzle link` to fix.
app { action: "create" } schrijft <checkout>/.kazzle/link.json automatisch — zoals Vercel’s .vercel/project.json. Het bestand is per clone en gitignored. Na een frisse git clone van een bestaande app, voer uit: 
kazzle link              # match de huidige directory tegen de app-checkouts van je Space
kazzle link --app=<id>   # force een specifieke app
kazzle unlink            # verwijder het linkbestand
De AI kan een ontbrekende link uit een thread repareren met app { action: "link", appId }.