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

# seed

> Seed data into a running clone — fixtures, AI, or both.

```bash theme={null}
asymmetric seed <id> [options]
```

Seeds a running clone into a known starting state. Fixtures apply deterministic
SQL directly; `--ai` generates realistic data and creates it through the clone's
REST API. For the conceptual difference, see [Seeding](/concepts/seeding).

## Arguments

| Argument | Required | Description                      |
| -------- | -------- | -------------------------------- |
| `<id>`   | yes      | The clone id, e.g. `slack-a1b2`. |

## Options

| Option                 | Description                                                                |
| ---------------------- | -------------------------------------------------------------------------- |
| `-f, --fixture <name>` | Named fixture pack (deterministic SQL), e.g. `acme-corp`.                  |
| `--ai`                 | Generate AI data using the template's defaults. Needs `ANTHROPIC_API_KEY`. |
| `--json`               | Output the seed result as JSON instead of the human summary.               |

You must pass at least one. With neither, the command prints
`Nothing to seed. Pass --fixture <name> and/or --ai.` and exits `1`.

## Examples

Deterministic fixture:

```bash theme={null}
asymmetric seed slack-a1b2 --fixture acme-corp
```

AI-generated data:

```bash theme={null}
asymmetric seed slack-a1b2 --ai
```

```
  ✓ seeded slack-a1b2  (ai: 20 (0 rejected))
```

Both at once (fixture backbone + AI on top):

```bash theme={null}
asymmetric seed slack-a1b2 --fixture acme-corp --ai
```

```
  ✓ seeded slack-a1b2  (fixture: 150 rows · ai: 78 (3 rejected))
    ! signup alice-0: 409 conflict
    ! message: 400 invalid channel
```

Warnings (prefixed `!`) are best-effort — rejected records don't fail the seed.
Up to five are shown.

## AI seeding details

* Model: **`claude-haiku-4-5`**.
* Auth: reads `ANTHROPIC_API_KEY` from your environment.
* Default brief: *"a small, fast-moving software startup."*
* Default volume `medium`: 6 users, 4 channels, 20 messages. See the
  [volume table](/concepts/seeding#default-volumes).
* Data is created via real signup → workspace → channels → messages, so auth and
  referential integrity hold.

## Seed on spin

To seed at create time instead, pass `--seed` to [`spin`](/cli/spin):

```bash theme={null}
asymmetric spin slack --seed acme-corp
```

## Reset replays it

The last seed is recorded on the clone and re-applied automatically by
[`reset`](/cli/lifecycle#reset).

## Errors you might see

| Error             | Cause                                                                    |
| ----------------- | ------------------------------------------------------------------------ |
| `CLONE_NOT_FOUND` | No clone with that id.                                                   |
| `LLM_UNAVAILABLE` | AI seeding failed (model error, parse error, or missing API key). Retry. |
| `SEED_VALIDATION` | Generated records were rejected by validation.                           |