Skip to content

keryx reel link

Associate a reel workspace with a content directory.

Usage

keryx reel link <slug> <directory>

Both arguments are positional and required; omitting either gives missing argument (usage: keryx reel link <slug> <dir>).

What the association does

It records the directory as bundle in the workspace's workspace.yaml. That has three effects:

  • it tells Keryx where the finished reel-<slug>.mp4 belongs;
  • it gives the storyboard drafter and the studio chat the article itself as the reel's subject matter, instead of source.md;
  • it shows up as bundle= in reel list.
$ keryx reel link my-post content/posts/my-post
linked my-post -> content/posts/my-post

The directory is a Hugo page bundle in the original use, but any directory works.

Linking is optional

A reel can stand alone. An unlinked reel takes its subject from source.md in the workspace, which you write or paste in yourself. Either way direction.md — the creative intent — applies.

Running reel link again overwrites the previous value; there is no unlink. To clear the association, remove the bundle: line from workspace.yaml by hand.

The path is recorded verbatim and is not checked for existence, so a typo is stored happily and shows up later as an empty subject.

See also