makefx

Command-line interface for Make Effects.

Install

npm install -g makefx
makefx login
makefx spaces create "My Game" --init

Create media

makefx models list --available
makefx image generate "A painted market" --name "Market" --type scene -o market.png
makefx video generate "A slow push through the market" --name "Push" --type animation -o push.mp4
makefx audio sfx generate "Wooden coin pickup" --name "Pickup" -o pickup.wav

Generate creates a new asset. Regenerate replays the source Variant's Recipe unchanged; Vary applies explicit changes into a sibling. Both activate the new Variant on success by default:

makefx image regenerate IMAGE_VARIANT_REF
makefx image vary IMAGE_VARIANT_REF "Warmer light"
makefx video regenerate VIDEO_VARIANT_REF
makefx video vary VIDEO_VARIANT_REF "Slower camera"
makefx audio speech regenerate AUDIO_VARIANT_REF
makefx audio speech vary AUDIO_VARIANT_REF "Softer delivery"

Use --no-activate to keep the current active variant. Retry a transiently failed attempt in place with makefx variants retry VARIANT_REF.

Derive generates a new Asset from exact Variant inputs. Fork replays one Variant's editable Recipe into a new Asset. Copy reuses exact media without a generation run:

makefx image derive "Winter clothes" --refs VARIANT_REF --name "Winter hero" --type character -o winter.png
makefx variants fork VARIANT_REF --name "Hero branch" --changes "Softer expression" --wait
makefx variants copy VARIANT_REF --name "Hero copy" --type character
makefx variants history VARIANT_REF --direction connected --json

Manage assets

makefx assets list --query "hero"
makefx assets show ASSET_REF --json
makefx assets upload hero.png --name "Hero" --type character
makefx assets download VARIANT_REF -o hero.png
makefx assets delete ASSET_REF --yes

makefx variants show VARIANT_REF --wait
makefx variants history VARIANT_REF
makefx variants update VARIANT_REF --starred true --rating approved
makefx variants activate VARIANT_REF
makefx variants delete VARIANT_REF --yes

Collections

makefx collections create "Main Cast" --kind cast
makefx collections add COLLECTION_ID ASSET_REF --role hero
makefx collections add COLLECTION_ID VARIANT_REF --role style-reference
makefx collections remove COLLECTION_ID VARIANT_REF

Commands follow noun verb. Public asset and variant arguments are compact refs. JSON output does not expose raw database IDs, storage keys, jobs, request IDs, or runs. Retired commands and aliases are not redirected.

Run makefx --help or makefx <noun> --help for current options.

Version: 1.6.13