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

# pome compile-seeds

> Compile prose seed sections in task files into .seed.json sidecars.

`pome compile-seeds` turns the `## Seed State` prose or JSON block in a task
markdown file into a compiled `.seed.json` sidecar. Hosted runs rely on these
sidecars for faster, deterministic seed loading.

The compiler calls Anthropic directly with `ANTHROPIC_API_KEY`; seed compilation
is no longer routed through the Pome control plane.

## Usage

```bash theme={"dark"}
pome compile-seeds [target] [options]
```

## Arguments

| Argument   | Required | Description                                                    |
| ---------- | -------- | -------------------------------------------------------------- |
| `[target]` | No       | Path to a task `.md` file or directory. Defaults to `./tasks`. |

## Options

| Flag      | Default | Description                                                                    |
| --------- | ------- | ------------------------------------------------------------------------------ |
| `--force` | off     | Recompile even when the sidecar's `source_hash` already matches the task file. |

## Behavior

* Walks the target path for `.md` task files.
* Reads each file's `## Seed State` section and compiles it to `<task>.seed.json`
  alongside the markdown file.
* Skips recompilation when the sidecar hash matches unless `--force` is set.
* Uses the local compiler path and the relevant twin schema for the seed shape.

## Examples

```bash theme={"dark"}
# Compile every task in ./tasks/
pome compile-seeds

# Compile one file
pome compile-seeds tasks/01-bug-happy-path.md

# Force recompile after editing seed prose
pome compile-seeds tasks/ --force
```

## Exit codes

Returns a non-zero exit code when compilation fails for any file in the batch.