Skip to content

How-to

Task-focused guides. These describe the intended workflows (per the contracts); runnable steps firm up as commands land.

Make a reel

keryx reel new my-post --from-post post.md   # workspace + AI-drafted storyboard
# edit storyboard.json (or use the studio)
keryx reel build -w my-post --silent          # fast format/pacing proof (no audio)
keryx voice  -w my-post --takes 2             # narration takes → audition → select
keryx music  -w my-post                        # tone-matched bed
keryx cards  -w my-post                        # per-card illustrations (screen for text leaks)
keryx reel build -w my-post                    # full assemble: VO drives timing, music ducked

Use your own imagery / video

keryx cards set 3 ./b-roll.mp4   # use a pre-rendered clip/image as-is (no AI)

Compose & publish social

keryx social  -w my-post --platform instagram  # platform-appropriate caption/tags/link
keryx approve instagram -w my-post              # required gate before posting
keryx post    instagram -w my-post              # on-demand
keryx post all -w my-post                       # every approved platform

Schedule unattended posting (CI)

keryx approve all -w my-post --at 2026-07-01T09:00   # approve + schedule per outlet
# a GitLab scheduled pipeline in the owning project runs:
keryx post due                                        # posts what's approved + due

Manage themes

keryx theme list
keryx theme add my-style --type reel --from editorial

See 0002-interface-contracts.md for every command's inputs, outputs, exit codes and testable requirements.