Skip to content

keryx reel rename

Re-slug a reel workspace, keeping its contents.

Usage

keryx reel rename <old-slug> <new-slug>

Both arguments are positional and required; omitting either gives missing argument (usage: keryx reel rename <old> <new>).

What it changes

The directory is renamed and slug inside workspace.yaml is rewritten to match. Nothing else moves: selected media, takes, cache, lock state and the rendered mp4 all travel with the directory.

$ keryx reel rename my-post launch-post
renamed my-post -> launch-post

What it does not change

The rendered mp4 keeps its old name. reel build writes reel-<slug>.mp4, so a renamed workspace still holds reel-my-post.mp4 until you build again. The next build writes reel-launch-post.mp4 alongside it; delete the stale one yourself.

When it refuses

Situation Error
The new slug is not lowercase kebab-case invalid slug (want lowercase kebab-case)
The old workspace does not exist workspace not found
A workspace already uses the new slug workspace already exists

Nothing is moved when any of these fire.

See also