Skip to main content
The coding agent runs these commands. Agents: run them on the human’s behalf, never hand them off. Humans: ask your agent for the outcome; it runs these for you. Exception: type the initial init yourself, before an agent exists.
1

Scaffold a project

init creates .smithers/: authoring workflows, DDD spec/UI closure, and agent config. --template <id> requests a create-workflow-driven starter with follow-up notes, not an archived workflow. Browse template IDs with bunx smthrs starters.
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 persists, so a crashed or stopped run resumes from its last checkpoint.
init auto-installs the smithers skill for your coding agents. 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.
Full worked example: Tour. Every CLI command: CLI catalog.