Skip to main content
hello is the starter workflow: a single agent <Task> that runs the prompt in .smithers/prompts/hello.mdx and greets whoever you name. It is the smallest complete workflow in the init pack and the recommended starting point for authoring your own. Edit the prompt (plain Markdown) to change what it does.
bunx smithers-orchestrator workflow run hello --name Ada
With no arguments, name defaults to "world", so workflow run hello works on its own.

Inputs

InputTypeDefault
namestring"world"

How It Runs

  1. Reads the input name (defaults to "world").
  2. Runs one agent <Task> whose prompt is .smithers/prompts/hello.mdx, with name interpolated into the Markdown via {props.name}.
  3. Returns the agent’s greeting.
Because the instruction lives in a Markdown prompt rather than code, changing the behavior is just editing .smithers/prompts/hello.mdx (for example, ask for a haiku instead of a greeting) and re-running.

Output Shape

hello returns the single task’s text output (the generated greeting). The run log records the agent invocation and its result.

Use it when

  • You are learning Smithers and want the smallest end-to-end run.
  • You are scaffolding a new workflow and want a known-good single-task template to grow from.

Use something else when

Resume & retry

Runs are durable and resume with up --resume. hello is a single task, so a resume simply re-runs that task if it had not completed.