---
title: Quickstart
description: "Get Smithers running end to end: scaffold the workflow pack, launch a workflow, inspect the run, and choose your next path."
---

By the end of this page you will have done the four things that matter for a real first run:

1. installed the [workflow pack](/installation)
2. launched a workflow
3. inspected the resulting run
4. chosen whether to go deeper on [CLI operations](/cli/quickstart) or [JSX authoring](/jsx/quickstart)

## 1. Scaffold the Workflow Pack

```bash
bunx smithers-orchestrator init
```

That creates a local `.smithers/` directory with seeded workflows, shared prompts, reusable components, and agent configuration.

## 2. Launch a Seeded Workflow

```bash
bunx smithers-orchestrator workflow run implement --prompt "Add rate limiting to the API"
```

This runs the seeded `implement` workflow that `init` installs into `.smithers/workflows/`.
It is the fastest way to see Smithers behave like a [workflow runtime](/concepts/workflows-overview) instead of a library on a shelf.

## 3. Inspect the Run

Once the workflow starts, use the CLI to see what happened:

```bash
bunx smithers-orchestrator ps
bunx smithers-orchestrator inspect <run-id>
bunx smithers-orchestrator logs <run-id> --tail 20 --follow false
```

Use `ps` to find the run ID if you do not already have it.

## 4. Understand What You Just Used

Every workflow gets:

- [SQLite](https://sqlite.org) persistence
- [Resume after restarts](/concepts/suspend-and-resume)
- Retries, [approvals](/concepts/approvals), [loops](/components/loop)
- Observability and [CLI tooling](/cli/overview)

You just used both Smithers surfaces together:

- the [workflow pack](/installation) gave you runnable workflows
- the [CLI](/cli/overview) launched, inspected, and reported on the run

## Next Steps

- [CLI Quickstart](/cli/quickstart) to learn the terminal workflow in a more systematic way.
- [CLI Overview](/cli/overview) for the full command surface, including logs, approvals, and signals.
- [JSX Quickstart](/jsx/quickstart) to build a workflow from scratch.
- [Workflows Overview](/concepts/workflows-overview) to connect the run you just started to the runtime model.