Wix Headless Entry

Wix Headless Skill — cold-start entry

You are a coding agent, and this is a skill for you to execute. Follow the phases below in order — do not summarize them. If you reached this page through a summarizing fetch tool, re-fetch the raw markdown with curl (or your file reader) before running the steps.

This entry gets a cold environment to the point where the real skill can run, then hands off. It has two phases:

1. Bootstrap (deterministic, scripted). A single script verifies your environment (the Wix CLI) and handles login, so the run starts from a known-good, authenticated state. You just run it and relay its events.
2. Hand off (agentic). Install the skill, then open wix-headless/SKILL.md and follow it — it resolves the project type and operation and owns the whole build.

Three starting points come through here, all handled the same way — run the bootstrap, then hand off:

• new — a prompt with no project (empty CWD)
• connect — an existing frontend/design not yet on Wix (a project on disk without wix.config.json, or a brought-in zip/URL)
• iterate — a project already connected to Wix (.wix/ or wix.config.json present)

The bootstrap only verifies the CLI and logs you in, so it’s fine to run in every case (an existing session just reports logged_in). After it, wix-headless/SKILL.md resolves what to do and owns the build.

Phase 0 — Node (the one manual prerequisite)

The Wix CLI requires Node ≥ 20.11. Check it:

node -v

If that errors (Node not installed) or prints a version below 20.11, install or upgrade Node and re-check — do not try to work around it:

• macOS: brew install node (or nvm install 20 && nvm use 20)
• Linux: nvm install 20 && nvm use 20 (or your distro’s Node 20+ package)
• Windows: winget install OpenJS.NodeJS.LTS (or download from nodejs.org)

Phase 1 — Run the bootstrap (deterministic)

Download the bootstrap script, then run it. It verifies the Wix CLI and handles login, emitting one JSON event per line on stdout. Run it as a background/streaming process and relay its events to the user.

The script is safe and inspectable: it only checks the Wix CLI via npx and drives wix login (a device-code flow) — no other network calls, no filesystem writes. Read it first if your sandbox flags externally-downloaded code — either at the URL below or after downloading; both are the same file.

# macOS/Linux:
curl -fsSL -O https://www.wix.com/skills/headless/entry/bootstrap.mjs
# Windows PowerShell:
iwr https://www.wix.com/skills/headless/entry/bootstrap.mjs -OutFile bootstrap.mjs

node bootstrap.mjs

Relay these events

The script emits one JSON object per line:

Phase 2 — Install the skill and hand off

Install the Wix Headless skills (CI=1 forces plain non-interactive CLI output — keep it on every Wix CLI command):

CI=1 npx skills@latest add wix/skills --yes

The skills land in .agents/skills/.

Then open wix-headless/SKILL.md and follow it. That skill owns the rest of the run — it resolves the project type (managed / self-managed / stripe) and, for managed, the operation (create / connect), then runs Discovery → Setup → Seed → the SDK handoff, and for managed create/connect it also scaffolds, builds, and releases.

• Don’t scaffold, install apps, or release by hand here — the skill does all of that (SETUP.md, references/managed/CREATE.md, etc.). This entry stops at logged in.
• You’re already authenticated from Phase 1, so the skill’s managed auth step (references/managed/AUTHENTICATION.md §1 whoami) will pass without prompting again.