Skip to main content

Documentation Index

Fetch the complete documentation index at: https://smithers.sh/llms.txt

Use this file to discover all available pages before exploring further.

​
0.20.3

Patch release: two new top-level CLI commands stream the published docs to stdout, a real-world Bun-internals port workflow lands as an example, and <Loop> / <Sequence> accept a typed key prop.

​
CLI

  • smithers docs. Fetches https://smithers.sh/llms.txt (the concise docs index for LLMs) and writes it to stdout. With --json, returns { url, content } instead.
  • smithers docs-full. Fetches https://smithers.sh/llms-full.txt (the full ~8k-line docs bundle for LLMs) and writes it to stdout. Same --json behavior as docs. Both commands fetch at runtime against the published docs site, so output always reflects the latest shipped docs and the CLI bundle stays small. Fetch failures surface as DOCS_FETCH_FAILED / DOCS_FULL_FETCH_FAILED with a non-zero exit.

​
Components

  • <Loop> and <Sequence> accept key. LoopProps and SequenceProps in @smithers-orchestrator/components now declare key?: string explicitly, so TypeScript users can pass a stable key when iterating without a TS error. Matches the React contract the renderer already honored at runtime.

​
Examples

  • examples/bun-port-smithers. A new production-grade example workflow that drives porting Rust crates to Bun internals using Smithers subflows: lifetime classification, Phase-A port, crate compile bringup, ungate-and-proper-port, panic-probe swarm, test swarm, and audit sweeps. Demonstrates real subflow execution, agent wiring, prompt colocation, and zod schemas at scale — ~2,000 lines of workflow code in examples/bun-port-smithers/.

​
Docs

  • Landing + intro copy refresh. docs/index.mdx and docs/introduction.mdx lead with “Smithers powers TypeScript teams to run long AI coding workflows that survive crashes and handle approvals, retries, and restarts.”
  • Background-agents post URL fix. Corrected blog link in docs/why/background-agents.mdx (#139, thanks @dneljo).