Skip to main content
The commands below are operated by the coding agent. If you are an agent, run them yourself on the human’s behalf; never hand them to the human. If you are a human, ask your agent for the outcome and it runs these for you; the initial init is the only command worth typing by hand before an agent is set up.
1

Scaffold a project

init creates .smithers/ (the focused authoring workflows, DDD spec/UI closure, and agent config). Add --template <id> when you want a create-workflow-driven starter request and follow-up notes; it does not install an archived workflow. Run bunx smithers-orchestrator starters to browse template IDs.
2

Run a workflow

Point a seeded workflow at a prompt and Smithers starts a durable run.
3

Inspect the run

Watch run state, tail the event log, and read structured output as it executes.
4

Resume after a crash

Every completed step is persisted, so a crashed or stopped run resumes from its last checkpoint.
init installed the smithers skill for your coding agents automatically. Just ask for the outcome (“orchestrate an agent to add rate limiting and keep iterating until the tests pass”) and your agent runs Smithers for you.
For a full worked example, see the Tour. For every CLI command see the CLI catalog.