> ## Documentation Index
> Fetch the complete documentation index at: https://smithers.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# What Smithers Is

> Hand your coding agent real, multi-step work and trust it to finish durably, with retries, approvals, and full visibility.

You already talk to a coding agent: ask for a change, it works a few minutes, you read the result. That works for small, synchronous edits, but falls apart once work gets long.

## The treadmill

A single agent in a chat window is a black box on a treadmill: it forgets what it decided ten steps ago, stalls mid-job waiting for a nudge, and loses everything if the process crashes.

The model is good; nothing underneath it is durable, so there's no record of what finished and nothing to resume from.

## From chat to durable background work

Smithers moves the work off the treadmill and into a durable runtime: you describe a real job and it runs in the background.

Every step is persisted the moment it finishes, so the runtime always knows what's done and what's next, and stays observable instead of a black box.

<Frame caption="Smithers is the durable layer between you and the models, the part that doesn't change when the agent topology does.">
  <img src="https://mintcdn.com/smithers/xegNOoNr9NbWn5pb/images/why/three-layer-stack.svg?fit=max&auto=format&n=xegNOoNr9NbWn5pb&q=85&s=f43c21cd7870cd876e6e0c690b414bf1" alt="Three-layer diagram: your prompt on top, Smithers as the durable orchestration layer in the middle, and interchangeable agents and models at the bottom" width="760" height="360" data-path="images/why/three-layer-stack.svg" />
</Frame>

## You don't write workflows. You talk to your agent.

You don't click a GUI or write code. Install the `smithers` skill into your coding agent, and **you drive it through your agent**. Say what you want in plain language: it picks the workflow, starts the run, watches it, and brings back the result, or pauses when it needs a decision. You stay in the chat you already use.

TSX workflows and the CLI exist to read, but the primary path is a sentence to your agent.

## What you get

Four guarantees a chat-window agent can't give you, on any agent, any model, any machine.

| You get                        | What it means for you                                                                                                                                                |
| ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Durable runs**               | Work persists every step, so a crash, closed laptop, or flaky tool is a resume point, not lost work. Runs go for minutes or days.                                    |
| **Any agent, any model**       | Point each step at whichever agent and model fits best, such as Claude Code, Codex, and more, and swap them without redoing the work.                                |
| **Review loops and approvals** | Tasks retry on failure, loops run until tests pass or the review signs off, and the run pauses for your approval on anything that matters.                           |
| **A focused authoring pack**   | Fresh init ships `create-workflow`, `create-skill`, and `docs-driven-development`; former recipes remain available as copyable examples under `examples/init-pack/`. |

<Frame caption="The same job runs across different agents and models without rewriting the work, proof that Smithers isn't tied to one lab or one harness.">
  <img src="https://mintcdn.com/smithers/xegNOoNr9NbWn5pb/images/why/any-agent.png?fit=max&auto=format&n=xegNOoNr9NbWn5pb&q=85&s=657f88f7bbdd4de149606c7de850a1ed" alt="One Smithers workflow running tasks across multiple different coding agents and models side by side" width="3200" height="1800" data-path="images/why/any-agent.png" />
</Frame>

## The magic moment

Open your coding agent and say:

> "Add rate limiting to the API and don't stop until it builds, validates, and the review signs off."

A durable run writes the code, runs the build and tests, loops on failures, and pauses for your sign-off once review approves.

> "Keep working on reducing our flaky tests and don't stop until I tell you to."

A long-horizon run that grinds on flaky tests in the background, surviving crashes until you call it off.

> "Migrate the dashboard to the new gateway APIs. Show me the milestone plan before you start, then work through it."

Plans the migration, pauses for approval, then executes milestone by milestone, resuming exactly where it left off if interrupted.

<Frame caption="A run survives a hard crash mid-task and picks up exactly where it left off, with no lost work and no restart from scratch.">
  <img src="https://mintcdn.com/smithers/xegNOoNr9NbWn5pb/images/why/crash-resume.gif?s=3c82511790c9e61493c7c64f7da35d0d" alt="A Smithers run is killed partway through, then resumes from the last persisted step instead of starting over" width="1180" height="640" data-path="images/why/crash-resume.gif" />
</Frame>

None of these need a workflow file or a terminal: ask, and Smithers delivers more structure and quality than a one-shot prompt.

## Read next

<CardGroup cols={3}>
  <Card title="Get started" icon="rocket" href="/guide/get-started">
    **Tutorial:** install the skill and run your first durable job.
  </Card>

  <Card title="What you can do" icon="sparkles" href="/guide/what-you-can-do">
    **Reference:** the outcome catalog of real jobs you can hand off, and what to say.
  </Card>

  <Card title="The few concepts you need" icon="book-open" href="/guide/concepts">
    **Explanation:** the handful of ideas (runs, frames, approvals) behind it.
  </Card>
</CardGroup>
