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.