CLI reference
Every spec-init command and flag. The same CLI ships identically on npm (npx spec-init) and PyPI (pipx install spec-init).
Commands
spec-initWith no arguments on a terminal, launches an interactive welcome that guides new-vs-existing, persona, and integrations.init <name>Scaffold a brand-new project into <name>/. Refuses a non-empty directory unless --force.reinit [dir]Adopt Throughspec in an existing project in place, keeping your files unless --force.customizeToggle an integration (--add / --remove) or swap the persona (--persona) for a scaffolded project.add-skill <name>Copy one skill from the payload catalog into .claude/skills/.upgradeThree-way merge a newer template into your project; conflicts surface as git-style fences.doctorVerify a scaffolded project has the required files, template-version, and snapshot.Flags
--persona <p>vibe | student | engineer | team - tunes CLAUDE.md tone and verbosity.--integrations <a,b>Comma-separated integration names to activate at init (see the Integrations page).--add / --remove <name>Used with customize to toggle a single integration.--forceOverwrite existing files (init) or replace existing spec files (reinit).--dry-runPrint the plan and write nothing.-h, --help / -v, --versionShow help text or the CLI version.Examples
# new project, engineer persona, two integrations npx spec-init my-app --persona engineer --integrations graphify,caveman # adopt into an existing repo, keeping your files cd my-existing-project && npx spec-init reinit # add an integration later spec-init customize --add obsidian # pull a newer template spec-init upgrade