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.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 Command Purpose 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 Command Purpose 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 Command Purpose sitekit dashboard [--port <n>] [--open]The Auxon copy dashboard — a local writing surface over the copy layer. Loopback-only, port 4321. sitekit content exportProject the store into per-page + brand Markdown (content/copy/*.md). sitekit content importApply edited copy Markdown back into the store and swap the anchored HTML spans. sitekit content set <page>:<field> "<text>"One deterministic copy edit — no LLM. sitekit content apply <file>A batch of copy edits from JSON — no LLM. sitekit content statusPrecise drift report across copy doc ↔ store ↔ HTML. sitekit content anchorRetroactively stamp data-sk-copy anchors onto existing pages. sitekit content <show|lint>Inspect the parsed tree; run the content + playbook checks. sitekit edit-bridge [--port <n>] [--once]A localhost-only receiver the front-end editor posts copy edits to. sitekit transcribe <video>Transcribe a screencast’s narration + sample timed frames.
See Editing copy for which surface fits which situation.
Packs Command Purpose sitekit playbook <save|list|show|delete|check>Save and manage named compositions. sitekit style <list|show|docs|init|check|verify|inspect|palette|activate>Inspect and manage the visual dimension. sitekit style capture <name> --url|--screenshot|--bundle [--screencast]Rip a style pack from external evidence. Includes a Playwright motion pass on URL sources. sitekit style author <name>Scaffold a workshop style pack + install the authoring skill. sitekit voice <list|show|docs|init|check|verify|inspect|activate>Inspect and manage the voice dimension. sitekit voice capture <name> --urlInfer a voice pack from an existing site’s copy. sitekit voice author <name>Scaffold a workshop voice pack + install the authoring skill. sitekit shape <list|show|inspect|verify|author|eject>The structural dimension; eject writes a compound’s page list into the manifest. sitekit valence <list|show|inspect|init|check|verify|author|activate>The optional vertical overlay.
See Capturing a brand for every source type and how the motion pass works.
Experiment Command Purpose sitekit experiment <new|variant|start|status|promote|end|list|arm>The on-brand A/B and continuous-optimization loop.
Brand & structure Command Purpose 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 Command Purpose 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 Command Purpose sitekit agents <emit|check|mcp|collector|stats>Serve the site to AI agents — llms.txt, Schema.org, and the MCP surface.
Command Purpose sitekit media <add|list|show|generate|inspect|remove|sync|search|add-from-search>The image catalog, vision captioning, and generation pipeline.
Infrastructure & secrets Command Purpose 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 Command Purpose 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.
Lifecycle The commands above, arranged as the loops you actually run.
