seedkit cache
List, inspect, pin, and invalidate cached seeds.
The seed cache is keyed by sha256(schema + seed_name + generator_versions). This command is how you see and manage what's in it.
Synopsis
seedkit cache [subcommand] [options]
Subcommands
seedkit cache (default — list)
seedkit cache
KEY SEED SCHEMA ROWS HITS LAST USED
9a2f4e01 my-fixture a7f102 14,820 12 3m ago
1d88c0b2 demo-small a7f102 500 4 2h ago
b04e7711 de-finance c1884f 12,450 0 6d ago
Filter by name:
seedkit cache --name my-fixture
seedkit cache show <key|name>
Print the full SQL for a cached entry. Useful for debugging "why didn't this row get inserted?" without re-running.
seedkit cache show my-fixture | head
seedkit cache pin <key|name>
Pin an entry so automatic eviction skips it. Free-tier caches evict LRU after 30 days; pinned entries survive indefinitely.
seedkit cache pin my-fixture
seedkit cache rm <key|name>
Remove an entry. Next run with the same name regenerates and re-caches.
seedkit cache rm demo-small
Options
| Flag | Type | Description |
|---|---|---|
--name <name> | string | Filter list/show to a seed name. |
--json | flag | Machine-readable output. Stable schema across releases. |
--org <slug> | string | Override the active org (defaults to the one your token belongs to). |
How keys are computed
schema_normalized is the schema after column-order normalization, type aliasing, and FK normalization. Renaming a column changes the key; reordering columns does not. generator_versions is pinned per release; minor releases never invalidate keys, majors may.
See Seed cache for the full hashing model.