smithers-init

name	smithers-init
description	Install the local Smithers workflow pack into .smithers/. Pass an optional prompt to also launch the create-workflow builder after init. Run `smithers init --help` for usage details.
requires_bin	smithers
command	smithers init

smithers init

Install the local Smithers workflow pack into .smithers/. Pass an optional prompt to also launch the create-workflow builder after init.

Arguments

Name	Type	Required	Description
prompt	string	no	Optional plain-English task: after init, launch the create-workflow builder with this prompt pre-filled

Options

Flag	Type	Default	Description
--agent	string		Preferred coding agent id (e.g. claude, codex, pi). Skips the interactive agent question.
--tutorial	boolean	true	After install, open a hijacked tutorial session hosted by your preferred agent (interactive init only). Use --no-tutorial to skip.
--force	boolean	false	Overwrite existing scaffold files
--agentsOnly	boolean	false	Only create .smithers/agents/ and leave the rest of the workflow pack untouched
--install	boolean	true	Run bun install inside .smithers/ after scaffolding (--no-install to skip)
--addAgents	boolean	false	After scaffolding, launch the interactive agents add wizard to register one or more accounts.
--skill	boolean	true	Install the curated smithers skill into your detected coding agents (Claude Code, Pi, Codex, OpenCode, Kimi, Amp, Antigravity) and, if a CLAUDE.md or AGENTS.md exists, append guidance on when to use smithers.sh workflows. Use --no-skill to skip.
--global	boolean	false	Scaffold the global pack in ~/.smithers (honors SMITHERS_HOME) instead of ./.smithers. Global workflows run from any repo; a repo's local pack takes precedence.
--updatePrompt	boolean	true	In an interactive terminal, when shipped pack files differ from the latest bundled version, ask which to update (warning when a shared component is selected). Use --no-update-prompt to skip the question.
--template	unknown		Show next steps for a canonical starter template ID after init
--yes	boolean	false	Non-interactive: skip prompts and use defaults (safe for agents and CI). Alias: --non-interactive.
--nonInteractive	boolean	false	Non-interactive: skip prompts and use defaults (safe for agents and CI). Alias: --yes.