keryx reel prune¶

Delete a workspace's candidate takes and generation cache, keeping everything selected.

Usage¶

keryx reel prune <slug>
keryx reel prune --workspace <slug>

Flags¶

Flag	Description	Default	Required
`--workspace`	The workspace slug		one of the two forms

The slug can be given either as a positional argument or with --workspace; the flag wins if both are present. Neither gives --workspace <slug> is required.

Prefer the positional form on a project that sets workspace.root. Passing --workspace makes the command look under reels/ regardless of that key — see the note on workspace.root.

What it deletes¶

Exactly four directories:

vo/takes/
cards/takes/ (including the cached OCR verdicts in screen.json)
music/takes/
.cache/

$ keryx reel prune my-post
pruned takes + cache (selected artefacts kept)

What it keeps¶

Every selected asset (vo/NN.mp3, cards/NN.*, music.mp3, cover.png), the storyboard, social.json, the rendered mp4, and the locked block in workspace.yaml. Pruning never disturbs a selection or an approval.

What it misses¶

cover/takes/ and portrait/takes/ are not pruned, and they are not in the .gitignore that reel new writes either. Studio-generated cover and portrait candidates accumulate there and will be committed. Delete them by hand.

What you lose by pruning¶

The generation cache is keyed by request content, so an unchanged re-generation is normally free. Pruning throws that away: the next voice gen, music gen or cards gen for the same inputs calls the provider again and costs money. Prune when a reel is finished, not mid-authoring.