sitekit is agent-first and deterministic — no prompts, no editor, no surprise network calls. Most commands accept a global --json flag that switches output to a structured envelope, so an agent (or a script) can consume the result. In practice your agent runs these; this page is the map of what exists.
This is the shape of the CLI, not every flag. For the exhaustive, always-current detail on any command, run sitekit help <command> (add --json for structure), or read the bundled skill’s command reference. The skill ships in lockstep with your installed version.

Conventions

  • Workspace-aware. Most commands walk up from the current directory to find the workspace marker (sitekit.workspace.json), so they work from any subdirectory. There’s no --cwd flag — cd to operate elsewhere.
  • --json everywhere. A success envelope on stdout, an error envelope (with an E_* code) on stderr.
  • Exit codes. 0 on success; non-zero on failure, with the specific E_* code in the envelope.
  • Always safe to run: sitekit --version, sitekit help, sitekit init, sitekit init-skill.

Setup & build

CommandPurpose
sitekit init <name>Scaffold a new workspace (sitekit.workspace.json + directories).
sitekit run [playbook]Emit one or more pages bound to a composition (voice + style + shape). The canonical build verb.
sitekit verify [path]Run the conformance pipeline (workspace, single file, or fragment mode).
sitekit deployShip the Worker + Pages to Cloudflare (--env staging|prod), verify-gated by default.
sitekit doctorDiagnose setup; detect and migrate legacy layouts (--migrate --apply).
sitekit serveLocal dev server and live, prompt-to-page generation.

Maintain & edit

CommandPurpose
sitekit inspect [path]Read the site model and detect drift — no agent call.
sitekit reconcileApply surgical edits, consistency passes, and no-agent re-stamps (--restamp).
sitekit page <rename|move|delete>Page lifecycle — rewrites inbound links and the content binding.
sitekit statusWorkspace status at a glance.
sitekit upgrade-packsAdopt newer versions of the packs a site is built against.

Content & copy

CommandPurpose
sitekit content <export|import|set|apply|status|anchor|show|…>The copywriter-editable copy layer.
sitekit edit-bridgeA localhost-only receiver the front-end editor posts copy edits to.
sitekit transcribe <video>Transcribe a screencast — an aid for style capture.

Packs

CommandPurpose
sitekit playbook <save|list|show|delete|check>Save and manage named compositions.
sitekit style <list|author|capture>The visual dimension.
sitekit voice <list|author|capture>The voice dimension.
sitekit shape <list|author>The structural dimension.
sitekit valence <list|author>The optional vertical overlay.

Experiment

CommandPurpose
sitekit experiment <new|variant|start|status|promote|end|list|arm>The on-brand A/B and continuous-optimization loop.

Brand & structure

CommandPurpose
sitekit brand <evolve|record>Feed a business change forward into the live site.
sitekit site <add-page>Add new real estate to an existing site.

Foreign sites

CommandPurpose
sitekit adopt <name>Record a brand binding for a site sitekit didn’t build.
sitekit alignJudge a page or an edit (--url / --fragment) against the adopted brand.

Agent discovery

CommandPurpose
sitekit agents <emit|check|mcp|collector|stats>Serve the site to AI agents — llms.txt, Schema.org, and the MCP surface.

Media

CommandPurpose
sitekit media <add|list|show|generate|inspect|remove|sync|search|add-from-search>The image catalog, vision captioning, and generation pipeline.

Infrastructure & secrets

CommandPurpose
sitekit add <checkout|auth|customer-portal|promo-codes>Activate a tier or addon.
sitekit secrets <set|list>Manage secrets (set over stdin, never hardcoded).
sitekit stack <inspect|requires|check>Provider and dependency introspection.
sitekit configure <key> <value>Set workspace configuration.
sitekit manifestPrint the effective manifest.
sitekit stripe sync / sitekit promo <…>Stripe and promo-code management.

Skill & help

CommandPurpose
sitekit init-skillInstall the bundled agent skill into your harness.
sitekit help [command]Machine-readable help (--json for structure).
sitekit --versionPrint the installed version.

The agent skill

Where the exhaustive, always-current command detail lives.

Workflows

The commands above, arranged as the loops you actually run.