Troubleshooting

windcraft sync says "not signed in"

Run windcraft login --api-key wc_live_… --project-id <id> from your project root.

Manifest fetch failed

Check the API status at status.windcraft.io and your network. Any cached tokens.json in .windcraft/ remains usable until the API is back.

The MCP server doesn't show up in Cursor

Restart Cursor after editing ~/.cursor/mcp.json. Check stderr in Cursor's MCP panel for the [windcraft mcp] log.

Tokens edited in dashboard, didn't sync

Run windcraft sync manually, or use windcraft sync --watch to keep the CLI polling. If your repo is connected, click Open sync PR from the project's settings page to land the change as a PR.

402 on project create

Your subscription is not active. Visit /billing to subscribe or reactivate. Windcraft does not offer a free trial — see the pricing FAQ for why.

Locked out after enabling 2FA

Use one of the backup codes shown when you enabled 2FA. If you've lost all backup codes, contact hello@windcraft.io from the email tied to your account.

GitHub webhook install failed

The user who connected the repo needs admin rights on it. Reconnect from the project's settings; the dashboard surfaces a hint when the webhook didn't install.