Smithers

Durable AI workflows defined as React components.

Getting started

bunx smithers-orchestrator@latest init

This will scaffold a .smithers/ folder with common simple preconfigured workflows ready to use right away.

Use the smithers cli to work with smithers.

Install

Requires Bun ≥ 1.3.

bun add smithers-orchestrator ai @ai-sdk/anthropic zod

Example

import { createSmithers, Sequence } from "smithers-orchestrator";
import { z } from "zod";

const { Workflow, Task, smithers, outputs } = createSmithers({
  analyze: z.object({
    summary: z.string(),
    severity: z.enum(["low", "medium", "high"]),
  }),
  fix: z.object({
    patch: z.string(),
    explanation: z.string(),
  }),
});

export default smithers((ctx) => (
  <Workflow name="bugfix">
    <Sequence>
      <Task id="analyze" output={outputs.analyze} agent={analyzer}>
        {`Analyze the bug: ${ctx.input.description}`}
      </Task>

      <Task id="fix" output={outputs.fix} agent={fixer}>
        {`Fix this issue: ${ctx.output("analyze", { nodeId: "analyze" }).summary}`}
      </Task>
    </Sequence>
  </Workflow>
));

Each task output is validated against its Zod schema and persisted to SQLite. If the process crashes, Smithers resumes from the last completed node.

Components

Component	Purpose
<Workflow>	Root container
<Task>	AI or static task node
<Sequence>	Ordered execution
<Parallel>	Concurrent execution
<Branch>	Conditional execution
<Ralph>	Loop until condition satisfied

Looping with <Ralph>

<Ralph until={ctx.latest("validate")?.approved} maxIterations={5}>
  <Task id="implement" output={outputs.implement} agent={coder}>
    Fix based on feedback
  </Task>

  <Task id="validate" output={outputs.review} agent={reviewer}>
    Review the implementation
  </Task>
</Ralph>

CLI

smithers up workflow.tsx --input '{"description": "Fix bug"}'
smithers up workflow.tsx --run-id abc123 --resume true
smithers ps
smithers workflow list
smithers approve abc123 --node review

Hot Reload

smithers up workflow.tsx --hot

Edit prompts, config, agent settings, or JSX structure while a run is executing. In-flight tasks finish with their original code; only newly scheduled tasks pick up changes.

Output schema changes and database path changes require a restart.

Gui/TUI

We also have a macos app and iphone app for working with and monitoring your workflows. There is also a TUI. More information about this in coming days.

License

MIT