Get Started

One command. One editable .mdx file. Your first workflow runs in 30 seconds.

1. Run one command

   From inside your project:

   bunx smithers-orchestrator init
   

   This creates .smithers/ and seeds .smithers/prompts/hello.mdx - your editable hello-world workflow. Open it, change the instruction, and the next run picks it up. No TypeScript required.

2. Run your hello-world workflow

   bunx smithers-orchestrator workflow run hello
   

   A durable run completes and you see the output. Edit .smithers/prompts/hello.mdx, run it again, watch the output change.

Read next

You ran a workflow. From here, pick by what you need next.

Talk to your agent

How-to: phrase requests so your agent picks the right workflow every time.

Watch and steer

How-to: follow a live run, clear approvals, and redirect without touching code.

What you can do

Reference: the full catalog of outcomes you can hand off, and what to say.

The few concepts you need

Explanation: the handful of ideas behind durable runs, gates, and loops.