Troubleshooting

Fixes for the issues people hit most. If none apply, reach out via Contact us.

"spec-init: command not found"

Use npx spec-init (no global install needed), or install globally with npm install -g spec-init. On the Python side, pipx install spec-init then spec-init.

init refuses my directory

init will not overwrite a non-empty folder. For an existing project use spec-init reinit (non-destructive), or pass --force to init only if you truly want to overwrite.

upgrade left conflict markers

That is expected when you edited a template-managed file. Resolve the <<<<<<< / ======= / >>>>>>> fences by hand, then commit - exactly like a git merge.

Docs search returns nothing locally

The search index is generated at build time. In npm run dev it does not exist yet. Run npm run build (which builds the index), then serve the out/ directory to use search.