keryx cards gen¶

Description¶

Generate AI card illustrations as candidate takes into a workspace. Target one card with --card M, or all overlay cards when --card is 0. Requires --takes N (and --workspace). Review the takes with cards sheet, then choose one with cards pick.

Each card's panel is generated from its storyboard scene in the reel theme's illustration style.

--avatar <name> opts a registered character (config avatars.*) into the run as a first-hand actor: generation switches to image-to-image (the avatar reference is composited into every panel) and the card's scene becomes the per-panel actor direction — pose, prop, gaze, and an explicit emotion (the avatar defaults to a friendly expression, so name the emotion every time and only smile on positive beats). The avatar renders in its own style by default; add --theme <kw> to restyle it into that theme. Likeness and style are independent — the style is never baked into the character.

Pass a comma-separated list (--avatar matt,jane) for multiple figures in a panel; each likeness is labelled by name so the scene can direct them individually ("matt recoils while jane points"). See spec 0006.

Usage¶

keryx cards gen --takes <n> --workspace <slug> [--card <m>] [--theme <kw>]

Flags¶