Commands
Every command runs as python spidercaster.py followed by the command name. Add --help to any command to see its options. Offline builds and rebuilds cost zero tokens.
Build and preview
init
Scaffold a project with a brief.md file and a copy folder.
build
Turn a project, or a site.json with --from, into a static site. Offline costs zero tokens.
compose
Offline compose of one project. Zero tokens, no publish.
refine
Patch one section of a built site, at a small token cost.
check
Run the built-in checks against a built site.
visit
A static visit check of a built site.
serve
Preview a built site on localhost.
start
First run. The doctor, the demo site, and the studio desk in your browser, at zero tokens.
Desk, crew, and library
studio
A localhost desk for plan, paint, check, and preview. It does not publish.
ui
A stdio face with a composer and the ticket and ledger. Propose-only, zero tokens by default.
crew
Run the seven hands on one project. It does not publish.
library
The vendor vault index, the molds, and the live-use ledger.
sections
List the section types and their data fields.
models
Show the provider chain, free models first. Add --probe to query it live.
doctor
Report Python, molds, frames, seats, and hand order.
shipcheck
Say whether the app is ready to ship.
Seats, parts, and tools
seat
Print one seat pack.
parts
Index every part manifest and assemble one site that uses them.
tools
List catalog rows and apply one built part onto a page.
Build flags
--offline
A zero-token build that gives the same result every time.
--from
Rebuild from an existing site.json at zero tokens.
--out
The folder the site is written to.
--template
modern, editorial, or bold, with --dark or --light.
--indexable
Leave out the noindex line. Pages are noindex until approved.
--host
The site origin for sitemap.xml, used only with --indexable.
--allow-paid
Allow paid models. Without it, only free models run.
--dry-run
Preview the plan at zero tokens. Writes nothing.
Check, preview, and start flags
--expect-noindex
Check a draft. The noindex line must be on every page.
--expect-indexable
Check a site built with --indexable.
--project
Pass the project folder so the checker can match every visible line against your copy.
serve --port
Preview on another port. The default is 4173, and the next free port is used if it is busy.
start --project
Use another demo project. The default is demo-local.
start --no-build
Skip building the demo site and open the desk.
studio --port
Open the studio desk on another port. start serves it at port 4180.
Refine flags
refine takes a site folder and an instruction in plain words, then patches one section.
--section
The id of the section to patch. Without it, refine picks the closest match.
--offline
Theme flips only, at zero tokens. It reads template names, light or dark, and a hex colour.
--dry-run
Preview an offline refine as a diff at zero tokens. Writes nothing.
--rollback
Restore a snapshot from the _attempts folder at zero tokens.