@howells/motif-cli

Images and video through fal.ai, by task. Say what you want done and Motif chooses from a curated set of Models at the Tier you ask for. A dry run shows the request and its available cost estimate before you spend. Unavailable token-billed totals are reported as unknown.

Install

npm install -g @howells/motif-cli
export FAL_KEY="your-fal-key"

Quick start

motif "a ceramic desk lamp on an oak desk" --dry-run    # choose the Model and price it
motif "a ceramic desk lamp on an oak desk"              # make it
motif "a ceramic desk lamp" --tier fast --dry-run        # a cheaper, quicker choice
motif erase "the cable" lamp.png                         # take something out
motif upscale lamp-erase.png --scale 2                   # make it larger

--tier fast|balanced|quality moves the choice; the default is balanced. Run motif with no arguments for help, and motif <verb> --help for one Task.

Generation starts with Nano Banana 2.1 at balanced, Sunburst at max at quality, and Nano Banana 2 Lite at fast. Editing has a separate ranking; fast editing starts with Grok. See generate and vary for the curated list, capability specialists and retained predecessor routes. Looks and pinned Models keep their own choices.

For agents

motif --describe tasks --format json   # task words mapped to verbs, and what to use instead
motif --describe --format json         # full schema: Tasks, looks, moods, errors

Add --format json to any command for structured output. The guide ships with this package: AGENTS.md, and every verb's modes, flags and examples are in docs/verbs.md.