Introduction

Build Smithers workflows with JSX components on top of a durable runtime.

Smithers is a JSX-first framework for deterministic, resumable AI workflows. Define the workflow as a TypeScript component tree; Smithers handles execution ordering, persistence, approvals, retries, and observability.

Start Here

bunx smithers-orchestrator init

This creates .smithers/ with pre-built workflows, shared components, prompt templates, and configuration. Run a seeded workflow:

bunx smithers workflow implement --prompt "Add input validation to the signup form"

• Quickstart — Build a custom workflow from scratch.
• Workflows Overview — Core principles and execution model.

Concepts

1. Workflows Overview — What workflows are and how execution works.
2. Reactivity — How the component model enables plans that evolve.
3. Control Flow — Sequential, parallel, conditional, iterative.
4. Workflow State — Data flow between tasks via the context API.
5. Agents and Tools — AI agents and built-in tools.
6. Suspend and Resume — Durability, crash recovery, resumability.
7. Human-in-the-Loop — Approval gates and denial policies.

Runtime

All workflows share:

• Durable execution and resumability
• Retries, timeouts, approval gates
• SQLite persistence
• Parallel execution and loops
• Structured events, metrics, observability

Next Steps

• JSX API — Component model and authoring layer.
• CLI Reference — Run, resume, inspect workflows.
• Implement-Review Loop — Recommended production pattern.